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  346  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               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  IODQDS_RDEVDEV         Real device number (data dev)
     22  16  Unsigned        *
     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  Character  208  IODQDS_RESVD           Reserved.
    348 15C  Character    0  IODQDS_END

    MRIODQDS Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODQDS                     0    346
    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_QDIOCSGR           18      4
    IODQDS_QDIOCSGS           20      4
    IODQDS_QDIOCSGW           1C      4
    IODQDS_QEBSM_FIELDS       5C     48
    IODQDS_QSBEQBPV           68      4
    IODQDS_QSBEQBVM           64      4
    IODQDS_QSBFOBX            70      4
    IODQDS_QSBLOCK            6C      4
    IODQDS_QSBOLCK            74      4
    IODQDS_QSBSIGLT           80      4
    IODQDS_QSBSIGRT           7C      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              8C    208
    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 V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009