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   44  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
      2   2  Unsigned     2  MRHDRZER
      4   4  Unsigned     1  MRHDRDM
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC
      8   8  Character    8  MRHDRTOD
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END
     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      *
     39  27  Bitstring    1  *                      reserved for future IBM
     40  28  Bitstring    1  *                      reserved for future IBM
     41  29  Bitstring    1  *                      reserved for future IBM
     42  2A  Character    2  *                      reserved for future IBM
     44  2C  Character    0  IODQDA_END

    MRIODQDA Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODQDA                     0     44
    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 V5R2.0.

    Last updated on 12 Dec 2005 at 15:27:00.

    Copyright IBM Corporation, 1990, 2005