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 Configuration 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   367  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. ....        MTRQDC_VDEVMBSF         Multiple Buffer Streaming
                                                      Facility in use
              ...1 ....        MTRQDC_QDICOMPQ         Last Input Queue is a
                                                      Completion Queue
              .... 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  Character     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  Unsigned      1  MTRQDC_RDEVOSAS        OSA Subtype - This field
                                                      indicates the type of network
                                                      device. Not a Network Device:
                                                      = 0 HiperSockets: IQD CHPID =
                                                      1 External Bridged = 6 IBM
                                                      RESERVED = 7 QDIO: OSA CHPID
                                                      = 2 OSE CHPID = 2 OSD CHPID =
                                                      2 OSN CHPID = 3 IBM RESERVED
                                                      = 4 IBM RESERVED = 5
     161  A1  Character     3  *                      Reserved
     164  A4  Unsigned      4  MTRQDC_QSBSIGPV        Count of SIGA instructions
                                                      partially handled by z/VM.
     168  A8  Unsigned      4  MTRQDC_QDIASYNC        Count of asynchronous QDIO
                                                      operations performed.
     172  AC  Unsigned      4  MTRQDC_QDISGCC2        Count of CC 2 conditions
                                                      encountered on SIGA
     176  B0  Unsigned      4  MTRQDC_QSBLDC          Count of lost data
                                                      conditions
     180  B4  Unsigned      4  MTRQDC_QDIOCSWQ        Count of SIGA-wq
                                                      instructions issued by guest.
     184  B8  Unsigned      4  MTRQDC_QSBSIGWQ        Count of SIGA-wqt
                                                      instructions issued by z/VM.
     188  BC  Character   180  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    367
    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_QDIASYNC           A8      4
    MTRQDC_QDICOMPQ           26           10
    MTRQDC_QDINPCT            22      2
    MTRQDC_QDIOCSGR           2C      4
    MTRQDC_QDIOCSGS           34      4
    MTRQDC_QDIOCSGW           30      4
    MTRQDC_QDIOCSWQ           B4      4
    MTRQDC_QDIOEBSM           26           40
    MTRQDC_QDIOFMT            20      2
    MTRQDC_QDIOQMCU           26           80
    MTRQDC_QDIOUTCT           24      2
    MTRQDC_QDISGCC2           AC      4
    MTRQDC_QEBSM_FIELDS       70     48
    MTRQDC_QSBEQBPV           7C      4
    MTRQDC_QSBEQBVM           78      4
    MTRQDC_QSBFOBX            84      4
    MTRQDC_QSBLDC             B0      4
    MTRQDC_QSBLOCK            80      4
    MTRQDC_QSBOLCK            88      4
    MTRQDC_QSBSIGLT           94      4
    MTRQDC_QSBSIGPV           A4      4
    MTRQDC_QSBSIGRT           90      4
    MTRQDC_QSBSIGWQ           B8      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              BC    180
    MTRQDC_STATUS             26      4
    MTRQDC_SUMOFPIN           98      4
    MTRQDC_SUMUNPIN           9C      4
    MTRQDC_VDEVDEV            1E      2
    MTRQDC_VDEVMBSF           26           20
    MTRQDC_VMDUSER            16      8

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

    Last updated on 09 August 2020 at 14:19:57.

    Copyright IBM Corporation, 1990, 2020