Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRPRCIOP

Prolog
Control 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.
   - 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               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 V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008