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      *
     39  27  Bitstring    1  *                      reserved for future IBM use
     40  28  Bitstring    1  *                      reserved for future IBM use
     41  29  Bitstring    1  *                      reserved for future IBM use
     42  2A  Unsigned     1  IODQDA_RDEVOSAS        OSA Subtype - This field
                                                    indicates the type of network
                                                    device.
                                                    Not a network device: = 0
                                                    HiperSockets:
                                                      IQD CHPID = 1
                                                    QDIO:
                                                      OSA CHPID = 2
                                                      OSE CHPID = 2
                                                      OSD CHPID = 2
                                                      OSN CHPID = 3
                                                      OSM CHPID = 4
                                                      OSX CHPID = 5
     43  2B  Bitstring    1  *                      reserved for future IBM use
     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_RDEVOSAS           2A      1
    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 V6R1.0.

    Last updated on 10 Nov 2010 at 12:56:13.

    Copyright IBM Corporation, 1990, 2010