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.

    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        *
     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 PCI interrupts
                                                    for this device
     84  54  Unsigned     4  IODQDS_RDEVVSIR        Count of PCI interrupts that
                                                    require a response and cause an
                                                    input operation
     88  58  Unsigned     4  IODQDS_RDEVVSID        Count of PCI interrupts 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    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_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 V5R2.0.

    Last updated on 12 Dec 2005 at 15:27:14.

    Copyright IBM Corporation, 1990, 2005