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.

    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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003