Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCCPU
PrologControl 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 V7R1.0.
Last updated on 11 Sept 2018 at 19:49:20.
Copyright IBM Corporation, 1990, 2018