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 V6R4.0.
Last updated on 24 Feb 2018 at 21:18:20.
Copyright IBM Corporation, 1990, 2018