QRBLK - 32-bit CP - V4R4.0

Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### QRBLK

Prolog

Control Block Contents
QRBLK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### QRBLK Prolog

     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.
     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

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 16:06:44 EDT.
Copyright IBM Corporation, 1990, 2003