QRBLK Back to Index page
 
Prolog 
Control Block Contents 
   QRBLK 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.


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

 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 Storage Layout Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:54:11 EDT.
Copyright IBM Corporation, 1990, 2022