|
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
Storage Layout
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
2 2 Unsigned 2 MRHDRZER
4 4 Unsigned 1 MRHDRDM
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC
8 8 Character 8 MRHDRTOD
16 10 Character 4 *
20 14 Character 0 MRHDR_END
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.. .... *
..1. .... *
...1 .... *
.... 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.
***********************
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.
34 22 Unsigned 2 SYTCUG_CPUCFGCT Specifies the number of logical
CPUs for this level-2
configuration that are in the
configured state.
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.
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.
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_LPARCAF 30 4
SYTCUG_LPARNAME 28 8
SYTCUG_LPNUMBER 1C 2
SYTCUG_MRHDR 0 0
This information is
based on z/VM V4R3.0.
Last updated on 3 May 2002 at 09:43:14.
Copyright IBM Corporation, 1990, 2002