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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005