Examples

 

Example 1:

To display the status of a DASD with device number 380, enter: 
DS  P,380

Example 2:

To display the status of a DASD with device number 3480, enter: 
DS  P,/3480

Example 3:

To display the status of all online devices with device numbers 380 through 38F, enter: 
DS  P,380,16,ON

Example 4:

To display the status of SMS-controlled device 430 and the seven devices whose addresses follow it, enter: 
ds s,430,8
This command would produce the following display: 
IGD001I 11:49:20 DEVSERV SMS 455
    UNIT,TYPE  ,M,VOLUME,VOLSTAT    STORGRP,  SGSTAT
    430 ,3380  ,O,XP0101,ENABLED    SXP01     ,ENABLED
    431 ,3380  ,A,XP0201,ENABLED    SXP02     ,ENABLED
    432 ,3380  ,A,XP0202,ENABLED    SXP02     ,ENABLED
    433 ,3380  ,O,XP0301,ENABLED    SXP03     ,ENABLED
    434 ,3380  ,O,XP0302,ENABLED    SXP03     ,ENABLED
    435 ,3380  ,O,XP0303,ENABLED    SXP03     ,ENABLED
    436 ,3380  ,O,338001,STRG/RSDNT,     VOLUME NOT MANAGED BY SMS
    437 ,3380  ,A,SMSPCK,STRG/RSDNT,     VOLUME NOT MANAGED BY SMS
Note: Indications in the M column are: O=online, A=allocated, F=offline.

Example 5:

The following two sample displays compare the response to DEVSERV P with the response to DEVSERV S. Note that DEVSERV P provides volser and CHPID information, while DEVSERV S provides SMS volume and storage group status.

Issuing DEVSERV P,F4A produces this display: 
ds p,f4a
IEE459I 15.30.14 DEVSERV PATHS 728
 UNIT DTYPE  M CNT VOLSER  CHPID=PATH STATUS                         
      RTYPE  SSID CFW TC   DFW PIN DC-STATE CCA DDC       CYL CU-TYPE
00F4A,33909 ,O,000,EV9LIA,00=+ 04=+                                  
      2105   201F  Y  YY.  YY.  N  SIMPLEX   3A  3A     10017 2105   
************************ SYMBOL DEFINITIONS ************************ 
O = ONLINE                         + = PATH AVAILABLE
Issuing DEVSERV S,430 produces this display: 
devserv s,430 
IGD001I 16:24:26 DEVSERV SMS 569 
UNIT,      TYPE     ,M,  VOLUME,   VOLSTAT         STORGRP,  SGSTAT 
430, 3380       ,O,  XP0101,  ENABLED         SXP01,    QUIESCED 
*************************** SYMBOL DEFINITIONS ********************* 
O = ONLINE                            + = PATH AVAILABLE
Note: Tape device type is not supported by DEVSERV SMS.

Example 6:

The extra header line and data line appear in the response only when there are 3990 Model 3 Storage Controls in the system. If record caching has not been installed, the RC column in the third header line is left blank.

Issuing DEVSERV P,430,2 produces this display: 
devserv p,430,2
IEE459I 16.24.41 DEVSERV PATHS 572
 
UNIT DTYPE  M CNT VOLSER  CHPID=PATH STATUS
      RTYPE  SSID CFW TC   DFW PIN DC-STATE CCA DDC       CYL CU-TYPE  
00430,3380D, O,000,XP0101,25=+ 2E=+ 
                  IE  YY   NN   N  SIMPLEX   C0  01       885 3990-3 
00431,3380E, O,000,XP0101,25=+ 2E=+ 
                  IE  YY   NN   N  SIMPLEX   C1  01      1770 3990-3 
  ************************ SYMBOL DEFINITIONS **************************
  O = ONLINE                              + = PATH AVAILABLE

Example 7:

This example shows the dual copy status.

Issuing DS P,D2A,2 produces this display: 
IEE459I 10.06.45 DEVSERV PATHS 297

UNIT DTYPE  M CNT VOLSER  CHPID=PATH STATUS                         
      RTYPE  SSID CFW TC   DFW PIN DC-STATE CCA DDC       CYL CU-TYPE 
00D2A,3380D ,O,000,DSFXA0,1B=+ 9B=+ 1C=+ 9C=+ 
             00AB  Y  NY.  NY.  N  PRIMARY   20  20  ALT 0D2B  3990-3 
00D2B,3380D ,F,000,      ,1B=+ 9B=+ 1C=+ 9C=+ 
             00AB  Y  NY.  NY.  N  SECONDARY 21  21  ALT 0D2A  3990-3 
************************ SYMBOL DEFINITIONS ****************************
F = OFFLINE O = ONLINE             + = PATH AVAILABLE

Example 8:

This example shows the sparing status.

Issuing DS P,F7E produces this display: 
IEE459I 16.02.11 DEVSERV PATHS 389

 UNIT DTYPE  M CNT VOLSER  CHPID=PATH STATUS                         
      RTYPE  SSID CFW TC   DFW PIN DC-STATE CCA DDC       CYL CU-TYPE 
00F7E,33903 ,F,000,      ,B5=X B6=X B9=X BA=X 
      9392-2 00FD  Y  NY.  NN.  N  SPARE     2E  00      3339 3990-3
************************ SYMBOL DEFINITIONS **************************
F = OFFLINE                        X = INDETERMINATE FAILING UNIT

Example 9:

This example shows the PPRC status.

Issuing DS P,D300,2 produces this display: 
ds p,d300,2
IEE459I 15.55.04 DEVSERV PATHS 596
 UNIT DTYPE  M CNT VOLSER  CHPID=PATH STATUS                         
      RTYPE  SSID CFW TC   DFW PIN DC-STATE CCA DDC       CYL CU-TYPE      
0D300,33909 ,O,000,TK9085,4B=< 4F=+ 5B=< 5F=<                             
      2107   2401  Y  YY.  YY.  N  PPRIMARY  05  05     10017 2107      
0D301,33909 ,O,000,TK3083,14=+ 18=+                                       
      PATH ATTRIBUTES     NP   PF                                         
      3390   1601  Y  YY.  YY.  N  PSECONDRY 03  03     10017 2107      
************************ SYMBOL DEFINITIONS ************************     
O = ONLINE                         + = PATH AVAILABLE                    
< = PHYSICALLY UNAVAILABLE         PF = PREFERRED                        
NP = NON-PREFERRED

Example 10:

This example uses the DEVSERV QTAPE command to diagnose an error, namely an inconsistent device definition. 
a.  VARY ONLINE fails.

    V 931,ONLINE

    IEE103I UNIT 0931      NOT BROUGHT ONLINE
    IEE763I NAME- IECDINIT CODE= 0000000800000000
    IEA435I PHYSICAL DEVICE INCONSISTENT WITH LOGICAL DEFINITION
    IEE764I END OF IEE103I    RELATED MESSAGES

b.  DEVSERV QTAPE shows inconsistent device definition.

    DS QT,931,1
IEE459I 15.28.22 DEVSERV QTAPE
    UNIT DTYPE  DSTATUS CUTYPE  DEVTYPE  CU-SERIAL  DEV-SERIAL ACL LIBID
    0931 3480X  OFFLINE 3490A20 3490B40? 0113-97231 0113-97231 I
    ****      1 DEVICE(S) MET THE SELECTION CRITERIA

Example 11:

This example illustrates the help text provided when you issue the command: 
DS QT,?

IEE459I 15.27.49 DEVSERV QTAPE
    DEVSERV QTAPE COMMAND SYNTAX:
 DS QT,ccuu,n,filter1,filter2,diagnostic info
   ccuu  -- device number,  n -- number of devices (1-256)
   filter1 -- LIB=ALL or library id, or
              MACH=ALL or cu or device serial, or
              TYPE=ALL or device type or defined device type
   filter2 -- DEFINED, ONLINE, OFFLINE
              DEFINED is valid only if TYPE= is selected
   diagnostic info -- UCB, DCE, RDC, RCD, NOIO
                  valid only if n=1 is specified
 DS QT,LIB=libid,filter
      libid -- ALL or library id
      filter -- ONLINE, OFFLINE
 DS QT,MACH=serialnmbr,filter
      serialnmbr -- control unit or device serial
      filter -- ONLINE, OFFLINE
 DS QT,TYPE=type,filter
      type -- ALL or defined device type
      filter -- DEFINED, ONLINE, OFFLINE

Example 12:

This example illustrates the basic DEVSERV QTAPE display without hexadecimal data. 
DS QT,TYPE=ALL

 IEE459I 12.57.36 DEVSERV QTAPE
 UNIT DTYPE  DSTATUS CUTYPE  DEVTYPE  CU-SERIAL  DEV-SERIAL ACL LIBID
 0930 3480SX ON-NRD  3490A02 3490B04  0112-47671 0112-47671 I
 093F 3480SX OFFLINE 3490A02 3490B04  0112-47671 0112-47671 I
 0990 3490   ON-RDY  3490A20 3490B40  0113-97231 0113-97231 I-A
 09A0 3490   OFFLINE 3490C2A 3490C2A  0113-55565 0113-55565 I   10382
 **** UNLISTED DEVICE(S) AND REASON CODES :
   093E(05) 093F(05)
 ****      4 DEVICE(S) MET THE SELECTION CRITERIA
 **** (05) - DEVICE BOXED

Example 13:

These six variations illustrate the DEVSERV QPAVS command when the UNBOX parameter is not specified.

DS QP,D3FF,VOLUME


ds qp,d3ff,volume
IEE459I 20.45.15 DEVSERV QPAVS 721
     HOST                             SUBSYSTEM              
 CONFIGURATION                      CONFIGURATION            
---------------                  ---------------------       
 UNIT                                  UNIT    UA            
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE          
----- --  ----        ------     ----  ----    ----------    
0D300 05  BASE                   2401   05     BASE          
0D3FE 1B  ALIAS-D300             2401   1B     ALIAS-05      
0D3FF 1C  ALIAS-D300             2401   1C     ALIAS-05      
****      3 DEVICE(S) MET THE SELECTION CRITERIA 
DS QP,D3FE,UCB


ds qp,d3fe,ucb
IEE459I 20.48.43 DEVSERV QPAVS 724
     HOST                             SUBSYSTEM                    
 CONFIGURATION                      CONFIGURATION                  
---------------                  ---------------------             
 UNIT                                  UNIT    UA                  
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE                
----- --  ----        ------     ----  ----    ----------          
0D3FE 1B  ALIAS-D300             2401   1B     ALIAS-05            
  UCB AT V022E1E68                                                 
0088FF04D3FE0000 0000000008E4C3C2 3010200F002E1E41 0000000000000000
0000000000100000 022DF590022E1CC8 0580000000000000                 
  UCB PREFIX AT V02407020                                          
0004004000000000 0000000000010035 289C2BB2400040F0 4B4F5B5F00000000
0149000000000001                                                   
  UCB COMMON EXTENSION AT V022E1E40                                
00000900202A0008 0240702000000000 0000000000FD6A74 022DF72000001800
****      1 DEVICE(S) MET THE SELECTION CRITERIA 
DS QP,D3AD,2


ds qp,d3ad,2
IEE459I 21.04.01 DEVSERV QPAVS 800
     HOST                             SUBSYSTEM              
 CONFIGURATION                      CONFIGURATION            
---------------                  ---------------------       
 UNIT                                  UNIT    UA            
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE          
----- --  ----        ------     ----  ----    ----------    
0D3AD 2A  ALIAS-D301             1601   2A     ALIAS-03      
**** UNLISTED DEVICE(S) AND REASON CODES :                   
 0D3AE(0A)                                                   
**** (0A) - DEVICE IS AN UNBOUND PAV-ALIAS                   
****      1 DEVICE(S) MET THE SELECTION CRITERIA  
DS QP,0D3FF,VOLUME

ds qp,0d3ff,volume
IEE459I 20.44.23 DEVSERV QPAVS 718
     HOST                             SUBSYSTEM              
 CONFIGURATION                      CONFIGURATION            
---------------                  ---------------------       
 UNIT                                  UNIT    UA            
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE          
----- --  ----        ------     ----  ----    ----------    
0D300 05  BASE                   2401   05     BASE          
0D3FE 1B  ALIAS-D300             2401   1B     ALIAS-05      
0D3FF 1C  ALIAS-D300             2401   1C     ALIAS-05      
****      3 DEVICE(S) MET THE SELECTION CRITERIA 
DS QP,2D3FF,VOLUME

ds qp,2d3ff,volume
IEE459I 20.44.08 DEVSERV QPAVS 715
     HOST                             SUBSYSTEM              
 CONFIGURATION                      CONFIGURATION            
---------------                  ---------------------       
 UNIT                                  UNIT    UA            
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE          
----- --  ----        ------     ----  ----    ----------    
**** UNLISTED DEVICE(S) AND REASON CODES :                   
 2D3FF(0C)                                                   
**** (0C) - SUBCHANNEL SET VALUE SPECIFIED IS NOT VALID
DS QP,SSID=1601

DS QP,SSID=1601
IEE459I 21.11.32 DEVSERV QPAVS 803
     HOST                             SUBSYSTEM              
 CONFIGURATION                      CONFIGURATION            
---------------                  ---------------------       
 UNIT                                  UNIT    UA            
 NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE          
----- --  ----        ------     ----  ----    ----------    
0D301 03  BASE                   1601   03     BASE          
0D3AC 29  ALIAS-D301             1601   29     ALIAS-03      
0D3AD 2A  ALIAS-D301             1601   2A     ALIAS-03      
****      3 DEVICE(S) MET THE SELECTION CRITERIA

Example 14:

This command illustrates the DEVSERV QPAVS command when the UNBOX parameter IS specified. 
DS QP,D300,UNBOX

IEE459I 08.12.53 DEVSERV QPAVS 935
0D300  IS NOT AN UNBOUND PAV-ALIAS DEVICE.
 THE DEVSERV QPAV UNBOX COMMAND IS NOT EXECUTED.

Example 15:

This example illustrates the use of DEVSERV QLIB to delete the INACTIVE control blocks for library 10382. 
DS QL,10382,DELETE

*04 Reply 'YES' to delete the INACTIVE configuration for library 10382,
any other reply to quit.
R 4, YES

IEE459I 10.27.54 DEVSERV QLIB 432
Inactive configuration for library 10382 successfully deleted

Example 16:

This example illustrates the use of DEVSERV QLIB to list all of the queued requests. 
DS QL,LIST,QUEUE

IEE459I 10.19.40 DEVSERV QLIB 421
LIBID  DEVICE  REQUEST  VOLSER  CATEGORY  TIME ON QUEUE
10382  F018    MOUNT    VOL001  000F      3 MINUTE(S)
10382  F020    MOUNT    VOL002  000F      1 MINUTE(S)
10382  F031    EJECT    VOL003  000F      8 MINUTE(S)
10382  F021    DEMOUNT  VOL005  0001      3 MINUTE(S)

Example 17:

This example illustrates the use of DEVSERV QLIB to list all of the libraries that are defined to the system and then list all of the devices for library 10382. An * indicates that at least one device in library 10382 has been initialized. It also indicates that library 15393 is logically defined to the system, but has never gone through device initialization. Initialization occurs during IPL or IODF activate for any library devices that are connected to the system. For devices that are connected after IPL or IODF activate, initialization occurs when the device is varied online. For library 10382, devices on ports 03, 02, and 01 have never been initialized.
DS QL,LIST

IEE459I 09.48.44 DEVSERV QLIB 391
The following libids are defined in the ACTIVE configuration:
*10382  15393
DS QL,10382
IEE459I 09.49.03 DEVSERV QLIB 394
LIBID  PORTID       DEVICES
10382  04           0940* 0941* 0942* 0943* 0944* 0945* 0946* 0947*
                    0948* 0949* 094A* 094B* 094C* 094D* 094E* 094F*
       03           09A0  09A1  09A2  09A3  09A4  09A5  09A6  09A7
                    09A8  09A9  09AA  09AB  09AC  09AD  09AE  09AF
                    0DB0  0DB1  0DB2  0DB3  0DB4  0DB5  0DB6  0DB7
                    0DB8  0DB9  0DBA  0DBB  0DBC  0DBD  0DBE  0DBF
       02           09D0  09D1  09D2  09D3  09D4  09D5  09D6  09D7
                    09D8  09D9  09DA  09DB  09DC  09DD  09DE  09DF
       01           F990  F991  F992  F993  F994  F995  F996  F997

Example 18:

This example illustrates the use of DEVSERV QLIB to verify the connectivity of devices in library 15393.

This display indicates that devices DC8 and DC9 were connected to the system at some point and were initialized.
ds ql,15393,INACTIVE
IEE459I 11.55.47 DEVSERV QLIB 471
The following are defined in the INACTIVE configuration:
LIBID  PORTID       DEVICES
15393  03           0DC8* 0DC9* 0DC0  0DC1  0DC2  0DC3  0DC4  0DC5
                    0DC6  0DC7  0DCA  0DCB  0DCC  0DCD  0DCE  0DCF
This display uses VALIDATE to determine the current state of device connectivity: 
ds ql,15393,validate
IEE459I 11.56.15 DEVSERV QLIB 476
The following are defined in the INACTIVE configuration:
LIBID  PORTID       DEVICES
15393  03           0DC8  0DC9* 0DC0  0DC1  0DC2  0DC3  0DC4  0DC5*
                    0DC6  0DC7  0DCA  0DCB  0DCC  0DCD  0DCE  0DCF

Example 19:

This example illustrates the use of DEVSERV QLIB command to display and interpret any device initialization errors that occurred during IPL.
DS QL,IEA438I
IEE459I 11.58.04 DEVSERV QLIB 620
Device initialization errors detected during IPL
 9AFA-09 9A1A-09 9ABA-09 9ADA-09 9A9A-09 9A5A-09 9A3A-09 9A7A-09
 9A1B-09 9A3B-09 9A5B-09 9A7B-09 9A9B-09 9ABB-09 9ADB-09 9AFB-09
 9A1C-09 9A3C-09 9A5C-09 9A7C-09 9A9C-09 9ABC-09 9ADC-09 9AFC-09
 9A1D-09 9A3D-09 9A7D-09 9A5D-09 9A9D-09 9ADD-09 9ABD-09 9AFD-09
The number following the dash identifies the error that was detected during IPL. The failures that can be reported are:
2
The library interface is offline.
4
The device returned a library ID of all zeros (in Read Device Characteristics).
6
The device is unavailable to the library manager.
9
The HCD defined library ID and pool ID do not match the hardware ID.
12
The device type (EPI) is different from other devices in the same pool.
15
An I/O error occurred trying to read distributed library data.
Parent topic: Parameters