|
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.
-- 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. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
30 1E Unsigned 1 SYTCUP_LCUPCPCT Number of logical CPUs in
this partition. This also is
the number of SYTCUP_CPUDATA
entries in the record. If zero,
this partition is not active.
31 1F Character 1 * Reserved for IBM use
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.
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 22 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.
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_CALPTIS 1D 80
SYTCUP_CPUDATA 0 22
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 1E 1
SYTCUP_LCUPNAME 14 8
SYTCUP_LCUPPNUM 1C 1
SYTCUP_LCUTCTOD 24 8
SYTCUP_LCXCCONL 4 20
SYTCUP_LCXPUPID 3C 1
SYTCUP_LCXPUPVA 1D 40
SYTCUP_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