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   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
   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        *
  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
                                                  External Bridged = 6
                                                  IEDN Access = 7
                                                  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 V6R2.0.
Last updated on 18 Apr 2012 at 13:32:39.
Copyright IBM Corporation, 1990, 2012