IEE459I (form 2 of 3)
hh.mm.ss DEVSERV QPAVS [id]

Explanation

Display software and hardware configuration information and to identify any configuration discrepancies.

Two objectives are to be met with the DEVSERV display of the PAV configuration:
  1. Depict a logical subsystem configuration as defined to the host software
  2. Highlight any inconsistencies between the host configuration definition, and the Subsystem configuration.

QPAVS will optionally display unbound alias device types (UCB parameter), or unbox the alias device if it is boxed when UNBOX is specified.

QPAVS will show the BASE UA information followed by the associated bound PAV-ALIAS devices UA information when the new VOLUME parameter is specified.

In addition to device number, devices can be selected according to specified SSID value (SSID=ssss).

DEVSERV QPAVS command will be in one of the following forms,
  • DEVSERV QPAVS,sdddd,nnn
  • DEVSERV QPAVS,sdddd,tttt
  • DEVSERV QPAVS,SSID=ssss
where:
  • QPAVS is a required (positional) keyword(s).
  • sdddd is a 3 or 5 hex digits specifying a subchannel set number and a device number.
  • nnn is a decimal number from 1-256 with the default as 1.
  • tttt can be UNBOX, VOLume, or UCB.
  • ssss is the requested SSID value.
------------------------------------------------------
--- DS QP  Display Content has two formats:        ---
---  - format (A) 
---    when the command is of the following forms:
---                          DS QP,sdddd
---                          DS QP,sdddd,nnn
---                          DS QP,SSID=ssid,sdddd,nnn
---                          DS QP,dddd,tttt
---                      where tttt is VOLume, 
---                          or UCB.

---  - format (B) 
---    	DS QP,sdddd,nnn,UNBOX                 
-------------------------------------------------------
(A)  
Check the actual output display for the 
exact locaction of any fields. Do not use the
following for that purpose.

   IEE459I  hh:mm:ss   DEVSERV QPAVS [ID]

       Host                            Subsystem
   Configuration                      Configuration
  --------------                      -------------
   UNIT                                  UNIT  UA
   NUM. UA  TYPE        STATUS     SSID  ADDR. TYPE
  ----- --  ----        ------     ----  ----  --------
  sdddd aa  BASE        INV-ALIAS  ssss   uu   BASE
  sdddd aa  ALIAS-bbbb  NOT-BASE   ssss   uu   ALIAS-aa
  sdddd aa  NON-PAV     NOT-ALIAS  ssss   uu   NC
  sdddd aa  NON-PAV     NON-NPAV   ssss   uu   ALIAS-aa
  sdddd aa  ALIAS       UNBOUND    ssss   uu   ALIAS-aa
  sdddd aa  BASE-H                 ssss   uu   BASE
  sdddd bb  ALIAS-H                ssss   uu   ALIAS-H

  aaaaaaaa
    bbbbbbbb
In response to a DEVSERV QPAVS command, this message 
displays the following requested information:
hh.mm.ss
   The time in hours, minutes, and seconds.

 where
 - under UNIT NUM (host configuration)
     sdddd : the device number

 - under UA (host configuration)
     aa   : unit address from host configuration
 - under TYPE (host configuration)
     BASE       : sdddd is a BASE device
     ALIAS-bbbb : sdddd is an ALIAS device, the BASE 
                  is at address bbbb
     NON-PAV    : the unit is neither a BASE nor an 
                  ALIAS
     ALIAS      : sdddd is an ALIAS device 
                 and is not bound to a BASE
 - under STATUS
     INV-ALIAS : at host side, unit is defined as an 
                 ALIAS whose BASE is different than 
                 the one at sub-system side
     NOT-BASE  : at host side, unit is a BASE while 
                 at sub-system side it is not
     NOT-ALIAS : at host side, unit is an ALIAS while 
                 at sub-system side it is not
     NOT-NPAV  : at host side, unit is not a BASE nor 
                 an ALIAS, while at sub-system side, 
                 it is an ALIAS
     UNBOUND   : at host side, unit is an ALIAS but 
                 is unbound, while at sub-system side, 
                 it is assigned to this BASE(aa)
 - under SSID (sub-system configuration)
        ssss   : SSID where the device dddd belongs to
 - under UNIT ADDR (sub-system configruation)
          uu   : unit address from sub-system 
                 configuration
 - under UA TYPE (sub-system configuration)
        BASE   : unit is a BASE
    ALIAS-bb   : unit is an ALIAS, the BASE is at unit 
                 address bb
          NC   : unit is not a BASE, not an ALIAS


(B)            
   IEE459I  hh:mm:ss   DEVSERV QPAVS ID
   e.....

       where
        e..... : 
                 sdddd HAS BEEN SUCCESSFULLY UNBOXED.

        e..... : THE DEVSERV QPAV UNBOX COMMAND HAS 
                 BEEN EXECUTED WITH RETURN CODE = yy, 
                 REASON CODE = zz

        e..... : sdddd IS NOT AN UNBOUND PAV-ALIAS 
                 DEVICE. THE DEVSERV QPAV UNBOX 
                 COMMAND IS NOT EXECUTED.

        e..... : sdddd IS NOT IN BOX STATE.
                 THE DEVSERV QPAV UNBOX COMMAND IS 
                 NOT EXECUTED.
----------------------------------------------------------
           Example Displays of DEVSERV QPAVS
----------------------------------------------------------
1. The following command will return PAV status for the device 
   at starting address D300 and the next 2 addresses:
    DS QP,D300,3

    IEE459I 16.23.07 DEVSERV QPAVS 630
         Host                            Subsystem
      Configuration                    Configuration
     --------------                   -------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    -----
     0D300 05  NON-PAV                2401   05     BASE
     0D301 06  NON-PAV                2401   06     BASE
     0D302 07  NON-PAV                2401   07     BASE
     ****      3 DEVICE(S) MET THE SELECTION CRITERIA
2. The following command will return PAV status for the alias 
   device (at address D3FF), its base and other companion alias 
   devices that are part of this logical volume:
    DS QP,D3FF,VOLUME

    IEE459I 16.43.07 DEVSERV QPAVS 632
         Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D300 05  BASE                   2401   05     BASE
     0D3FE FE  ALIAS-D300             2401   FE     ALIAS-05
     0D3FF FF  ALIAS-D300             2401   FF     ALIAS-05
     ****      3 DEVICE(S) MET THE SELECTION CRITERIA
3. The following command will return the PAV status for the base 
   device at address D300 and its alias volumes:
    DS QP,D300,VOLUME

    IEE459I 16.43.20 DEVSERV QPAVS 633
         Host                             Subsystem
      Configuration                      Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D300 05  BASE                   2401   05     BASE
     0D3FE FE  ALIAS-D300             2401   FE     ALIAS-05
     0D3FF FF  ALIAS-D300             2401   FF     ALIAS-05
     ****      3 DEVICE(S) MET THE SELECTION CRITERIA

4. The following command will unbox an alias address at 
   address D6FF: 
   DS QP,D6FF,UNBOX

    IEE459I 08.20.32 DEVSERV QPAVS 591
     0D6FE HAS BEEN SUCCESSFULLY UNBOXED.
5. The following command will return the PAV status for 
   an unbound alias device types:
    DS QP,D5EF,UCB

    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 :
   D5EF(0A)
 **** (0A) - DEVICE IS AN UNBOUND PAV-ALIAS
6. The following command will return the PAV information for 
   the devices that have the same SSID value:
    DS QP,SSID=1601

    IEE459I 16.25.04 DEVSERV QPAVS 642
         Host                             Subsystem
      Configuration                     Configuration
     --------------                   --------------------
      UNIT                                  UNIT    UA
      NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
     ----- --  ----        ------     ----  ----    --------
     0D300 03  BASE                   1601   03     BASE
     0D3FE 2A  ALIAS-D300             1601   2A     ALIAS-03
     0D3FF 2B  ALIAS-D300             1601   2B     ALIAS-03
     ****    2 DEVICE(S) MET THE SELECTION CRITERIA

7. The following NOT-BASE will be shown when the address D345 was
   defined in HCD as a PAV Base but was not configured in the 2105
   as a PAV Base address:
    DS QP,D345

    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

8. The following NOT-ALIAS will be shown if the address D621 was
   defined in HCD as a PAV Alias but was not configured in the 2105
   as a PAV Alias address:
    DS QP,D621

    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

9. The following INV-ALIAS will be shown if the address D6F4 was
   defined in HCD for a Base volume that does not match the Base
   volume the Alias is defined for in the 2105:
    DS QP,D6F4

    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

10. The following NON-NPAV will be shown if the address F60 was
    defined in HCD as a NON-PAV device but was configured in the
    in the 2105 as an ALIAS device:
     DS QP,F60
     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     NON-NPAV   0101   F0     ALIAS-03
      ****      1 DEVICE(S) MET THE SELECTION CRITERIA

11. DS QPAV with the VOLUME parameter issued to DASD. A request is made
    using the UCBINFO PAVINFO MACRO. If this request fails, then the
    following output will be seen:
      IEE459I 10.49.59 DEVSERV QPAVS 405
          Host                             Subsystem
       Configuration                      Configuration
      --------------                   --------------------
       UNIT                                  UNIT    UA
       NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
      ----- --  ----        ------     ----  ----    ----
      0D716 16  BASE                   8108   16     BASE    
        UCBINFO FAILS WITH RC=xx AND RSN CODE=xx
      ****      1 DEVICE(S) MET THE SELECTION CRITERIA

12.DS QPAV,sdddd,VOL where sdddd is a base HYPERPAV device.
The VOL parameter will list all HYPERPAV aliases defined on
the control unit.       IEE459I 09.06.07 DEVSERV QPAVS 469
          HOST                             SUBSYSTEM
       CONFIGURATION                      CONFIGURATION
      ---------------                  ---------------------
       UNIT                                  UNIT    UA
       NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
      ----- --  ----        ------     ----  ----    -----
      0E200 00  BASE-H                 3205   00     BASE
      0E27F 7F  ALIAS-H

13. DS QPAV,sdddd,VOL where sdddd is an alias HYPERPAV device.
      ds qpavs,e27f,volume
      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
14. DS QPAV,SSID=xxxx displays all the devices with the same SSID
 defined to the control unit.  It will list all devices where the
 IO has completed successfully.
      ds qp,ssid=00ff

       CONFIGURATION                      CONFIGURATION
      ---------------                  ---------------------
       UNIT                                  UNIT    UA
       NUM. UA  TYPE        STATUS     SSID  ADDR.   TYPE
      ----- --  ----        ------     ----  ----    ----------
      0D200 00  BASE-H                 00FF   00     BASE
      0D201 01  BASE-H                 00FF   01     BASE
      0D202 02  BASE-H                 00FF   02     BASE
      0D203 03  BASE-H                 00FF   03     BASE
      0D204 04  BASE-H                 00FF   04     BASE
      0D205 05  BASE-H                 00FF   05     BASE
      0D206 06  BASE-H                 00FF   06     BASE
      0D207 07  BASE-H                 00FF   07     BASE
      0D2F9 F9  ALIAS-H                00FF   F9
      0D2FA FA  ALIAS-H                00FF   FA
      0D2FB FB  ALIAS-H                00FF   FB
      0D2FC FC  ALIAS-H                00FF   FC
      0D2FD FD  ALIAS-H                00FF   FD
      0D2FE FE  ALIAS-H                00FF   FE
      ****     14 DEVICE(S) MET THE SELECTION CRITERIA).

System programmer response

If DS QPAV issues a Return Code(RC) and Reason Code(RSN), then check the return and reason code in z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO. Search problem reporting databases for a fix for the problem. If no fix exists, contact the IBM Support Center.

Source

DFSMSdfp

Routing code

#

Descriptor code

8,9

Parent topic: IEE messages (IEE400I - IEE699I)