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

#### MRPRCCPU

Prolog
Control Block Contents
Cross Reference

#### MRPRCCPU Prolog

     DSECT NAME - PRCCPU
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRPRCCPU
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 5  - Processor Domain
                        Record 19 - CPU Pool Utilization
     DESCRIPTION - Records a snapshot of how a CPU pool is running so
                   the CPU pools can be analyzed.  It includes total CPU
                   used by a CPU pool, the total amount of time the CPU
                   pool was limited, the number of times the pool was
                   limited, and how many users are in the CPU pool.

#### MRPRCCPU Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    76  PRCCPU                 Start of monitor record.
       0   0  Character     0  PRCCPU_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  Character     8  PRCCPU_LIMPOOL         CPU pool name.
      28  1C  Bitstring     1  PRCCPU_FLAGS           Flag byte.
              1... ....        PRCCPU_LIMITED          If ON, the CPU pool is
                                                      currently being limited.
              .1.. ....        PRCCPU_CPUAFFON         CPU Affinity setting for
                                                      the PRCCPU_LIMCPUTY processor
                                                      type limited by this CPU
                                                      pool. If ON, CPU Affinity is
                                                      ON. If OFF, CPU Affinity is
                                                      suppressed.
              ..1. ....        PRCCPU_PROTIME          If ON, prorated core time
                                                      is used to limit the CPU
                                                      pool. If OFF, raw CPU time is
                                                      used.
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      29  1D  Unsigned      1  PRCCPU_LIMCPUTY        CPU pool CPU type limited.
                                                      Valid values: X'00' - General
                                                      Purpose (CP) X'03' -
                                                      Integrated Facility for Linux
                                                      (IFL)
      30  1E  Unsigned      1  PRCCPU_TYPELIM         TYPE of LIMIT listed in
                                                      PRCCPU_MAXSHARE. Valid
                                                      values: X'01' - LIMITHARD
                                                      limit X'02' - CAPACITY limit
      31  1F  Character     1  *                      Reserved for IBM use.
      32  20  Unsigned      4  PRCCPU_MAXSHARE        CPU pool maximum share from
                                                      DEFINE or SET CPUPOOL
                                                      command. Unit of value is a
                                                      hexadecimal factor scaled 16
                                                      bits. For example,
                                                      X'00010000' = 1.00(100%),
                                                      X'0000C000' = 0.75(75%),
                                                      X'00008000' = 0.50(50%), etc.
      36  24  Unsigned      4  PRCCPU_LIMCTMEM        Current number of users in
                                                      the CPU pool.
      40  28  Unsigned      4  PRCCPU_LCPCTCPA        Cumulative number of times
                                                      the CPU Affinity changed for
                                                      the PRCCPU_LIMCPUTY processor
                                                      type limited by this CPU
                                                      pool.
      44  2C  Unsigned      4  PRCCPU_LIMMTNUM        Cumulative number of times
                                                      the CPU pool has been limited
                                                      since it was created, updated
                                                      when limiting period ends
      48  30  Character     8  PRCCPU_LIMMTTIM        Total time consumed by CPU
                                                      pool members, in CPU Timer
                                                      format, from pool creation
                                                      until PRCCPU_LIMMTODE. This
                                                      is the total prorated core
                                                      time when PRCCPU_PROTIME is
                                                      on, or the total raw CPU time
                                                      when PRCCPU_PROTIME is off.
      56  38  Character     8  PRCCPU_LIMMTODE        TOD when most recently
                                                      completed limiting interval
                                                      ended and the data contained
                                                      in this record was recorded.
                                                      The difference between TOD
                                                      values in subsequent monitor
                                                      records can be used to
                                                      calculate rates and
                                                      utilization.
      64  40  Character     8  PRCCPU_LIMLIMTM        Cumulative elapsed time
                                                      virtual CPUs of resource pool
                                                      members have been limited.
                                                      Calculated when guests are
                                                      placed on the Limit List, and
                                                      thus may include time in the
                                                      next monitor sample interval.
      72  48  Unsigned      4  PRCCPU_LIMLIMCT        Total number of times
                                                      virtual CPUs of resource pool
                                                      members have been limited
      76  4C  Character     0  PRCCPU_END

#### MRPRCCPU 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
    PRCCPU                     0     76
    PRCCPU_CPUAFFON           1C           40
    PRCCPU_END                4C      0
    PRCCPU_FLAGS              1C      1
    PRCCPU_LCPCTCPA           28      4
    PRCCPU_LIMCPUTY           1D      1
    PRCCPU_LIMCTMEM           24      4
    PRCCPU_LIMITED            1C           80
    PRCCPU_LIMLIMCT           48      4
    PRCCPU_LIMLIMTM           40      8
    PRCCPU_LIMMTNUM           2C      4
    PRCCPU_LIMMTODE           38      8
    PRCCPU_LIMMTTIM           30      8
    PRCCPU_LIMPOOL            14      8
    PRCCPU_MAXSHARE           20      4
    PRCCPU_MRHDR               0      0
    PRCCPU_PROTIME            1C           20
    PRCCPU_TYPELIM            1E      1

    This information is
    based on z/VM V7R2.0.

    Last updated on 09 August 2020 at 14:36:20.

    Copyright IBM Corporation, 1990, 2020