NAME       : HCPIPQBK
 DESCRIPTION: I/O Priority Queueing Parameter Block
 DSECT      : IPQBK
 FUNCTION   : Contains I/O Priority Queueing Information
              For A Guest
 LOCATED BY : VMDIPQPT
 CREATED BY : HCPLGN  At LOGON
 DELETED BY : HCPUSP  At LOGOFF
 SERIALIZED : The respective IPQBK lock (IPQLKWRD) must be held
              exclusive in order to update any field in the IPQBK.
              Also, IPQLKWRD must be held shared to reference any
              field in the IPQBK.   However, field IPQDSKIP is
              serialized by compare and swap logic, not the IPQBK
              lock.

 IPQBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      IPQBK          I/O Priority Queueing Parameter Block
0000    0 Dbl-Word     8 IPQLKWRD (3)   Lockword for this control block
0018   24 Bitstring    1 IPQRQLO        Requested low range value
0019   25 Bitstring    1 IPQRQHI        Requested high range value
001A   26 Bitstring    1 IPQF0          Flag byte 0
          1... ....      IPQRELRG       X'80' IPQRELRG This is a RELATIVE
                                        range.
          .1.. ....      IPQABSRG       X'40' IPQABSRG This is a ABSOLUTE
                                        range.
          ..1. ....      IPQGSSC        X'20' IPQGSSC Guest requested I/O
                                        subsystem details which includes
                                        I/O priority facility status.
                                        This usually indicates that the
                                        guest is I/O priority aware.
001B   27 Bitstring    1 *              Reserved for future IBM use
001C   28 Bitstring    1 IPQEFLO        Effective low range value
001D   29 Bitstring    1 IPQEFHI        Effective high range value
001E   30 Bitstring    1 IPQQULO        Queueing Calculation range LO
                                        value
001F   31 Bitstring    1 IPQQUHI        Queueing Calculation range HI
                                        value
0020   32 Address      4 IPQEVNTQ       Event Information queue pointer
0024   36 Signed       4 IPQDSKIP       Count of times that a DASD I/O
                                        request was outprioritized by
                                        another virtual machine's I/O.
                                        Serialized by compare and swap
                                        logic.
0028   40 Bitstring    1 IPQEVCNT       Number of entries on the event
                                        data queue. Max = 20.
0029   41 Bitstring    1 * (3)          Reserved for future IBM use
002C   44 Signed       4 *              Reserved for future IBM use
0030   48 Dbl-Word     8 * (2)          Reserved for future IBM use
0040   64 Bitstring    1 IPQ$END (0)    The end
      Notes      : The following assembler equates are defined and can be
            used but do not appear in the control block expansion
            because they are in the PLX section and
            PRINT OFF,NOGEN is in effect.


 IPQXBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      IPQXBK         I/O-Priority Event Information Pending Queue
0000    0 Address      4 IPQXPTR        Pointer to next entry in FIFO
                                        Queue
0004    4 Bitstring    1 IPQXNT         Notification type (NT)
0005    5 Bitstring    1 * (3)          RESERVED
0008    8 Bitstring    1 IPQXDATA (0)   NT dependent data
      NT=0 data
0008    8 Bitstring    1 IPQXFLGH       SYSIOPQH byte when created
0009    9 Bitstring    1 IPQXCPLO       SYSIOPLO byte when created
000A   10 Bitstring    1 IPQXCPHI       SYSIOPHI byte when created
000B   11 Bitstring    1 *              Reserved for future IBM use
000C   12 Bitstring    1 IPQXNIP        Input Flags for HCPVMNIP
          1... ....      IPQXCP         X'80' IPQXCP Low and High values
                                        are new CP range from real
                                        machine check.
          .1.. ....      IPQXDIS        X'40' IPQXDIS I/O Priority
                                        Queuing went from enabled to
                                        disabled
          ..1. ....      IPQXENB        X'20' IPQXENB I/O Priority
                                        Queuing went from disabled to
                                        enabled
          ...1 ....      IPQXRV10       X'10' IPQXRV10 Reserved for
                                        future IBM use
          .... 1...      IPQXUSER       X'08' IPQXUSER Low and High
                                        values are new USER range values.
          .... .1..      IPQXREL        X'04' IPQXREL This is a RELATIVE
                                        range. Valid only if new USER
                                        range.
          .... ..1.      IPQXABS        X'02' IPQXABS This is a ABSOLUTE
                                        range. Valid only if new USER
                                        range.
          .... ...1      IPQXRV01       X'01' IPQXRV01 Reserved for
                                        future IBM use
000D   13 Bitstring    1 IPQXUSLO       New LO Value of User Priority
                                        Range
000E   14 Bitstring    1 IPQXUSHI       New HI Value of User Priority
                                        Range
000F   15 Bitstring    1 *              Reserved for future IBM use
0010   16 Signed       4 *              Reserved for future IBM use NT=2
                                        data
0008    8 Bitstring    1 IPQXNT2D (88)  Space for NT=2 & NT=4
0008    8 Bitstring    1 IPQXNT2P
0060   96 Bitstring    1 IPQX$END (0)   The end
      Notes      : The following assembler equates are defined and can be
            used but do not appear in the control block expansion
            because they are in the PLX section and
            PRINT OFF,NOGEN is in effect.
      IPQXSZB   EQU   (IPQ$END-IPQBK)       Size in bytes
      IPQXSZ    EQU   (IPQ$END-IPQBK+7)/8   Size in d-words

          
*** IPQBK - I/O Priority Queueing Parameter Block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       IPQLKWRD                        =
*     |                                                       |
*     +------+------+------+------+------+------+------+------+
*  18 |:RQLO |:RQHI |IPQF0 |//////|:EFLO |:EFHI |:QULO |:QUHI |
*     +------+------+------+------+------+------+------+------+
*  20 |         IPQEVNTQ          |         IPQDSKIP          |
*     +------+--------------------+---------------------------+
*  28 |:EVCNT|////////////////////|///////////////////////////|
*     +------+--------------------+---------------------------+
*  30 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** IPQBK - I/O Priority Queueing Parameter Block
          
*** IPQXBK - I/O-Priority Event Information Pending Queue
*
*     +---------------------------+------+--------------------+
*   0 |         IPQXPTR           |IPQXNT|////////////////////|
*     +------+------+------+------+------+------+------+------+
*   8 |:XFLGH|:XCPLO|:XCPHI|//////|:XNIP |:XUSLO|:XUSHI|//////|
*     +------+------+------+------+------+------+------+------+
*  10 |///////////////////////////|///////////////////////////|
*     +---------------------------+///////////////////////////|
*  18 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** IPQXBK - I/O-Priority Event Information Pending Queue
          
*** Overlay for IPQXDATA in IPQXBK
*
*     +-------------------------------------------------------+
*   8 |                                                       |
*     =                       IPQXNT2D                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  60
*
*** Overlay for IPQXDATA in IPQXBK
          
*** Overlay for IPQXNT2D in IPQXBK
*
*     +------+
*   8 |:XNT2P| 9
*     +------+
*
*** Overlay for IPQXNT2D in IPQXBK

 
Symbol         Dspl Value
-------------- ---- -----
IPQ$END        0040
IPQABSRG       001A 40
IPQDSKIP       0024
IPQEFHI        001D
IPQEFLO        001C
IPQEVCNT       0028
IPQEVNTQ       0020
IPQF0          001A
IPQGSSC        001A 20
IPQLKWRD       0000
IPQQUHI        001F
IPQQULO        001E
IPQRELRG       001A 80
IPQRQHI        0019
IPQRQLO        0018
IPQX$END       0060
IPQXABS        000C 02
IPQXCP         000C 80
IPQXCPHI       000A
IPQXCPLO       0009
IPQXDATA       0008
IPQXDIS        000C 40
IPQXENB        000C 20
IPQXFLGH       0008
IPQXNIP        000C
IPQXNT         0004
IPQXNT2D       0008
IPQXNT2P       0008
IPQXPTR        0000
IPQXREL        000C 04
IPQXRV01       000C 01
IPQXRV10       000C 10
IPQXUSER       000C 08
IPQXUSHI       000E
IPQXUSLO       000D