|
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