IPQBK | Back to Index page

| Prolog Control Block Contents IPQBK DSECT IPQXBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

IPQBK Prolog | Top of page

     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 Control Block Content | Top of page

     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 IPQXFLG        Additional flags
              1... ....      IPQXIORA       X'80' IPQXIORA I/O resource event
    0006    6 Signed       2 IPQXL2         NT dependant data length
    0008    8 Bitstring    1 IPQXDATA (0)   NT dependent data
          Notification Type 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
          Notification Type 0 Data - I/O Resource Accessibility
    0008    8 Bitstring    1 IPQXIORD (24)  Size of I/O RA response data
          Notification Type 2 (PCI) Data
    0008    8 Bitstring    1 IPQXNT2D (88)  NT=2 (PCI) data - len = CSCNT2SIZ
    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 Storage Layout | Top of page

    *** 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|:XFLG |   IPQXL2    |
    *     +------+------+------+------+------+------+------+------+
    *   8 |:XFLGH|:XCPLO|:XCPHI|//////|:XNIP |:XUSLO|:XUSHI|//////|
    *     +------+------+------+------+------+------+------+------+
    *  10 |///////////////////////////|///////////////////////////|
    *     +---------------------------+///////////////////////////|
    *  18 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *
    *** IPQXBK - I/O-Priority Event Information Pending Queue

    *** Overlay for IPQXDATA in IPQXBK
    *
    *     +-------------------------------------------------------+
    *   8 |                                                       |
    *     =                       IPQXIORD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  20
    *
    *** Overlay for IPQXDATA in IPQXBK

    *** Overlay for IPQXDATA in IPQXBK
    *
    *     +-------------------------------------------------------+
    *   8 |                                                       |
    *     =                       IPQXNT2D                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  60
    *
    *** Overlay for IPQXDATA in IPQXBK

IPQBK Cross Reference | Top of page

    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
    IPQXFLG        0005
    IPQXFLGH       0008
    IPQXIORA       0005 80
    IPQXIORD       0008
    IPQXL2         0006
    IPQXNIP        000C
    IPQXNT         0004
    IPQXNT2D       0008
    IPQXPTR        0000
    IPQXREL        000C 04
    IPQXRV01       000C 01
    IPQXRV10       000C 10
    IPQXUSER       000C 08
    IPQXUSHI       000E
    IPQXUSLO       000D

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:28:41 EDT.
Copyright IBM Corporation, 1990, 2020