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.
     Comments   : - Not known by hardware.
                  - Mapped in the system execution space.
                  - This could be moved out of the SXS space with
                  little effort.

#### 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        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' 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 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 Storage Layout

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

#### QRBLK Cross Reference

    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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:19:16 EDT.
Copyright IBM Corporation, 1990, 2005