NAME       : HCPQRBLK
 DESCRIPTION: Queue Request Block
 DSECT      : QRBLK
 FUNCTION   : An internal CP control block used to map an I/O request,
              which was initiated on QDIO queue using the QDIO
              Hardware Facility.
 CREATED BY : Dynamically created by HCPGETST when a
              I/O request is initiated on a QDIO queue.
              The information contained within the QRBLK
              maintains all information related to a
              single SBAL.  If more than one SBAL is
              required for a single I/O operation, then
              multiple QRBLKs will be linked from QRBCONT.
 DELETED BY : Deleted by HCPRELST after receiving a
              completion event on via a QDIO input queue.
  NCHORED   - Output Queues' QIOBK (QIOACTV), which
              initiated the request.  If more then 1 SBAL
              was required for the request, then
              additional QRBLKs will be linked off QRBCONT.
 RELOCATION CONSIDERATIONS : None
 COMMENTS   : - Not known by hardware.
              - Mapped in the system execution space.
              - This could be moved out of the SXS space with
              little effort.

 QRBLK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      QRBLK          Queue Request Block
      Control Information
0000    0 Address      4 QRBNEXT        Host logical address of the next
                                        QRBLK on the List or 0
0004    4 Address      4 QRBPREV        Host logical address of the
                                        previous QRBLK on the List or 0
0008    8 Address      4 QRBCONT        Continuation Queue Next pointer
                                        (Host logical address ofa QRBLK)
000C   12 Address      4 QRBOWNER       Host logical address of the
                                        owning VMDBK of this Request
0010   16 Address      4 QRBQIOBK       Host logical address of the
                                        owning QIOBK of this Request
      Procssing / Serialization Flags
      QRBACTC   - QRBLK is currently queued on the outstanding
                  I/O request queue waiting for a completion
                  to be posted on the input queue by the adapter.
      QRBCOMP   - This QRBLK and the QRBLKs which may be linked
                  off QRBCONT represent a complete outstanding
                  I/O request.  If the request is a multiple
                  linked SBAL operation, then all SBALs
                  associated with the request have been given to
                  the adapter to process.
      QRBPOST   - Completion of this I/O request has been posted
                  via the adapter on the input queue.  The
                  request is no longer active.
0014   20 Bitstring    1 QRBPROC        I/O Request Processing Flags
          1... ....      QRBACTV        X'80' QRBACTV QRBLK on Active
                                        Queue
          .1.. ....      QRBCOMP        X'40' QRBCOMP Complete I/O
                                        Request
          ..1. ....      QRBPOST        X'20' QRBPOST Completion Posted
                                        by Adapter
0015   21 Bitstring    1 * (3)          Reserved for Future IBM Use
      I/O Request Specific Information
0018   24 Dbl-Word     8 QRBREQID       Guest's Request ID
      Storage Block Array             (Host Absolute addresses)
0020   32 Address      8 QRBARRAY (16)  Storage Block Array
00A0  160 Signed       4 * (2)          Reserved for future IBM use
00A8  168 Bitstring    1 QRB$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 are in effect.

          
*** QRBLK - Queue Request Block
*
*     +---------------------------+---------------------------+
*   0 |         QRBNEXT           |         QRBPREV           |
*     +---------------------------+---------------------------+
*   8 |         QRBCONT           |         QRBOWNER          |
*     +---------------------------+------+--------------------+
*  10 |         QRBQIOBK          |:PROC |////////////////////|
*     +---------------------------+------+--------------------+
*  18 |                       QRBREQID                        |
*     +-------------------------------------------------------+
*  20 |                                                       |
*     =                       QRBARRAY                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  A0 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** QRBLK - Queue Request Block

 
Symbol         Dspl Value
-------------- ---- -----
QRB$END        00A8
QRBACTV        0014 80
QRBARRAY       0020
QRBCOMP        0014 40
QRBCONT        0008
QRBNEXT        0000
QRBOWNER       000C
QRBPOST        0014 20
QRBPREV        0004
QRBPROC        0014
QRBQIOBK       0010
QRBREQID       0018