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 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