|
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 utilization 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.
- This record is not generated if the HMC Global
Performance Data setting is disabled.
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 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 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 V7R2.0.
Last updated on 09 August 2020 at 14:42:20.
Copyright IBM Corporation, 1990, 2020