DEVSERV QPAVS

DEVSERV QPAVS supports the parallel access volume (PAV) capability of the IBM® Enterprise Storage Server® (ESS). You can use the DEVSERV QPAVS command to perform the following tasks:

Describe how a logical subsystem configuration is defined to z/OS®
Highlight the inconsistencies, if any, between the IODF and the LSS configuration
Display unbound alias device types with the UCB parameter and, if necessary, "unbox" a boxed alias device with the UNBOX parameter
Show information on both a PAV-base address and its PAV-aliases by specifying the VOLUME parameter
Display information on devices

Use the following syntax for the DEVSERV QPAVS command:


>>-DEVSERV--QPAVS--,-------------------------------------------->

>--+-device--+----+--+-+-------+--+------+--+------+-+-+-------><
   |         '-,1-'  | '-,HPAV-'  '-,DCE-'  '-,UCB-' | |   
   |                 '-,VOLUME-----------------------' |   
   +-device--+------+--,UNBOX--------------------------+   
   |         '-,num-'                                  |   
   '-SSID=ssid-+-------------------+-------------------'   
               '-,device--+------+-'                       
                          '-,num-'

Where:

QPAVS

Is a required positional keyword. May be abbreviated as QPAVS or QP.

device

Specifies the device or devices to be displayed. device can be specified in either of the following formats:

sccuu, where s is either 0 or 1 to indicate the desired subchannel and ccuu specifies a 4 hex digit device number (3–digit device numbers must be padded with a leading zero), or
ccuu, which specifies just the device number. In this case, the active subchannel set is used to return information about the device.

num

Specifies the number of devices to be displayed. num can be a decimal number from 1 to 256. 1 is the default.

DCE

Displays the device class extension block (DCE) of the BASE UCB. If DCE is specified, only one device may be displayed (that is num must be 1).

UCB

Displays the unit control block (UCB) information associated with the device. If UCB is specified, only one device may be displayed (that is num must be 1).

UNBOX

Causes QPAVS to unbox the unbound alias device if it is in a BOX state. num can be a decimal number from 1 to 256.

VOLUME

Displays the parallel access volume (PAV) relationship information for the logical volume, including the PAV base device number and all PAV alias device numbers bound to that base. May be abbreviated as VOL.

HPAV

Displays the number of alias pool devices or the alias pool device numbers associated with a base device number (sccuu) that is the target of the QPAV command. If the sccuu number is issued to a HyperPAV alias device, only that device will be in the output.

SSID=ssid

Specifies the subsystem identification number (SSID) of the subsystem whose information DEVSERV is to display.

Note: If a specific set of devices is specified after SSID with the device and num parameters, then IO will be issued only to those devices.

Figure 1 shows the display content when you issue the DEVSERV QPAVS command with parameters other than DCE and UCB. If you specify the DCE or UCB parameter (or both), additional DCE or UCB information (or both) is displayed for the device. This additional information is formatted the same way as the output resulting from the QDASD parameter.

Figure 1. DEVSERV QPAVS Display Content

     -----------------------------------------------------
     ---          DS QP  Display Content               ---
     -----------------------------------------------------
     IEE459I  (time)   DEVSERV QPAVS
         Host                             Subsystem
     Configuration                      Configuration
     -------------                    --------------------
     UNIT                                   UNIT  UA
     NUM.  UA  TYPE        STATUS     SSID  ADDR  TYPE
     ----- --  ----        ------     ----  ----  --------
     sdddd aa  BASE        INV-ALIAS  ssss   uu   BASE
               ALIAS-bbbb  NOT-BASE               ALIAS-bb
               NON-PAV     NOT-ALIAS              NC
     sdddd bb  ALIAS       UNBOUND    ssss   uu   ALIAS-aa
     sdddd bb  ALIAS-bbbb             ssss   uu   ALIAS-aa
     sdddd aa  BASE-H                 ssss   uu   BASE
     sdddd bb  ALIAS-H                ssss   uu   ALIAS-H


     UNLISTED DEVICES AND REASON CODES  X 
        sdddd(rc) sdddd(rc) sdddd(rc) ...

X Below are the reason codes for unlisted devices:

(01): DEVICE NOT CONFIGURED, UCB NOT FOUND
(02): UCB NOT CONNECTED
(03): DEVICE UNAVAILABLE, SCP ROUTINE IN CONTROL
(04): SUBCHANNEL ERROR
(05): DEVICE BOXED
(06): UCB NOT A DASD
(07): DEVICE I/O ERROR
(08): DEVICE IS NOT A DASD
(09): DSE-1 CCW BUILD FAILED
(0A): DEVICE IS AN UNBOUND PAV-ALIAS
(0B): DEVICE IS A SECONDARY OF A PPRC PAIR
(0C): SUBCHANNEL SET VALUE SPECIFIED IS NOT VALID
(OD): UCB NOT FOUND IN SPECIFIED SUBCHANNEL SET
(OE): DEVICE IS A HYPERPAV ALIAS
(OF): DEVICE IS NOT A HYPERPAV BASE OR ALIAS

The following are examples of DEVSERV QPAVS output.

Figure 2 shows the PAV status for the device at the starting address D123 and the next 2 addresses.

Figure 2. DS QP,D123,3 Output

     IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----   -------
     0D123 23  NON-PAV                0101   23     BASE
     0D124 24  NON-PAV                0101   24     BASE
     0D125 25  NON-PAV                0101   25     BASE
    ****      3 DEVICE(S) MET THE SELECTION CRITERIA

Figure 3 shows the PAV status for the alias device at the address D2FF, its base, and other associated alias devices of the logical volume.

Figure 3. DS QP,D2FF,VOLUME Output

     IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D222 22  BASE                   0102   22     BASE
     0D2FE FE  ALIAS-D222             0102   FE     ALIAS-22
     0D2FF FF  ALIAS-D222             0102   FF     ALIAS-22
    ****      3 DEVICE(S) MET THE SELECTION CRITERIA

Figure 4 shows the PAV status for the base device at the address D222 and its alias volumes without the subchannel set support installed.

Figure 4. DS QP,D222,VOLUME Output

     IEE459I 08.20.32 DEVSERV QPAVS 591
         Host                             Subsystem
     Configuration                      Configuration
     --------------                   --------------------
     UNIT                                  UNIT    UA
     NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D222 22  BASE                   0102   22     BASE
     0D2FE FE  ALIAS-D222             0102   FE     ALIAS-22
     0D2FF FF  ALIAS-D222             0102   FF     ALIAS-22
    ****      3 DEVICE(S) MET THE SELECTION CRITERIA

Figure 5 shows that you can "unbox" a boxed alias device at the address D6FF.

Figure 5. DS QP,D6FF,UNBOX Output

   IEE459I 08.20.32 DEVSERV QPAVS 591
    THE DEVSERV QPAV UNBOX COMMAND HAS BEEN SUCCESSFULLY UNBOXED  1

   IEE459I 08.20.32 DEVSERV QPAVS 591
    THE DEVSERV QPAV UNBOX COMMAND HAS BEEN EXECUTED WITH
      RETURN CODE = xx, REASON CODE = yy  2

  IEE459I 10.04.23 DEVSERV QPAVS 699
   D6FF  IS NOT AN UNBOUND PAV-ALIAS DEVICE. 3 
     THE DEVSERV QPAV UNBOX COMMAND IS NOT EXECUTED

1 You receive this message if the return code from DEVSERV QPAVS UNBOX is zero.

2 You receive this message if the return code from DEVSERV QPAVS UNBOX is nonzero.

3 You may also receive this message with the explanation: "nnnn-IS NOT IN BOX STATE."

Figure 6 describes the status of an unbound alias and the display of its associated UCB control blocks.

Figure 6. DS QP,D5EF,UCB Output

    IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    ---------
       UCB AT V01ED2AA8
     0088FF04D5EF0000 0000000008E4C3C2 3010200E00ED2A81 0000000000000000
     0000000000100000 0000000000000000 0000000000000000
       UCB PREFIX AT V01FF4208
     000C804000000000 000000000001004E 289C1253C00080C0 14F4FFFFFFFFFFFF
     0148000000000001
       UCB COMMON EXTENSION AT V01ED2A80
     00000900182A0000 01FF420800000000 0000000000FCD3D8 01ECA90000000000
    **** UNLISTED DEVICE(S) AND REASON CODES:
      0D5EF(0A)
    **** (0A) - DEVICE IS AN UNBOUND PAV-ALIAS

Figure 7 shows the PAV status of the devices that have the same SSID value.

Figure 7. DS QP,SSID=1401 Output

    IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D400 00  NON-PAV                1401   00     BASE
     ....
     0D422 22  BASE                   1401   22     BASE
     ....
     0D4FF FF  ALIAS-D422             1401   FF     ALIAS-22
    ****    256 DEVICE(S) MET THE SELECTION CRITERIA

Figure 8 shows the status of NOT-BASE when the address D345 is defined as a PAV-base in the HCD, but not in the ESS logical subsystem.

Figure 8. DS QP,D345 Output

    IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D345 45  BASE        NOT-BASE   0103   45     ALIAS-00
    ****      1 DEVICE(S) MET THE SELECTION CRITERIA

Figure 9 shows the status of NOT-ALIAS when the address D621 is defined as a PAV-alias in the HCD, but not in the ESS logical subsystem.

Figure 9. DS QP,D621 Output

    IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----   ---------
     0D621 21  ALIAS-D600  NOT-ALIAS  0106   21     BASE
    ****      1 DEVICE(S) MET THE SELECTION CRITERIA

Figure 10 shows the status of INV-ALIAS when the alias address D6F4 for the base volume in the HCD does not match its base address in the ESS logical subsystem.

Figure 10. DS QP,D6F4 Output

    IEE459I 08.20.32 DEVSERV QPAVS 591
          Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D6F4 F4  ALIAS-D600  INV-ALIAS  0106   F4     ALIAS-06
    ****      1 DEVICE(S) MET THE SELECTION CRITERIA

Figure 11 shows the status of NOT-NPAV for the device at the address F60. The device is defined as a NON-PAV device in the HCD, but is given an alias in the ESS logical subsystem.

Figure 11. DS QP,F60 Output

     IEE459I 13.20.12 DEVSERV QPAVS 368
           Host                             Subsystem
       Configuration                      Configuration
      --------------                   --------------------
       UNIT                                  UNIT    UA
       NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
      ----- --  ------      ------     ----  ----    --------
      00F60 F0  NON-PAV     NOT-NPAV   0101   F0     ALIAS-03

Figure 12 shows the display content when you issue the DEVSERV QPAVS command with the HPAV parameter, with the target of the command being a HyperPAV alias device number.

Figure 12. DS QP,E27F,HPAV Output

     09.07.08 SYSTEM1           ds qpavs,e27f,hpav               
     09.07.08 SYSTEM1           IEE459I 09.07.08 DEVSERV QPAVS 472   
          HOST                             SUBSYSTEM                 
      CONFIGURATION                      CONFIGURATION               
     ---------------                  ---------------------          
      UNIT                                  UNIT    UA               
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE             
     ----- --  ----        ------     ----  ----    ----------       
     0E27E     ALIAS-H                                               
     0E27F     ALIAS-H                                               
     ****      2 DEVICE(S) IN HYPERPAV ALIAS POOL

Figure 13 shows the display content when you issue the DEVSERV QPAVS command with the HPAV parameter, with the target of the command being a HYPERPAV base device number.

Figure 13. DS QP,E200,HPAV Output

     09.07.08 SYSTEM1           ds qpavs,e200,hpav               
     09.07.08 SYSTEM1           IEE459I 09.07.08 DEVSERV QPAVS 472   
          HOST                             SUBSYSTEM                 
      CONFIGURATION                      CONFIGURATION               
     ---------------                  ---------------------          
      UNIT                                  UNIT    UA               
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE             
     ----- --  ----        ------     ----  ----    ----------       
     0E200 00  BASE-H                 3205   00     BASE 
     0E27E     ALIAS-H     
     0E27F     ALIAS-H              
      ****      3 DEVICE(S) IN HYPERPAV ALIAS POOL

Figure 14 shows the display content when you issue the DEVSERV QPAVS command with the VOLUME parameter, with the target of the command being a HYPERPAV alias device number.

Figure 14. DS QP,E27F,VOLUME Output

     09.07.08 SYSTEM1           ds qpavs,e27f,volume                 
     09.07.08 SYSTEM1           IEE459I 09.07.08 DEVSERV QPAVS 472   
          HOST                             SUBSYSTEM                 
      CONFIGURATION                      CONFIGURATION               
     ---------------                  ---------------------          
      UNIT                                  UNIT    UA               
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE             
     ----- --  ----        ------     ----  ----    ----------       
     **** UNLISTED DEVICE(S) AND REASON CODES :                        
     0E27F(0E)                                                        
     **** (0E) - DEVICE IS A HYPERPAV ALIAS