Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRIODQDA

Prolog
Control Block Contents
Cross Reference

MRIODQDA Prolog

 DSECT NAME - IODQDA
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRIODQDA
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 6 - I/O Domain
                    Record 25 - QDIO Device Activation
 DESCRIPTION - Indicates that a QDIO device has been activated.
 NOTES -
  1.  This record is emitted for only real QDIO devices for which
      z/VM CP is maintaining shadow queues.  (If CP is not shadowing
      the queues, it doesn't see the I/O and therefore can't emit
      this record.)  Typically Linux guests would use shadow queues
      but z/VM TCP/IP would not.  z/VM TCP/IP drives its real QDIO
      devices using Diag X'98' and does not use shadow queues.


MRIODQDA Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure   41  IODQDA                 Start of monitor record
  0   0  Character    0  IODQDA_MRHDR           Record header. See MRRECHDR.
  0   0  Character   20  MRHDR                  
  0   0  Unsigned     2  MRHDRLEN               record length in bytes
  2   2  Unsigned     2  MRHDRZER               field of zeros
  4   4  Unsigned     1  MRHDRDM                domain identifier
  5   5  Unsigned     1  *                      
  6   6  Unsigned     2  MRHDRRC                record identifier
  8   8  Character    8  MRHDRTOD               Time at which this record was
                                                built. In time-of-day (TOD)
                                                clock format. See IBM System
                                                370 XA Principle of Operation
                                                for explanation of format.
 16  10  Character    4  *                      
 20  14  Character    0  MRHDR_END              End of header
 20  14  Unsigned     2  IODQDA_RDEVDEV         Real device number (data dev)
 22  16  Character    8  IODQDA_VMDUSER         Owning user ID.
 30  1E  Unsigned     2  IODQDA_VDEVDEV         Owner virtual device number.
 32  20  Unsigned     2  IODQDA_QDIOFMT         QDIO format type 0=QDIO 1=FCP
                                                2=HIPERSOCKETS
 34  22  Unsigned     2  IODQDA_QDINPCT         Number of input queues.
 36  24  Unsigned     2  IODQDA_QDIOUTCT        Number of output queues.
 38  26  Bitstring    4  IODQDA_STATUS          status bits
          1... ....      IODQDA_QDIOQMCU        QDIO multi ctlunit support
          .1.. ....      IODQDA_QDIOEBSM        QEBSM Managed QDIO Connection
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 38  26  Bitstring    1  *                      reserved for future IBM
 39  27  Bitstring    1  *                      reserved for future IBM
 40  28  Bitstring    1  *                      reserved for future IBM
 42  2A  Character       *                      
 44  2C  Character    0  IODQDA_END             

MRIODQDA Cross Reference

                      Hex           Hex
Name                 Offset Length Value
 
IODQDA                     0     41
IODQDA_END                2C      0
IODQDA_MRHDR               0      0
IODQDA_QDINPCT            22      2
IODQDA_QDIOEBSM           26           40
IODQDA_QDIOFMT            20      2
IODQDA_QDIOQMCU           26           80
IODQDA_QDIOUTCT           24      2
IODQDA_RDEVDEV            14      2
IODQDA_STATUS             26      4
IODQDA_VDEVDEV            1E      2
IODQDA_VMDUSER            16      8
MRHDR                      0     20
MRHDR_END                 14      0
MRHDRDM                    4      1
MRHDRLEN                   0      2
MRHDRRC                    6      2
MRHDRTOD                   8      8
MRHDRZER                   2      2

This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007