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               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      2  *
  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    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 V6R2.0.
Last updated on 28 Nov 2011 at 19:33:04.
Copyright IBM Corporation, 1990, 2011