|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODQDS
PrologControl Block Contents
Cross Reference
MRIODQDS Prolog
DSECT NAME - IODQDS
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODQDS
DESCRIPTIVE NAME - Monitor Sample Record
Domain 6 - I/O Domain
Record 26 - QDIO Device Activity Sample
DESCRIPTION - Indicates activity on 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.
MRIODQDS Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 346 IODQDS Start of monitor record
0 0 Character 0 IODQDS_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 IODQDS_RDEVDEV Real device number (data dev)
22 16 Unsigned *
24 18 Unsigned 4 IODQDS_QDIOCSGR Count of SIGA-r instructions
issued by guest.
28 1C Unsigned 4 IODQDS_QDIOCSGW Count of SIGA-w instructions
issued by guest.
32 20 Unsigned 4 IODQDS_QDIOCSGS Count of SIGA-s instructions
issued by guest.
36 24 Unsigned 4 IODQDS_RDEVVSSR Count of SIGA-r instructions
issued by CP.
40 28 Unsigned 4 IODQDS_RDEVVSSW Count of SIGA-w instructions
issued by CP.
44 2C Unsigned 4 IODQDS_RDEVVSSS Count of SIGA-w instructions
issued by CP.
48 30 Character 8 IODQDS_BFTOA QDIO buffers sent to adapter
(unsigned-64)
56 38 Character 8 IODQDS_BYTOA Bytes sent to adapter
(unsigned-64)
64 40 Character 8 IODQDS_BFFRA QDIO buffers taken from
adapter (unsigned-64)
72 48 Character 8 IODQDS_BYFRA Bytes taken from adapter
(unsigned-64)
80 50 Unsigned 4 IODQDS_RDEVVSIN Count of all interrupts
presented for this device.
84 54 Unsigned 4 IODQDS_RDEVVSIR Count of interrupts presented
that require a response and
cause an input operation.
88 58 Unsigned 4 IODQDS_RDEVVSID Count of interrupts presented
that are discarded because they
do not require a response.
92 5C Character 48 IODQDS_QEBSM_FIELDS All QEBSM Counters
92 5C Unsigned 4 IODQDS_QSBSQBVM Count of SQBS instructions
issued by z/VM on behalf of a
guest.
96 60 Unsigned 4 IODQDS_QSBSQBPV Count of SQBS instructions
partially handled by z/VM.
100 64 Unsigned 4 IODQDS_QSBEQBVM Count of EQBS instructions
issued by z/VM on behalf of a
guest.
104 68 Unsigned 4 IODQDS_QSBEQBPV Count of EQBS instructions
partially handled by z/VM.
108 6C Unsigned 4 IODQDS_QSBLOCK Count of times CP Millicode
was unable to acquire the
QIOBK/QSD Lock
112 70 Unsigned 4 IODQDS_QSBFOBX Count of times there was no
available FOBLKs on a
processors available list.
116 74 Unsigned 4 IODQDS_QSBOLCK Count of times CP Millicode
was unabled to acquire thr
QIOBK/QSD Lock of a format 1
output queue.
120 78 Unsigned 4 IODQDS_QSBSIGWT Count of SIGA-wt instructions
issued by z/VM.
124 7C Unsigned 4 IODQDS_QSBSIGRT Count of SIGA-rt instructions
issued by z/VM.
128 80 Unsigned 4 IODQDS_QSBSIGLT Count of SIGA-lt instructions
issued by z/VM.
132 84 Unsigned 4 IODQDS_SUMOFPIN Count of times CP Millicode
had a problem pinning a guest
page.
136 88 Unsigned 4 IODQDS_SUMUNPIN Count of times CP Millicode
had a problem unpinning a guest
page.
140 8C Character 208 IODQDS_RESVD Reserved.
348 15C Character 0 IODQDS_END
MRIODQDS Cross Reference
Hex Hex
Name Offset Length Value
IODQDS 0 346
IODQDS_BFFRA 40 8
IODQDS_BFTOA 30 8
IODQDS_BYFRA 48 8
IODQDS_BYTOA 38 8
IODQDS_END 15C 0
IODQDS_MRHDR 0 0
IODQDS_QDIOCSGR 18 4
IODQDS_QDIOCSGS 20 4
IODQDS_QDIOCSGW 1C 4
IODQDS_QEBSM_FIELDS 5C 48
IODQDS_QSBEQBPV 68 4
IODQDS_QSBEQBVM 64 4
IODQDS_QSBFOBX 70 4
IODQDS_QSBLOCK 6C 4
IODQDS_QSBOLCK 74 4
IODQDS_QSBSIGLT 80 4
IODQDS_QSBSIGRT 7C 4
IODQDS_QSBSIGWT 78 4
IODQDS_QSBSQBPV 60 4
IODQDS_QSBSQBVM 5C 4
IODQDS_RDEVDEV 14 2
IODQDS_RDEVVSID 58 4
IODQDS_RDEVVSIN 50 4
IODQDS_RDEVVSIR 54 4
IODQDS_RDEVVSSR 24 4
IODQDS_RDEVVSSS 2C 4
IODQDS_RDEVVSSW 28 4
IODQDS_RESVD 8C 208
IODQDS_SUMOFPIN 84 4
IODQDS_SUMUNPIN 88 4
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
This information is
based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007