|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCIOP
PrologControl Block Contents
Cross Reference
MRPRCIOP Prolog
DSECT NAME - PRCIOP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCIOP
DESCRIPTIVE NAME - Monitor Sample Record
Domain 5 - Processor Domain
Record 8 - I/O Processor (IOP) Utilization Data
DESCRIPTION - Provides measurement data taken from the the systems'
real I/O processors. A record is generated for each
operational IOP, containing various types of processor
utilization and measurement data.
NOTES:
- Each PRCIOP record generated contains sample utilzation data for
ONE operational I/O processor in the system.
- This record is generated for an operational IOP only if the
I/O processor measurement data is available to the monitor
subsystem (e.g. if MTRSYS_SYSSTIOP is set in MRMTRSYS)
- If VM is running native, this record will be generated when the
command is available.
- If VM is running in an LPAR, the processor may be shared,
resulting in cumulative data among those active and inactive
LPARs on the system.
- If VM is running second-level, the command will not be available
and, thus, the record will not be generated.
MRPRCIOP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 96 PRCIOP Start of monitor record
0 0 Character 0 PRCIOP_MRHDR Record header. See MRRECHDR
for details.
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 Bitstring 1 PRCIOP_CSCIOPID Unique I/O processor number
21 15 Character 8 PRCIOP_CSCIOPVB
21 15 Unsigned 1 PRCIOP_CSCVBLBC Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP-BUSY counter type.
22 16 Unsigned 1 PRCIOP_CSCVBLIC Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP-IDLE counter type.
23 17 Unsigned 1 PRCIOP_CSCVBLSC Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP START-FUNCTION
counter type.
24 18 Unsigned 1 PRCIOP_CSCVBLPI Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP PROCESSED I/O
INTERRUPTIONS counter type.
25 19 Unsigned 1 PRCIOP_CSCVBLCB Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP CHANNEL-BUSY
counter type.
26 1A Unsigned 1 PRCIOP_CSCVBLSB Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP SWITCH-BUSY counter
type.
27 1B Unsigned 1 PRCIOP_CSCVBLUB Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP CONTROL-UNIT-BUSY
counter type.
28 1C Unsigned 1 PRCIOP_CSCVBLDB Unsigned integer depicting
the IOPs' model-dependent
number of valid bytes allocated
starting in the right-most
portion of the measurement data
for the IOP DEVICE-BUSY counter
type.
29 1D Character 3 * Reserved and available for
future IBM use.
32 20 Character 64 PRCIOP_CSCIOPMD
32 20 Character 8 PRCIOP_CSCMDBC Number of times the I/O
processor was BUSY when sampled
at, model- dependent, regular
intervals by the hardware. The
counter is incremented by one
when the I/O processor is busy
with the channel-subsystem
tasks at a sample point. The
value is right- justified with
zero padding.
40 28 Character 8 PRCIOP_CSCMDIC Number of times the I/O
processor was IDLE when sampled
at, model- dependent, regular
intervals by the hardware. The
counter is incremented by one
when the I/O processor is not
performing any
channel-subsystem tasks at a
sample point. The value is
right- justified with zero
padding.
48 30 Character 8 PRCIOP_CSCMDSC Number of times the I/O
processor BEGAN a START
SUBCHANNEL. The was sampled at,
model-dependent, regular
intervals by the H/W. The value
is right-justified with zero
padding.
56 38 Character 8 PRCIOP_CSCMDPI Number of times the I/O
processor generated an I/O
INTERRUPTION. This was sampled
at, model- dependent regular
intervals by the hardware. The
value is right- justified with
zero padding.
64 40 Character 8 PRCIOP_CSCMDCB Number of times the I/O
processor indicated a
CHANNEL-BUSY when sampled at,
model-dependent, regular
intervals by the H/W. The
counter is incremented by one
each time a busy channel is
encountered when attempting to
start an I/O operation to a
device. The value is right-
justified with zero padding.
72 48 Character 8 PRCIOP_CSCMDSB Number of times the I/O
processor indicated a
SWITCH-BUSY when sampled at,
model-dependent, regular
intervals by the H/W. The
counter is incremented by one
each time a busy switch is
encountered when attempting to
start an I/O operation to a
device. The value is right-
justified with zero padding.
80 50 Character 8 PRCIOP_CSCMDUB Number of times the I/O
processor indicated a
CONTROL-UNIT-BUSY when sampled
at, model-dependent, regular
intervals by the H/W. The
counter is incremented by one
each time a busy control-unit
is encountered when attempting
to start an I/O operation to a
device. The value is right-
justified with zero padding.
88 58 Character 8 PRCIOP_CSCMDDB Number of times the I/O
processor indicated a
DEVICE-BUSY when sampled at,
model-dependent, regular
intervals by the H/W. The
counter is incremented by one
each time a busy device is
found when attempting to start
an I/O operation to the device
The value is right-justified
with zero padding.
96 60 Character 0 PRCIOP_END End of record
MRPRCIOP 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
PRCIOP 0 96
PRCIOP_CSCIOPID 14 1
PRCIOP_CSCIOPMD 20 64
PRCIOP_CSCIOPVB 15 8
PRCIOP_CSCMDBC 20 8
PRCIOP_CSCMDCB 40 8
PRCIOP_CSCMDDB 58 8
PRCIOP_CSCMDIC 28 8
PRCIOP_CSCMDPI 38 8
PRCIOP_CSCMDSB 48 8
PRCIOP_CSCMDSC 30 8
PRCIOP_CSCMDUB 50 8
PRCIOP_CSCVBLBC 15 1
PRCIOP_CSCVBLCB 19 1
PRCIOP_CSCVBLDB 1C 1
PRCIOP_CSCVBLIC 16 1
PRCIOP_CSCVBLPI 18 1
PRCIOP_CSCVBLSB 1A 1
PRCIOP_CSCVBLSC 17 1
PRCIOP_CSCVBLUB 1B 1
PRCIOP_END 60 0
PRCIOP_MRHDR 0 0
This information is
based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007