Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRQDC
PrologControl 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 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 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_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 V5R3.0.
Last updated on 17 Apr 2009 at 08:50:23.
Copyright IBM Corporation, 1990, 2007