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

#### MRMTRQDC

Prolog
Control Block Contents
Cross Reference

#### 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.
      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.

    MRMTRQDC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  365  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.. ....      MTRQDC_QDIOEBSM        QEBSM Managed QDIO Connection
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     38  26  Bitstring    1  *                      reserved for future IBM
     39  27  Bitstring    1  *                      reserved for future IBM
     40  28  Bitstring    1  *                      reserved for future IBM
     42  2A  Unsigned        *
     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   48  MTRQDC_QEBSM_FIELDS    All QEBSM Counters
    112  70  Unsigned     4  MTRQDC_QSBSQBVM        Count of SQBS instructions
                                                    issued by z/VM on behalf of a
                                                    guest.
    116  74  Unsigned     4  MTRQDC_QSBSQBPV        Count of SQBS instructions
                                                    partially handled by z/VM.
    120  78  Unsigned     4  MTRQDC_QSBEQBVM        Count of EQBS instructions
                                                    issued by z/VM on behalf of a
                                                    guest.
    124  7C  Unsigned     4  MTRQDC_QSBEQBPV        Count of EQBS instructions
                                                    partially handled by z/VM.
    128  80  Unsigned     4  MTRQDC_QSBLOCK         Count of times CP Millicode
                                                    was unable to acquire the
                                                    QIOBK/QSD Lock
    132  84  Unsigned     4  MTRQDC_QSBFOBX         Count of times there was no
                                                    available FOBLKs on a
                                                    processors available list.
    136  88  Unsigned     4  MTRQDC_QSBOLCK         Count of times CP Millicode
                                                    was unabled to acquire thr
                                                    QIOBK/QSD Lock of a format 1
                                                    output queue.
    140  8C  Unsigned     4  MTRQDC_QSBSIGWT        Count of SIGA-wt instructions
                                                    issued by z/VM.
    144  90  Unsigned     4  MTRQDC_QSBSIGRT        Count of SIGA-rt instructions
                                                    issued by z/VM.
    148  94  Unsigned     4  MTRQDC_QSBSIGLT        Count of SIGA-lt instructions
                                                    issued by z/VM.
    152  98  Unsigned     4  MTRQDC_SUMOFPIN        Count of times CP Millicode
                                                    had a problem pinning a guest
                                                    page.
    156  9C  Unsigned     4  MTRQDC_SUMUNPIN        Count of times CP Millicode
                                                    had a problem unpinning a guest
                                                    page.
    160  A0  Unsigned     1  MTRQDC_RDEVOSAS        OSA Subtype - This field
                                                    indicates the type of network
                                                    device.
                                                    Not a network device: = 0
                                                    HiperSockets:
                                                      IQD CHPID = 1
                                                    QDIO:
                                                      OSA CHPID = 2
                                                      OSE CHPID = 2
                                                      OSD CHPID = 2
                                                      OSN CHPID = 3
                                                      OSM CHPID = 4
                                                      OSX CHPID = 5
    161  A1  Character  207  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    365
    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_QDIOEBSM           26           40
    MTRQDC_QDIOFMT            20      2
    MTRQDC_QDIOQMCU           26           80
    MTRQDC_QDIOUTCT           24      2
    MTRQDC_QEBSM_FIELDS       70     48
    MTRQDC_QSBEQBPV           7C      4
    MTRQDC_QSBEQBVM           78      4
    MTRQDC_QSBFOBX            84      4
    MTRQDC_QSBLOCK            80      4
    MTRQDC_QSBOLCK            88      4
    MTRQDC_QSBSIGLT           94      4
    MTRQDC_QSBSIGRT           90      4
    MTRQDC_QSBSIGWT           8C      4
    MTRQDC_QSBSQBPV           74      4
    MTRQDC_QSBSQBVM           70      4
    MTRQDC_RDEVDEV            14      2
    MTRQDC_RDEVOSAS           A0      1
    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              A1    207
    MTRQDC_STATUS             26      4
    MTRQDC_SUMOFPIN           98      4
    MTRQDC_SUMUNPIN           9C      4
    MTRQDC_VDEVDEV            1E      2
    MTRQDC_VMDUSER            16      8

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

    Last updated on 10 Nov 2010 at 13:09:13.

    Copyright IBM Corporation, 1990, 2010