|
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
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.
However, if the HMC Global Performance Data setting
is disabled, you will only receive a record for your
partition.
-- 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 64 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.. .... SYTCUP_LCXPUPVA When set to ON, the user
partition ID
(SYTCUP_LCXPUPID) is valid.
..1. .... SYTCUP_CALMORE When set to ON, indicates
an additional MRSYTCUP record
is created for this LPAR.
When OFF, indicates this is
the only or last MRSYTCUP
record for this LPAR.
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
30 1E Unsigned 1 SYTCUP_CALNREC The number of
SYTCUP_CPUDATA entries in
this record. A SYTCUP_CPUDATA
entry is created for each
logical CPU in the partition.
For the total number of
logical CPUs in the partition
see SYTCUP_LCUPCPCT.
31 1F Unsigned 1 SYTCUP_LCUPCPCT Total number of logical
CPUs in this partition. If
zero, this partition is not
active. Includes secondary
processors if SYTCUG_LCUT204E
is on
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 16 SYTCUP_LCPTYPE CPU TYPE as from EBCDIC
NAME TABLE. This table is
provided by the hardware, and
describes the type of logical
processor. This field does
not contain a value when
SYTCUG_LCUT204E is on;
instead, the CPU type is
available per logical
processor in SYTCUP_LCXCPTYP.
60 3C Unsigned 1 SYTCUP_LCXPUPID User partition ID UPID is
valid if SYTCUP_LCXPUPVA is
ON. Otherwise set to zero.
61 3D Character 3 * Reserved for IBM use
64 40 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 40 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. .... SYTCUP_LCXCCONL CPU-online flag. ON if
logical CPU currently online.
Valid only if enhanced LPAR
support avail.
(SYTCUG_LCUT204A is ON and
SYTCUG_LCUT204S is OFF).
...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.
22 16 Character 16 SYTCUP_LCXCPTYP CPU type as ECBDIC string.
Contains a value only if
enhanced LPAR monitor support
with support for secondary
processors is available as
indicated by SYTCUG_LCUT204E.
38 26 Character 2 * Reserved for IBM use
40 28 Character 0 SYTCUP_END
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 64
SYTCUP_CALCPULN 22 2
SYTCUP_CALCPUOF 20 2
SYTCUP_CALFLGS 1D 1
SYTCUP_CALMORE 1D 20
SYTCUP_CALNREC 1E 1
SYTCUP_CALPTIS 1D 80
SYTCUP_CPUDATA 0 40
SYTCUP_END 28 0
SYTCUP_LCPTYPE 2C 16
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 1F 1
SYTCUP_LCUPNAME 14 8
SYTCUP_LCUPPNUM 1C 1
SYTCUP_LCUTCTOD 24 8
SYTCUP_LCXCCONL 4 20
SYTCUP_LCXCPTYP 16 16
SYTCUP_LCXPUPID 3C 1
SYTCUP_LCXPUPVA 1D 40
SYTCUP_MRHDR 0 0
This information is
based on z/VM V6R2.0.
Last updated on 09 Nov 2012 at 16:54:04.
Copyright IBM Corporation, 1990, 2012