QRBLK

Prolog  

Control Block Contents  
   QRBLK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

QRBLK Prolog

 NAME       : HCPQRBLK
 COPYRIGHT -
              THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
              5739-A03 (C) COPYRIGHT IBM CORP. - 2002
              LICENSED MATERIALS - PROPERTY OF IBM
 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.
 ANCHORED   - 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.

QRBLK Control Block Content

QRBLK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      QRBLK          Queue Request Block
     Control Information
0000    0 Address      4 QRBNEXT        Next QRBLK on the List or 0
0004    4 Address      4 QRBPREV        Previous QRBLK on the List or 0
0008    8 Address      4 QRBCONT        Contiuation Queue Next Pointer
000C   12 Address      4 QRBOWNER       Owning VMDBK of this Request
0010   16 Address      4 QRBQIOBK       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' QRBLK on Active Queue
          .1.. ....      QRBCOMP        X'40' Complete I/O Request
          ..1. ....      QRBPOST        X'20' 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 Real Addresses)
0020   32 Signed       4 QRBSB0 (0)     Storage Block 0
0020   32 Address      4 QRBARRAY (16)  Storage Block Array
0060   96 Signed       4 * (2)          Reserved for future IBM use
0068  104 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 Storage Layout

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

QRBLK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
QRB$END        0068
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
QRBSB0         0020