|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTCUG
PrologControl Block Contents
Cross Reference
MRSYTCUG Prolog
DSECT NAME - SYTCUG
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTCUG
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 15 - Logical CPU Utilization Data (Global)
DESCRIPTION - Global description of logical CPU utilization in
a LPAR environment. This record contains only data
of global nature and exists only when the system is
running under control of the PR/SM feature. For
descriptions of individual logical partitions and
their logical CPUs, see the MRSYTCUP (Domain 0,
Record 16) record.
NOTE: Data in the STSI fields is produced when the necessary
architecture is present for the STSI instruction.
When this is not present the field values will be 0's.
MRSYTCUG Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 56 SYTCUG Start of monitor record
0 0 Character 0 SYTCUG_MRHDR Record header
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 Unsigned 1 SYTCUG_LCUTNPAR Number of defined logical
partitions. Each logical
partition is described in a
separate record, MRSYTCUP
(Domain 0, Record 16).
21 15 Bitstring 1 SYTCUG_LCUTFLAG Flag byte
1... .... SYTCUG_LCUTPHYS LPAR management time
facility is available on this
system. Physical CPU
utilization data is provided
in MRSYTCUM (Domain 0, Record
17)
.1.. .... SYTCUG_LCUT204A Indicates enhanced LPAR
monitor support available.
The enhanced LPAR monitor
support allows for reporting
of large number of logical
processors and for the CPU
type reported in the
SYTCUP_LCPTYPE field of the
MRSYTCUP record (D0/R16).
..1. .... SYTCUG_LCUT204S Indicates the storage
page(s) required to obtain
the enhanced LPAR statistics
was unavailable for this
interval. The number of pages
required is based on the
number of LPARs and Logical
processors on the system.
These pages must be
contiguous. This indicates
that data may not be reported
for all logical CPUs.
...1 .... SYTCUG_LCUT204E Indicates enhanced LPAR
monitor support available as
described for SYTCUG_LCUT204S
with the addition of support
for secondary processors such
as zIIPs, zAAPS, IFLs, and
ICFs.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
22 16 Character 2 * Reserved for IBM use
24 18 Unsigned 2 SYTCUG_LCUTSLCE Global time slice, in
milliseconds, if defined by
operator. Otherwise, zero.
26 1A Unsigned 2 SYTCUG_LCUTPCCT Number of CPUs in the
physical system, or in the
physical partition if the
system is running in
physically partitioned mode.
Includes secondary processors
if SYTCUG_LCUT204E is on
***********************
STSI 2.2.2 fields
Offsets
Dec Hex Type Len Name (Dim) Description
28 1C Unsigned 2 SYTCUG_LPNUMBER LPAR Number of the level-2
configuration. This number is
unique to this configuration
from all other level-2
configurations provided by
the same LPAR hypervisor.
30 1E Character 1 * Reserved and available for
IBM use.
31 1F Bitstring 1 SYTCUG_CPUCHAR Describes the
characteristics of the
logical CPUs that are
provided for the level-2
configuration.
32 20 Unsigned 2 SYTCUG_CPUCOUNT Specifies the total number
of logical CPUs that are
provided for this level-2
configuration. This number
includes all of the logical
CPUs that are in the
configured state, the standby
state, or the reserved state.
Count does not include any
secondary processors
34 22 Unsigned 2 SYTCUG_CPUCFGCT Specifies the number of
logical CPUs for this level-2
configuration that are in the
configured state. Count does
not include any secondary
processors
36 24 Unsigned 2 SYTCUG_CPUSTNBY Specifies the number of
logical CPU's for this
level-2 configuration that
are in the standby state. A
logical CPU is in the standby
state when it is in the
level-2 configuration, is not
available to be used to
execute programs, and can be
made available by issuing
instructions to place it in
the configured state. Count
does not include any
secondary processors
38 26 Unsigned 2 SYTCUG_CPURESVD Specifies the number of
logical CPU's for this
level-2 configuration that
are in the reserved state. A
logical CPU is in the
reserved state when it is in
the level-2 configuration, is
not available to be used to
execute programs, and cannot
be made available by issuing
instructions to place it in
the configured state. Count
does not include any
secondary processors
40 28 Character 8 SYTCUG_LPARNAME Specified the name of this
level-2 configuration.
48 30 Unsigned 4 SYTCUG_LPARCAF The LPAR Capabiltiy
Adjustment Factor specifies
the amount of the underlying
level-1 configuration
capability that is allowed to
be used for this level-2
configuration by the LPAR
hypervisor. The maximum value
is 1000, and the fraction of
level-1 configuration
capability is determined by
dividing the CAF value by
1000.
52 34 Unsigned 2 SYTCUG_CPUDEDCT Specifies the number of
configured state logical CPUs
for this level-2
configuration that are
provided using dedicated
level-1 CPUs
54 36 Unsigned 2 SYTCUG_CPUSHARD Specifies the number of
configured state logical CPUs
for this level-2
configuration that are
provided using shared level-1
CPUs.
56 38 Character 0 SYTCUG_END
MRSYTCUG 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
SYTCUG 0 56
SYTCUG_CPUCFGCT 22 2
SYTCUG_CPUCHAR 1F 1
SYTCUG_CPUCOUNT 20 2
SYTCUG_CPUDEDCT 34 2
SYTCUG_CPURESVD 26 2
SYTCUG_CPUSHARD 36 2
SYTCUG_CPUSTNBY 24 2
SYTCUG_END 38 0
SYTCUG_LCUTFLAG 15 1
SYTCUG_LCUTNPAR 14 1
SYTCUG_LCUTPCCT 1A 2
SYTCUG_LCUTPHYS 15 80
SYTCUG_LCUTSLCE 18 2
SYTCUG_LCUT204A 15 40
SYTCUG_LCUT204E 15 10
SYTCUG_LCUT204S 15 20
SYTCUG_LPARCAF 30 4
SYTCUG_LPARNAME 28 8
SYTCUG_LPNUMBER 1C 2
SYTCUG_MRHDR 0 0
This information is
based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011