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.

    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
      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  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      *
     39  27  Bitstring    1  *                      reserved for future IBM
     40  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   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  Character  208  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_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_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              A0    208
    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 V5R2.0.

    Last updated on 17 Apr 2009 at 08:48:26.

    Copyright IBM Corporation, 1990, 2005