|
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.
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