|
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 V5R4.0.
Last updated on 7 Nov 2012 at 17:37:41.
Copyright IBM Corporation, 1990, 2012