Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTCUM
PrologControl Block Contents
Cross Reference
MRSYTCUM Prolog
DSECT NAME - SYTCUM FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTCUM DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 17 - Physical CPU Utilization Data for LPAR Management DESCRIPTION - Physical CPU utilization data for LPAR management, including data for each CPU. NOTES: -- This record is generated only when the system is running in the logical partition ("LPAR") environment and the LPAR management time facility is available on the system. -- SYTCUM_CALMIBOF and SYTCUM_CALMIBLN should always be used to locate the SYTCUM_MIBDATA entries. Their values may be subject to change. -- This record is not generated if the HMC Global Performance Data setting is disabled.
MRSYTCUM Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 36 SYTCUM Start of monitor record 0 0 Character 0 SYTCUM_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 Unsigned 1 SYTCUM_CALNREC Number of SYTCUM_MIBDATA entries found in this record. One SYTCUM_MIBDATA entry is created for each physical CPU. For the total number of physical CPUs see SYTCUM_LCUPCPCT. 21 15 Bitstring 1 SYTCUM_CALFLGS Flag byte 1... .... SYTCUM_CALMORE When set to ON, indicates an additional MRSYTCUM record is created for this LPAR. When OFF, indicates this is the only or last MRSYTCUM record for this LPAR. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 22 16 Unsigned 1 SYTCUM_LCUPCPCT Total number of physical CPUs. 23 17 Character 1 * Reserved for IBM use 24 18 Signed 2 SYTCUM_CALMIBOF Byte offset, relative to the start of this record, to the first SYTCUM_MIBDATA entry of the table 26 1A Signed 2 SYTCUM_CALMIBLN Length, in bytes, of a SYTCUM_MIBDATA entry 28 1C Character 8 SYTCUM_LCUTCTOD Time-of-day, in TOD clock value, that the physical CPU information was fetched 36 24 Character 0 * Table of SYTCUM_MIBDATA entries, one for each physical CPU. SYTCUM_CALMIBOF, SYTCUM_CALMIBLN and SYTCUM_LCUPCPCT should be used to locate this table.
CPU Utilization data for LPAR management. There is a separate entry for each CPU.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 36 SYTCUM_MIBDATA Physical CPU data entry 0 0 Unsigned 2 SYTCUM_LCUMCPU Physical CPU address 2 2 Character 8 SYTCUM_LCUMGTM Accumulated number of microseconds during which a physical processor was assigned LPAR management time. This value is reset only when LPAR is initialized. 10 A Character 16 SYTCUM_LCUPTYPE Physical processor type as an EBCDIC string. Contains a value only if enhanced LPAR monitor support with support for secondary processors is available as indicated by SYTCUG_LCUT204E. 26 1A Character 2 * Reserved and available for IBM use. 28 1C Character 8 SYTCUM_LCUSMTM If non-zero, accumulated number of microseconds during which a physical processor was assigned system management time. This value is reset only by a power on reset. 36 24 Character 0 SYTCUM_END
MRSYTCUM 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 SYTCUM 0 36 SYTCUM_CALFLGS 15 1 SYTCUM_CALMIBLN 1A 2 SYTCUM_CALMIBOF 18 2 SYTCUM_CALMORE 15 80 SYTCUM_CALNREC 14 1 SYTCUM_END 24 0 SYTCUM_LCUMCPU 0 2 SYTCUM_LCUMGTM 2 8 SYTCUM_LCUPCPCT 16 1 SYTCUM_LCUPTYPE A 16 SYTCUM_LCUSMTM 1C 8 SYTCUM_LCUTCTOD 1C 8 SYTCUM_MIBDATA 0 36 SYTCUM_MRHDR 0 0
This information is based on z/VM V6R2.0.
Last updated on 09 Nov 2012 at 16:50:04.
Copyright IBM Corporation, 1990, 2012