|
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 LP AR.
When OFF, indicates th is is
the only or last MRSYT CUP
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 e ach
logical CPU in the par tition.
For the total number o f
logical CPUs in the pa rtition
see SYTCUP_LCUPCPCT.
31 1F Unsigned 1 SYTCUP_LCUPCPCT Total number of logical
CPUs in this partition . If
zero, this partition i s not
active. Includes secon dary
processors if SYTCUG_L CUT204E
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 V5R4.0.
Last updated on 9 Nov 2012 at 17:27:41.
Copyright IBM Corporation, 1990, 2012