|
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
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 144 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 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 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 Unsigned 4 SYTSYG_SCPCAPAB STSI 1.2.2 field.
The capability of a secondary
CPU in the configuration.
When zero,
all CPUs of any CPU type in
the configuration have the
same capability, as specified
by the CPU capability,
SYTSYG_CPUCAPAB.
In integer format.
60 3C Unsigned 4 SYTSYG_CPUCAPAB STSI 1.2.2 field.
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.
In integer format.
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 Unsigned 4 SYTSYG_MAI_MISS Count of Missing Adapter
Interruptions
116 74 Unsigned 4 SYTSYG_MAI_UREC Count of unrecoverable
Adapter Interruptions
120 78 Unsigned 4 SYTSYG_NCPCAPAB STSI 1.2.2 field.
The nominal capability of a
CPU in the configuration
When zero, this means the
system is not operating at
reduced speed, so the
primary capability,
SYTSYG_CPUCAPAB, value applies.
In integer format.
124 7C Unsigned 4 SYTSYG_FXRDONE Number of times zHPF DCW
translation processing completed
successfully for a DASD device.
128 80 Unsigned 4 SYTSYG_FXRWRITE Number of times a write
channel program for a DASD
device was presented for zHPF
DCW translation.
132 84 Unsigned 4 SYTSYG_RCCSCAPF STSI 1.2.2 field.
The capability of a secondary
CPU in the configuration.
When zero,
all CPUs of any CPU type in
the configuration have the
same capability, as specified
by the CPU capability,
SYTSYG_RCCCCAPF.
In Binary Floating Point
format.
136 88 Unsigned 4 SYTSYG_RCCCCAPF STSI 1.2.2 field.
Specifies the capability
of each primary CPU in the
current configuration. Used as
an indication of the capability
of the CPU relative to the
capability of other CPU models.
In BFP format
140 8C Unsigned 4 SYTSYG_RCCNCAPF STSI 1.2.2 field.
The nominal capability of a
CPU in the configuration.
When zero, this means the
system is not operating at
reduced speed, so the
primary capability,
SYTSYG_RCCCCAPF, value applies.
In BFP format.
144 90 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 144
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 84 0
SYTSYG_FTRABORT 20 4
SYTSYG_FTRDONE 1C 4
SYTSYG_FTRNOTEL 24 4
SYTSYG_FTRWRITE 28 4
SYTSYG_FXRDONE 7C 4
SYTSYG_FXRWRITE 80 4
SYTSYG_MAI_MISS 70 4
SYTSYG_MAI_UREC 74 4
SYTSYG_MRHDR 0 0
SYTSYG_NCPCAPAB 78 4
SYTSYG_RCCCCAPF 88 4
SYTSYG_RCCNCAPF 8C 4
SYTSYG_RCCSCAPF 84 4
SYTSYG_SCPCAPAB 38 4
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 V6R2.0.
Last updated on 13 Feb 2015 at 21:17:04.
Copyright IBM Corporation, 1990, 2015