Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTCUP
PrologControl Block Contents
Storage Layout
Cross Reference
MRSYTCUP Prolog
DSECT NAME - SYTCUP FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTCUP DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 16 - CPU Utilization Data in a Logical Partition DESCRIPTION - CPU utilization data for an individual logical partition. Also included are data for each logical CPU in the partition. NOTES: -- This record is generated only when the system is running in the logical partition ("LPAR") environment. -- A separate record is generated for each logical partition in the system. -- SYTCUP_CALCPUOF and SYTCUP_CALCPULN should always be used to locate the SYTCUP_CPUDATA entries. Their values may be subject to change.
MRSYTCUP Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 44 SYTCUP Start of monitor record 0 0 Character 0 SYTCUP_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 Character 8 SYTCUP_LCUPNAME Logical partition name 28 1C Unsigned 1 SYTCUP_LCUPPNUM Logical partition number 29 1D Bitstring 1 SYTCUP_CALFLGS Flag byte 1... .... SYTCUP_CALPTIS When set to ON, this logical partition is the one that fetched the logical CPU utilization data .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 30 1E Unsigned 1 SYTCUP_LCUPCPCT Number of logical CPUs in this partition. This also is the number of SYTCUP_CPUDATA entries in the record. If zero, this partition is not active. 31 1F Character 1 * Reserved for IBM use 32 20 Signed 2 SYTCUP_CALCPUOF Byte offset, relative from the start of this record, to the first SYTCUP_CPUDATA entry of the table 34 22 Signed 2 SYTCUP_CALCPULN length, in bytes, of a SYTCUP_CPUDATA entry 36 24 Character 8 SYTCUP_LCUTCTOD Time-of-day, in TOD clock value, that the logical CPU information was fetched 44 2C Character 0 * Table of SYTCUP_CPUDATA entries, one for each logical CPU in the partition. SYTCUP_CALCPUOF, SYTCUP_CALCPULN and SYTCUP_LCBPCPCT should be used to locate this table.
CPU Utilization data for an individual logical CPU. There is a separate entry for each logical CPU in the partition.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 22 SYTCUP_CPUDATA Logical CPU data entry 0 0 Unsigned 2 SYTCUP_LCUCPUID Logical CPU address 2 2 Unsigned 2 SYTCUP_LCUCWGHT Processing weight as assigned to this partition. Value is in range of 0 to 999 except that it is set to 65535 (x'FFFF') if this CPU is dedicated to this logical partition. 4 4 Bitstring 1 SYTCUP_LCUCFLGS CPU Information flag byte 1... .... SYTCUP_LCUCWCPL Wait completion flag. ON = 'YES' has been specified in the Wait Completion option of the logical partition controls. Logical CPU dispatching is to be done without regard to logical CPU wait states. OFF = CPU time not used by one logical CPU may be given to another logical CPU or logical partition. .1.. .... SYTCUP_LCUCCAPP Partition-Capping flag. ON if the operator has set capped=yes in the logical-partition controls. Not set if the logical partition uses dedicated CPUs. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 5 5 Unsigned 1 * Reserved for IBM use 6 6 Character 8 SYTCUP_LCUCACTM Accumulated number of microseconds during which a physical processor was assigned to this logical processor. Accumulation continues (i.e., is not reset) while the logical processor is defined. 14 E Character 8 SYTCUP_LCUCLPTM Accumulated number of microseconds, excluding LPAR-management time, during which a physical CPU was assigned to this logical CPU. This value is not reset while the logical CPU is defined.
MRSYTCUP 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 SYTCUP 0 44 SYTCUP_CALCPULN 22 2 SYTCUP_CALCPUOF 20 2 SYTCUP_CALFLGS 1D 1 SYTCUP_CALPTIS 1D 80 SYTCUP_CPUDATA 0 22 SYTCUP_LCUCACTM 6 8 SYTCUP_LCUCCAPP 4 40 SYTCUP_LCUCFLGS 4 1 SYTCUP_LCUCLPTM E 8 SYTCUP_LCUCPUID 0 2 SYTCUP_LCUCWCPL 4 80 SYTCUP_LCUCWGHT 2 2 SYTCUP_LCUPCPCT 1E 1 SYTCUP_LCUPNAME 14 8 SYTCUP_LCUPPNUM 1C 1 SYTCUP_LCUTCTOD 24 8 SYTCUP_MRHDR 0 0
This information is based on z/VM V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002