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.
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_LCUPCPCT Number of physical CPUs. This also is the number of SYTCUM_MIBDATA entries in the record. 21 15 Character 3 * 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 10 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.
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_CALMIBLN 1A 2 SYTCUM_CALMIBOF 18 2 SYTCUM_LCUMCPU 0 2 SYTCUM_LCUMGTM 2 8 SYTCUM_LCUPCPCT 14 1 SYTCUM_LCUTCTOD 1C 8 SYTCUM_MIBDATA 0 10 SYTCUM_MRHDR 0 0
This information is based on z/VM V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004