MRMTRQDC

MRMTRQDC Prolog

 DSECT NAME - MTRQDC
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRMTRQDC
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 1 - Monitor Domain
                    Record 19 - QDIO Device Configuration
 DESCRIPTION - Indicates configuration 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.




MRMTRQDC Control Block Contents
Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure  368  MTRQDC                 Start of monitor record
  0   0  Character    0  MTRQDC_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  MTRQDC_RDEVDEV         Real device number (data dev)
 22  16  Character    8  MTRQDC_VMDUSER         Owning user ID
 30  1E  Unsigned     2  MTRQDC_VDEVDEV         Owner virtual device number
 32  20  Unsigned     2  MTRQDC_QDIOFMT         QDIO format type 0=QDIO 1=FCP
                                                2=HIPERSOCKETS
 34  22  Unsigned     2  MTRQDC_QDINPCT         Number of input queues.
 36  24  Unsigned     2  MTRQDC_QDIOUTCT        Number of output queues.
 38  26  Bitstring    4  MTRQDC_STATUS          Status bits
          1... ....      MTRQDC_QDIOQMCU        QDIO multi ctlunit
          .1.. ....      *
          ..1. ....      *
          ...1 ....      *
          .... 1...      *
          .... .1..      *
          .... ..1.      *
          .... ...1      *
 39  27  Bitstring    1  *                      reserved for future IBM
 49  28  Bitstring    1  *                      reserved for future IBM
 41  29  Bitstring    1  *                      reserved for future IBM
 42  2A  Unsigned     2  *                      reserved for future IBM
 44  2C  Unsigned     4  MTRQDC_QDIOCSGR        Count of SIGA-r instructions
                                                issued by guest.
 48  30  Unsigned     4  MTRQDC_QDIOCSGW        Count of SIGA-w instructions
                                                issued by guest.
 52  34  Unsigned     4  MTRQDC_QDIOCSGS        Count of SIGA-s instructions
                                                issued by guest.
 56  38  Unsigned     4  MTRQDC_RDEVVSSR        Count of SIGA-r instructions
                                                issued by CP.
 60  3C  Unsigned     4  MTRQDC_RDEVVSSW        Count of SIGA-w instructions
                                                issued by CP.
 64  40  Unsigned     4  MTRQDC_RDEVVSSS        Count of SIGA-w instructions
                                                issued by CP.
 68  44  Character    8  MTRQDC_BFTOA           QDIO buffers sent to adapter
                                                (unsigned-64)
 76  4C  Character    8  MTRQDC_BYTOA           Bytes sent to adapter
                                                (unsigned-64)
 84  54  Character    8  MTRQDC_BFFRA           QDIO buffers taken from
                                                adapter (unsigned-64)
 92  5C  Character    8  MTRQDC_BYFRA           Bytes taken from adapter
                                                (unsigned-64)
100  64  Unsigned     4  MTRQDC_RDEVVSIN        Count of all PCI interrupts
                                                for this device
104  68  Unsigned     4  MTRQDC_RDEVVSIR        Count of PCI interrupts that
                                                require a response and cause an
                                                input operation
108  6C  Unsigned     4  MTRQDC_RDEVVSID        Count of PCI interrupts that
                                                are discarded because they do
                                                not require a response.
112  70  Character  256  MTRQDC_RESVD           Reserved.
368 170  Character    0  MTRQDC_END




MRMTRQDC Cross Reference
                      Hex           Hex
Name                 Offset Length Value
 
MRHDR                      0     20
MRHDR_END                 14      0
MRHDRDM                    4      1
MRHDRLEN                   0      2
MRHDRRC                    6      2
MRHDRTOD                   8      8
MRHDRZER                   2      2
MTRQDC                     0    368
MTRQDC_BFFRA              54      8
MTRQDC_BFTOA              44      8
MTRQDC_BYFRA              5C      8
MTRQDC_BYTOA              4C      8
MTRQDC_END               170      0
MTRQDC_MRHDR               0      0
MTRQDC_QDINPCT            22      2
MTRQDC_QDIOCSGR           2C      4
MTRQDC_QDIOCSGS           34      4
MTRQDC_QDIOCSGW           30      4
MTRQDC_QDIOFMT            20      2
MTRQDC_QDIOQMCU           26           80
MTRQDC_QDIOUTCT           24      2
MTRQDC_RDEVDEV            14      2
MTRQDC_RDEVVSID           6C      4
MTRQDC_RDEVVSIN           64      4
MTRQDC_RDEVVSIR           68      4
MTRQDC_RDEVVSSR           38      4
MTRQDC_RDEVVSSS           40      4
MTRQDC_RDEVVSSW           3C      4
MTRQDC_RESVD              70    256
MTRQDC_STATUS             26      4
MTRQDC_VDEVDEV            1E      2
MTRQDC_VMDUSER            16      8




This information is
based on z/VM V5R1.0.

Last updated on 17 Apr 2009 at 08:53:22.

Copyright IBM Corporation, 1990, 2004