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

#### MRIODQDD

Prolog
Control Block Contents
Cross Reference

#### MRIODQDD Prolog

####

####

     DSECT NAME - IODQDD
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODQDD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6 - I/O Domain
                        Record 27 - QDIO Device Deactivation
     DESCRIPTION - Indicates deactivation of a QDIO device.
     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.
      2.  The byte count fields in this record are not correct
          if the QDIO device is an FCP device.  This is because
          of limits in the FCP protocol.

    MRIODQDD Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  346  IODQDD                 Start of monitor record
      0   0  Character    0  IODQDD_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  IODQDD_RDEVDEV         Real device number (data dev)
     22  16  Unsigned        *
     24  18  Unsigned     4  IODQDD_QDIOCSGR        Count of SIGA-r instructions
                                                    issued by guest.
     28  1C  Unsigned     4  IODQDD_QDIOCSGW        Count of SIGA-w instructions
                                                    issued by guest.
     32  20  Unsigned     4  IODQDD_QDIOCSGS        Count of SIGA-s instructions
                                                    issued by guest.
     36  24  Unsigned     4  IODQDD_RDEVVSSR        Count of SIGA-r instructions
                                                    issued by CP.
     40  28  Unsigned     4  IODQDD_RDEVVSSW        Count of SIGA-w instructions
                                                    issued by CP.
     44  2C  Unsigned     4  IODQDD_RDEVVSSS        Count of SIGA-w instructions
                                                    issued by CP.
     48  30  Character    8  IODQDD_BFTOA           QDIO buffers sent to adapter
                                                    (unsigned-64)
     56  38  Character    8  IODQDD_BYTOA           Bytes sent to adapter
                                                    (unsigned-64)
     64  40  Character    8  IODQDD_BFFRA           QDIO buffers taken from
                                                    adapter (unsigned-64)
     72  48  Character    8  IODQDD_BYFRA           Bytes taken from adapter
                                                    (unsigned-64)
     80  50  Unsigned     4  IODQDD_RDEVVSIN        Count of all PCI interrupts
                                                    for this device
     84  54  Unsigned     4  IODQDD_RDEVVSIR        Count of PCI interrupts that
                                                    require a response and cause an
                                                    input operation
     88  58  Unsigned     4  IODQDD_RDEVVSID        Count of PCI interrupts that
                                                    are discarded because they do
                                                    not require a response.
     92  5C  Character   48  IODQDD_QEBSM_FIELDS    All QEBSM Counters
     92  5C  Unsigned     4  IODQDD_QSBSQBVM        Count of SQBS instructions
                                                    issued by z/VM on behalf of a
                                                    guest.
     96  60  Unsigned     4  IODQDD_QSBSQBPV        Count of SQBS instructions
                                                    partially handled by z/VM.
    100  64  Unsigned     4  IODQDD_QSBEQBVM        Count of EQBS instructions
                                                    issued by z/VM on behalf of a
                                                    guest.
    104  68  Unsigned     4  IODQDD_QSBEQBPV        Count of EQBS instructions
                                                    partially handled by z/VM.
    108  6C  Unsigned     4  IODQDD_QSBLOCK         Count of times CP Millicode
                                                    was unable to acquire the
                                                    QIOBK/QSD Lock
    112  70  Unsigned     4  IODQDD_QSBFOBX         Count of times there was no
                                                    available FOBLKs on a
                                                    processors available list.
    116  74  Unsigned     4  IODQDD_QSBOLCK         Count of times CP Millicode
                                                    was unabled to acquire thr
                                                    QIOBK/QSD Lock of a format 1
                                                    output queue.
    120  78  Unsigned     4  IODQDD_QSBSIGWT        Count of SIGA-wt instructions
                                                    issued by z/VM.
    124  7C  Unsigned     4  IODQDD_QSBSIGRT        Count of SIGA-rt instructions
                                                    issued by z/VM.
    128  80  Unsigned     4  IODQDD_QSBSIGLT        Count of SIGA-lt instructions
                                                    issued by z/VM.
    132  84  Unsigned     4  IODQDD_SUMOFPIN        Count of times CP Millicode
                                                    had a problem pinning a guest
                                                    page.
    136  88  Unsigned     4  IODQDD_SUMUNPIN        Count of times CP Millicode
                                                    had a problem unpinning a guest
                                                    page.
    140  8C  Unsigned     1  IODQDD_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
    141  8D  Character  207  IODQDD_RESVD           Reserved.
    348 15C  Character    0  IODQDD_END

    MRIODQDD Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODQDD                     0    346
    IODQDD_BFFRA              40      8
    IODQDD_BFTOA              30      8
    IODQDD_BYFRA              48      8
    IODQDD_BYTOA              38      8
    IODQDD_END               15C      0
    IODQDD_MRHDR               0      0
    IODQDD_QDIOCSGR           18      4
    IODQDD_QDIOCSGS           20      4
    IODQDD_QDIOCSGW           1C      4
    IODQDD_QEBSM_FIELDS       5C     48
    IODQDD_QSBEQBPV           68      4
    IODQDD_QSBEQBVM           64      4
    IODQDD_QSBFOBX            70      4
    IODQDD_QSBLOCK            6C      4
    IODQDD_QSBOLCK            74      4
    IODQDD_QSBSIGLT           80      4
    IODQDD_QSBSIGRT           7C      4
    IODQDD_QSBSIGWT           78      4
    IODQDD_QSBSQBPV           60      4
    IODQDD_QSBSQBVM           5C      4
    IODQDD_RDEVDEV            14      2
    IODQDD_RDEVOSAS           8C      1
    IODQDD_RDEVVSID           58      4
    IODQDD_RDEVVSIN           50      4
    IODQDD_RDEVVSIR           54      4
    IODQDD_RDEVVSSR           24      4
    IODQDD_RDEVVSSS           2C      4
    IODQDD_RDEVVSSW           28      4
    IODQDD_RESVD              8D    207
    IODQDD_SUMOFPIN           84      4
    IODQDD_SUMUNPIN           88      4
    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 13:04:13.

    Copyright IBM Corporation, 1990, 2010