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

#### MRIODQDS

Prolog
Control Block Contents
Cross Reference

#### MRIODQDS Prolog

     DSECT NAME - IODQDS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODQDS
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 6 - I/O Domain
                        Record 26 - QDIO Device Activity Sample
     DESCRIPTION - Indicates activity on 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.

#### MRIODQDS Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   348  IODQDS                 Start of monitor record
       0   0  Character     0  IODQDS_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  IODQDS_RDEVDEV         Real device number (data
                                                      dev)
      22  16  Unsigned      2  *                      Reserved for IBM use
      24  18  Unsigned      4  IODQDS_QDIOCSGR        Count of SIGA-r
                                                      instructions issued by guest.
      28  1C  Unsigned      4  IODQDS_QDIOCSGW        Count of SIGA-w
                                                      instructions issued by guest.
      32  20  Unsigned      4  IODQDS_QDIOCSGS        Count of SIGA-s
                                                      instructions issued by guest.
      36  24  Unsigned      4  IODQDS_RDEVVSSR        Count of SIGA-r
                                                      instructions issued by CP.
      40  28  Unsigned      4  IODQDS_RDEVVSSW        Count of SIGA-w
                                                      instructions issued by CP.
      44  2C  Unsigned      4  IODQDS_RDEVVSSS        Count of SIGA-w
                                                      instructions issued by CP.
      48  30  Character     8  IODQDS_BFTOA           QDIO buffers sent to
                                                      adapter (unsigned-64)
      56  38  Character     8  IODQDS_BYTOA           Bytes sent to adapter
                                                      (unsigned-64)
      64  40  Character     8  IODQDS_BFFRA           QDIO buffers taken from
                                                      adapter (unsigned-64)
      72  48  Character     8  IODQDS_BYFRA           Bytes taken from adapter
                                                      (unsigned-64)
      80  50  Unsigned      4  IODQDS_RDEVVSIN        Count of all interrupts
                                                      presented for this device.
      84  54  Unsigned      4  IODQDS_RDEVVSIR        Count of interrupts
                                                      presented that require a
                                                      response and cause an input
                                                      operation.
      88  58  Unsigned      4  IODQDS_RDEVVSID        Count of interrupts
                                                      presented that are discarded
                                                      because they do not require a
                                                      response.
      92  5C  Character    48  IODQDS_QEBSM_FIELDS    All QEBSM Counters
      92  5C  Unsigned      4  IODQDS_QSBSQBVM        Count of SQBS instructions
                                                      issued by z/VM on behalf of a
                                                      guest.
      96  60  Unsigned      4  IODQDS_QSBSQBPV        Count of SQBS instructions
                                                      partially handled by z/VM.
     100  64  Unsigned      4  IODQDS_QSBEQBVM        Count of EQBS instructions
                                                      issued by z/VM on behalf of a
                                                      guest.
     104  68  Unsigned      4  IODQDS_QSBEQBPV        Count of EQBS instructions
                                                      partially handled by z/VM.
     108  6C  Unsigned      4  IODQDS_QSBLOCK         Count of times CP Millicode
                                                      was unable to acquire the
                                                      QIOBK/QSD Lock
     112  70  Unsigned      4  IODQDS_QSBFOBX         Count of times there was no
                                                      available FOBLKs on a
                                                      processors available list.
     116  74  Unsigned      4  IODQDS_QSBOLCK         Count of times CP Millicode
                                                      was unabled to acquire thr
                                                      QIOBK/QSD Lock of a format 1
                                                      output queue.
     120  78  Unsigned      4  IODQDS_QSBSIGWT        Count of SIGA-wt
                                                      instructions issued by z/VM.
     124  7C  Unsigned      4  IODQDS_QSBSIGRT        Count of SIGA-rt
                                                      instructions issued by z/VM.
     128  80  Unsigned      4  IODQDS_QSBSIGLT        Count of SIGA-lt
                                                      instructions issued by z/VM.
     132  84  Unsigned      4  IODQDS_SUMOFPIN        Count of times CP Millicode
                                                      had a problem pinning a guest
                                                      page.
     136  88  Unsigned      4  IODQDS_SUMUNPIN        Count of times CP Millicode
                                                      had a problem unpinning a
                                                      guest page.
     140  8C  Unsigned      4  IODQDS_QSBSIGPV        Count of SIGA instructions
                                                      partially handled by z/VM.
     144  90  Unsigned      4  IODQDS_QDIASYNC        Count of asynchronous QDIO
                                                      operations performed.
     148  94  Unsigned      4  IODQDS_QDISGCC2        Count of CC 2 conditions
                                                      encountered on SIGA
     152  98  Unsigned      4  IODQDS_QSBLDC          Count of lost data
                                                      conditions
     156  9C  Unsigned      4  IODQDS_QDIOCSWQ        Count of SIGA-wq
                                                      instructions issued by guest.
     160  A0  Unsigned      4  IODQDS_QSBSIGWQ        Count of SIGA-wqt
                                                      instructions issued by z/VM.
     164  A4  Character   184  IODQDS_RESVD           Reserved.
     348 15C  Character     0  IODQDS_END

#### MRIODQDS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODQDS                     0    348
    IODQDS_BFFRA              40      8
    IODQDS_BFTOA              30      8
    IODQDS_BYFRA              48      8
    IODQDS_BYTOA              38      8
    IODQDS_END               15C      0
    IODQDS_MRHDR               0      0
    IODQDS_QDIASYNC           90      4
    IODQDS_QDIOCSGR           18      4
    IODQDS_QDIOCSGS           20      4
    IODQDS_QDIOCSGW           1C      4
    IODQDS_QDIOCSWQ           9C      4
    IODQDS_QDISGCC2           94      4
    IODQDS_QEBSM_FIELDS       5C     48
    IODQDS_QSBEQBPV           68      4
    IODQDS_QSBEQBVM           64      4
    IODQDS_QSBFOBX            70      4
    IODQDS_QSBLDC             98      4
    IODQDS_QSBLOCK            6C      4
    IODQDS_QSBOLCK            74      4
    IODQDS_QSBSIGLT           80      4
    IODQDS_QSBSIGPV           8C      4
    IODQDS_QSBSIGRT           7C      4
    IODQDS_QSBSIGWQ           A0      4
    IODQDS_QSBSIGWT           78      4
    IODQDS_QSBSQBPV           60      4
    IODQDS_QSBSQBVM           5C      4
    IODQDS_RDEVDEV            14      2
    IODQDS_RDEVVSID           58      4
    IODQDS_RDEVVSIN           50      4
    IODQDS_RDEVVSIR           54      4
    IODQDS_RDEVVSSR           24      4
    IODQDS_RDEVVSSS           2C      4
    IODQDS_RDEVVSSW           28      4
    IODQDS_RESVD              A4    184
    IODQDS_SUMOFPIN           84      4
    IODQDS_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:23:45.

    Copyright IBM Corporation, 1990, 2020