|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTSYG
PrologControl Block Contents
Storage Layout
Cross Reference
MRSYTSYG Prolog
DSECT NAME - SYTSYG
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTSYG
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 19- System Data (Global)
DESCRIPTION - System wide utilization data.
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.
MRSYTSYG Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 112 SYTSYG Start of monitor record
0 0 Character 0 SYTSYG_MRHDR Record header. See MRRECHDR for
details.
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 Character 8 SYTSYG_XCTMSACT Accumulated elapsed time in
microseconds that routines that
comprise user exits were active
28 1C Unsigned 4 SYTSYG_FTRDONE Number of times fast CCW
translation processing completed
successfully for a DASD device.
32 20 Unsigned 4 SYTSYG_FTRABORT Number of times fast CCW
translation processing was aborted
for a DASD device.
36 24 Unsigned 4 SYTSYG_FTRNOTEL Number of times a presented CCW
for a DASD device was not eligible
for fast CCW translation. There
are cases where ineligibility may
have been determined before the
CCW is presented to the fast path
simulator. Those cases are not
counted here.
40 28 Unsigned 4 SYTSYG_FTRWRITE Number of times a write channel
program for a DASD device was
presented for fast CCW
translation.
44 2C Unsigned 4 SYTSYG_CTNDONE Number of times fast CCW
translation processing completed
successfully for a network device.
48 30 Unsigned 4 SYTSYG_CTNABORT Number of times fast CCW
translation processing was aborted
for a network device.
52 34 Unsigned 4 SYTSYG_CTNNOTEL Number of times a presented CCW
for a network device was not
eligible for fast CCW translation.
There are cases where
ineligibility may have been
determined before the CCW is
presented to the fast path
simulator. Those cases are not
counted here.
***********************
STSI 1.2.2 fields
Offsets
Dec Hex Type Len Name (Dim) Description
56 38 Character 4 * Reserved and available for IBM
use.
60 3C Unsigned 4 SYTSYG_CPUCAPAB Specifies the capability of one
of the CPUs in the current
configuration. Used as an
indication of the capability of
the CPU relative to the capability
of other CPU models. This value
applies to each of the CPUs in
this configuration.
64 40 Unsigned 2 SYTSYG_CPUCOUNT The Total number of CPUs in the
configuration. Includes all CPUs
in the configured, standby, andthe
reserved state.
66 42 Unsigned 2 SYTSYG_CPUCFGCT Specifies the number of CPUs in
the configured state. A CPU is in
the configured state when it is in
the configuration and available to
be used to execute programs.
68 44 Unsigned 2 SYTSYG_CPUSTNBY Specifies the number of CPUs in
the standby state. A CPU is in the
standby state when it is in the
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.
70 46 Unsigned 2 SYTSYG_CPURESVD Specifies the number of CPUs in
the reserved state. A CPU is in
the reserved state when it is in
the 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. ***********************
STSI 3.2.2 fields This information is level-3 from a VMDBK if available.
Offsets
Dec Hex Type Len Name (Dim) Description
72 48 Unsigned 1 SYTSYG_VL3DBCT Specifies the number of VM
levels running between the level
at which this data was collected
and the hardware. For example,
data collected from a VM system
running second level would show a
value of 1. A third level system
would show a value of 2.
73 49 Character 1 * Reserved and available for IBM
use.
74 4A Unsigned 2 SYTSYG_VL3COUNT The Total number of Logical CPUs
that are provided for this level-3
configuration. Includes all of the
logical CPUs that are in the
configured, standby, and the
reserved state.
76 4C Unsigned 2 SYTSYG_VL3CFGCT Specifies the number of logical
CPUs for this level-3
configuration that are in the
configured state. A logical CPU is
in the configured state when it is
in the level-3 configuration and
available to be used to execute
programs.
78 4E Unsigned 2 SYTSYG_VL3STNBY Specifies the number of logical
CPUs for this level-3
configuration that are in the
standby state. A logical CPU is in
the standby state when it is in
the level-3 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.
80 50 Unsigned 2 SYTSYG_VL3RESVD Specifies the number of logical
CPUs for this level-3
configuration that are in the
reserved state. A logical CPU is
in the reserved state when it is
in the level-3 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.
82 52 Character 2 * Reserved and available for IBM
use.
84 54 Character 8 SYTSYG_VL3MNAME Specifies the name of this
level-3 configuration.
92 5C Unsigned 4 SYTSYG_VL3CAF The Capabiltiy Adjustment Factor
specifies the amount of the
underlying level-1, level-2 or
level-3 configuration capability
that is allowed to be used for
this level-3 configuration by the
virtual machine control program.
The maximum value is 1000, and the
fraction of level-3 configuration
capability is determined by
dividing the CAF value by 1000.
96 60 Character 16 SYTSYG_VL3CPNAM Identifies the virtual machine
control program that provides this
level-3 configuration. This may
include qualifiers such as version
number and release level.
112 70 Character 0 SYTSYG_END
MRSYTSYG 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
SYTSYG 0 112
SYTSYG_CPUCAPAB 3C 4
SYTSYG_CPUCFGCT 42 2
SYTSYG_CPUCOUNT 40 2
SYTSYG_CPURESVD 46 2
SYTSYG_CPUSTNBY 44 2
SYTSYG_CTNABORT 30 4
SYTSYG_CTNDONE 2C 4
SYTSYG_CTNNOTEL 34 4
SYTSYG_END 70 0
SYTSYG_FTRABORT 20 4
SYTSYG_FTRDONE 1C 4
SYTSYG_FTRNOTEL 24 4
SYTSYG_FTRWRITE 28 4
SYTSYG_MRHDR 0 0
SYTSYG_VL3CAF 5C 4
SYTSYG_VL3CFGCT 4C 2
SYTSYG_VL3COUNT 4A 2
SYTSYG_VL3CPNAM 60 16
SYTSYG_VL3DBCT 48 1
SYTSYG_VL3MNAME 54 8
SYTSYG_VL3RESVD 50 2
SYTSYG_VL3STNBY 4E 2
SYTSYG_XCTMSACT 14 8
This information is
based on z/VM V4R3.0.
Last updated on 3 May 2002 at 09:43:04.
Copyright IBM Corporation, 1990, 2002