|
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 60 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.. .... *
..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 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. .... *
...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 60
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_MRHDR 0 0
This information is
based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003