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    64  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
                                                  CPU time when PRCCCPU_PROTIME
                                                  is off.
  56  38  Character     8  PRCCPU_LIMMTODE        TOD when most recently
                                                  completed limiting interval
                                                  ended
  64  40  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     64
PRCCPU_CPUAFFON           1C           40
PRCCPU_END                40      0
PRCCPU_FLAGS              1C      1
PRCCPU_LCPCTCPA           28      4
PRCCPU_LIMCPUTY           1D      1
PRCCPU_LIMCTMEM           24      4
PRCCPU_LIMITED            1C           80
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 V6R3.0.

Last updated on 11 Mar 2015 at 14:11:38.
Copyright IBM Corporation, 1990, 2015