About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
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 V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005