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


  QDIO Prolog Top of page
 
 NAME       : HCPQDIO
 DESCRIPTION: Queued Direct I/O Control Block
 DSECT      : QDIO
 FUNCTION   :
              HCPQDIO maps all the guest's and associated CP shadow
              QDIO Queues for a specific subchannel.
 LOCATED BY : VDEVQDIO
 SERIALIZED : VDEV Lock
 CREATED BY : Dynamically created by HCPGETST when a QDIO
              Queue is created with an Establish-QDIO-
              Queues Channel Command.  This control
              block exists in the system execution
              space, and my be backed anywhere in storage.
 DELETED BY : Deleted by HCPRELST when a QDIO Activate-
              QDIO-Queues Channel Command terminates.
 RELOCATION CONSIDERATIONS : None
 COMMENTS   :
              - Not known by hardware.
              - The following tags are used to described the
              address type for pointers within this control block:
              A : Host absolute address
              R : Host real address
              L : Logical address in the system execution space
              G : Guest absolute address
 
 
  QDIO Control Block Content Top of page
 

 QDIO DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure QDIO Queued Direct I/O Control Block QDIO Lock 0000 0 Dbl-Word 8 QDIOLOCK (3) QDIO Lock Word 0018 24 Address 4 QDIORDEV L: address of RDEV associated with this queue. 001C 28 Signed 4 QDIOREAS Failing reason code during QDIO Queue creation. 0020 32 Address 4 QDICPQDR L: Address of CP's Queue-Description Record (QDR) used when issuing Establish-QDIO-Queues CCW. (Fretted after I/O). Following Fields Serialized on Compare and Swap 0024 36 Address 4 QDIOQERR L:Address of a QIOBK that has an error to report -----End of Compare and Swap Serialization***************---- QDIO Queue Information Block 0028 40 Dbl-Word 8 QDIGQIB64 G:Guest absolute ADDR of QIB. 0030 48 Dbl-Word 8 QDIHQIB64 A:Host absolute address of Guest's QIB. (locked) QDIO Storage Access and Queue Flags 0038 56 Bitstring 1 QDIOFG1 Storage Access Flag .... 1... QDIOACT X'08' QDIOACT QDIO Q's have been activated .... .1.. QDIODOFS X'04' QDIODOFS Delete QDIO Queues when final status is received. .... ..1. QDIOGA64 X'02' QDIOGA64 Guest absolute addresses are 64 bit. QDIO Processing Flags 0039 57 Bitstring 1 QDIOFG2 Processing Flags 1... .... QDIOSYNC X'80' QDIOSYNC Synchronous SIGA processing required. 1 SIGA per primed buffer .1.. .... QDIOOPCI X'40' QDIOOPCI Extended PCI Supported ..1. .... QDIOQMCU X'20' QDIOQMCU Adapter configured for QDIO Multiple Control Unit Facility ...1 .... QDIOEBSM X'10' QDIOEBSM QEBSM Managed Connection .... 1... QDIODROU X'08' QDIODROU FCP Data Router requested .... .1.. QDICOMPQ X'04' QDICOMPQ Last Input Queue is a Completion Queue 003A 58 Bitstring 1 QDIOPCNT Number of ports per chpid 003B 59 Bitstring 1 QDIOTKEY QIB Storage Key 1111 .... QDIQKEY X'F0' QDIQKEY Storage Key Mask for QIB Input / Output QDIO Queues 003C 60 Bitstring 1 QDIOFMT QDIO Format Type 00000000 QDIOFMT0 X'00' QDIOFMT0 Format 0 Queue 00000001 QDIOFMT1 X'01' QDIOFMT1 Format 1 Queue 00000002 QDIOFMT2 X'02' QDIOFMT2 Format 2 Queue 00000003 QDIOFMT3 X'03' QDIOFMT3 Format 3 Queue 00000002 QDIOLFMT QDIOFMT2 QDIOLFMT Highest supported Q format 003D 61 Bitstring 1 QDINPCT Number of Input Queues 003E 62 Bitstring 1 QDIOUTCT Number of Output Queues QDIO Hardware Support Flags 003F 63 Bitstring 1 QDIOHWS Hardware Support Flags 1... .... QDISIGAW X'80' QDISIGAW SIGA-w Initiate Write Supported .1.. .... QDISIGAR X'40' QDISIGAR SIGA-r Initiate Read Supported ..1. .... QDISIGAS X'20' QDISIGAS SIGA-s Synchronize Supported QDIO Queue Anchors The following are the anchors for two link lists of QIOBK(s) created when an Establish-QDIO-Queues CCW is issued. The link list is an ordered list with QIONEXT pointing to the next queue. The first queue in the list (the one specified in the anchor) is for queue 0, while the next linked QIOBK pointed by QIONEXT is for queue 1. Up to 32 queues may be linked on each anchor. One anchor is for established input queues and the other is for output queues. 0040 64 Address 4 QDINPUT L:ADDR of first QDIO Input Q 0044 68 Address 4 QDIOUTQ L:ADDR of first QDIO Output Q 0048 72 Signed 4 QDIOMCAS Format-2 MultiCast Queue Mask Processing Routines 004C 76 Address 4 QDIOQPRC L:Shadow Queue Processor Linkage: HCPCALL R15, ATTR=(RES,MP,DYN,LONGREG, AMODE64,TMODEAR) Input/Output: Like HCPVQQSS (Zero for vSwitch) QEBSM Information 0050 80 Dbl-Word 8 QDIQBICB A:QBICB address which is also the QEBSM Subchannel Token 0058 88 Signed 4 QDIOVDEV L:VDEV Block Address Performance Counters Notes : QDIOCSGW, QDIOWCSGR, and QDIOCSGS are treated as an array of counters, and therefore they must remain contiguous in the control block. QDIOCSGW, QDIOWCSGR, and QDIOCSGS are serialized by the VDEV lock and not the QDIO Lock. 005C 92 Bitstring 16 QDIOCTRS (0) --- Start of contiguous area 005C 92 Signed 4 QDIOCSGW Virtual SIGA-w count 0060 96 Signed 4 QDIOCSGR Virtual SIGA-r count 0064 100 Signed 4 QDIOCSGS Virtual SIGA-s count 0068 104 Signed 4 QDIOCSWQ Virtual SIGA-wq count --- End of contiguous area 006C 108 Signed 4 QDICMPLQ L:QIOBK for CP's Completion Queue 0070 112 Signed 4 QDIQSBLK L:QSBLK QDIO Statistics Block 0074 116 Signed 4 QDIASYNC Count of SIGA-wq instructions that were performed asynchronously Completion Queue Information 0078 120 Dbl-Word 8 QDIQAOB The next R:QAOB to be used for SIGA-wq 0080 128 Signed 4 QDIAQCNT Active QAOB count 0084 132 Signed 4 QDISGCC2 Count of SIGA-w / SIGA-wq CC 2 conditions encountered Reserved Space 0088 136 Dbl-Word 8 * (2) Reserved for Future IBM USE 0098 152 Character 1 QDI$END (0) End of Queued Direct I/O CB 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 is in effect.
 
 
  QDIO Storage Layout Top of page
 
          
*** QDIO - Queued Direct I/O Control Block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       QDIOLOCK                        =
*     |                                                       |
*     +---------------------------+---------------------------+
*  18 |         QDIORDEV          |         QDIOREAS          |
*     +---------------------------+---------------------------+
*  20 |         QDICPQDR          |         QDIOQERR          |
*     +---------------------------+---------------------------+
*  28 |                      QDIGQIB64                        |
*     +-------------------------------------------------------+
*  30 |                      QDIHQIB64                        |
*     +------+------+------+------+------+------+------+------+
*  38 |:OFG1 |:OFG2 |:OPCNT|:OTKEY|:OFMT |:NPCT |:OUTCT|:OHWS |
*     +------+------+------+------+------+------+------+------+
*  40 |         QDINPUT           |         QDIOUTQ           |
*     +---------------------------+---------------------------+
*  48 |         QDIOMCAS          |         QDIOQPRC          |
*     +---------------------------+---------------------------+
*  50 |                       QDIQBICB                        |
*     +---------------------------+---------------------------+
*  58 |         QDIOVDEV          |         QDIOCSGW          |
*     +---------------------------+---------------------------+
*  60 |         QDIOCSGR          |         QDIOCSGS          |
*     +---------------------------+---------------------------+
*  68 |         QDIOCSWQ          |         QDICMPLQ          |
*     +---------------------------+---------------------------+
*  70 |         QDIQSBLK          |         QDIASYNC          |
*     +---------------------------+---------------------------+
*  78 |                       QDIQAOB                         |
*     +---------------------------+---------------------------+
*  80 |         QDIAQCNT          |         QDISGCC2          |
*     +---------------------------+---------------------------+
*  88 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** QDIO - Queued Direct I/O Control Block
 
 
  QDIO Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
QDI$END        0098
QDIAQCNT       0080
QDIASYNC       0074
QDICMPLQ       006C
QDICOMPQ       0039 04
QDICPQDR       0020
QDIGQIB64      0028
QDIHQIB64      0030
QDINPCT        003D
QDINPUT        0040
QDIOACT        0038 08
QDIOCSGR       0060
QDIOCSGS       0064
QDIOCSGW       005C
QDIOCSWQ       0068
QDIOCTRS       005C
QDIODOFS       0038 04
QDIODROU       0039 08
QDIOEBSM       0039 10
QDIOFG1        0038
QDIOFG2        0039
QDIOFMT        003C
QDIOFMT0       003C 00000000
QDIOFMT1       003C 00000001
QDIOFMT2       003C 00000002
QDIOFMT3       003C 00000003
QDIOGA64       0038 02
QDIOHWS        003F
QDIOLFMT       003C 00000002
QDIOLOCK       0000
QDIOMCAS       0048
QDIOOPCI       0039 40
QDIOPCNT       003A
QDIOQERR       0024
QDIOQMCU       0039 20
QDIOQPRC       004C
QDIORDEV       0018
QDIOREAS       001C
QDIOSYNC       0039 80
QDIOTKEY       003B
QDIOUTCT       003E
QDIOUTQ        0044
QDIOVDEV       0058
QDIQAOB        0078
QDIQBICB       0050
QDIQKEY        003B F0
QDIQSBLK       0070
QDISGCC2       0084
QDISIGAR       003F 40
QDISIGAS       003F 20
QDISIGAW       003F 80
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:54:05 EDT.
Copyright IBM Corporation, 1990, 2022