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   348  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
       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  IODQDD_RDEVDEV         Real device number (data
                                                      dev)
      22  16  Unsigned      2  *                      Reserved for IBM use
      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 External Bridged = 6 IBM
                                                      RESERVED = 7 QDIO: OSA CHPID
                                                      = 2 OSE CHPID = 2 OSD CHPID =
                                                      2 OSN CHPID = 3 IBM RESERVED
                                                      = 4 IBM RESERVED = 5
     141  8D  Character     3  *                      Reserved
     144  90  Unsigned      4  IODQDD_QSBSIGPV        Count of SIGA instructions
                                                      partially handled by z/VM.
     148  94  Unsigned      4  IODQDD_QDIASYNC        Count of asynchronous QDIO
                                                      operations performed.
     152  98  Unsigned      4  IODQDD_QDISGCC2        Count of CC 2 conditions
                                                      encountered on SIGA
     156  9C  Unsigned      4  IODQDD_QSBLDC          Count of lost data
                                                      conditions
     160  A0  Unsigned      4  IODQDD_QDIOCSWQ        Count of SIGA-wq
                                                      instructions issued by guest.
     164  A4  Unsigned      4  IODQDD_QSBSIGWQ        Count of SIGA-wqt
                                                      instructions issued by z/VM.
     168  A8  Character   180  IODQDD_RESVD           Reserved.
     348 15C  Character     0  IODQDD_END

#### MRIODQDD Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODQDD                     0    348
    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_QDIASYNC           94      4
    IODQDD_QDIOCSGR           18      4
    IODQDD_QDIOCSGS           20      4
    IODQDD_QDIOCSGW           1C      4
    IODQDD_QDIOCSWQ           A0      4
    IODQDD_QDISGCC2           98      4
    IODQDD_QEBSM_FIELDS       5C     48
    IODQDD_QSBEQBPV           68      4
    IODQDD_QSBEQBVM           64      4
    IODQDD_QSBFOBX            70      4
    IODQDD_QSBLDC             9C      4
    IODQDD_QSBLOCK            6C      4
    IODQDD_QSBOLCK            74      4
    IODQDD_QSBSIGLT           80      4
    IODQDD_QSBSIGPV           90      4
    IODQDD_QSBSIGRT           7C      4
    IODQDD_QSBSIGWQ           A4      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              A8    180
    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 V7R2.0.

    Last updated on 09 August 2020 at 16:22:40.

    Copyright IBM Corporation, 1990, 2020