|
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 V5R4.0.
Last updated on 17 Apr 2009 at 08:51:41.
Copyright IBM Corporation, 1990, 2008