|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRSYS
PrologControl Block Contents
Cross Reference
MRMTRSYS Prolog
DSECT NAME - MTRSYS
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRMTRSYS
DESCRIPTIVE NAME - Monitor Sample Configuration Record
Domain 1 - Monitor Domain
Record 4 - System Configuration Data
DESCRIPTION - Identifies operating system and defines any
special processing capabilities.
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.
Bits will be added to MTRSYS_CALLEVEL for APARs
that introduce changes to Monitor that may be
ambiguous based on record length and release level.
These bits will be reset in a future release.
For additional information about the format and
meaning of the MTRSYS_STSI111 field, refer to the
following book:
- Principles of Operation for the layout of the
STSI 1.1.1 output (first 180 bytes) which is
documented in Chapter 10 under "STORE SYSTEM
INFORMATION". The field meanings are there also.
MRMTRSYS Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 420 MTRSYS Start of monitor record
0 0 Character 0 MTRSYS_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 Bitstring 8 MTRSYS_HCPCPEPP Program product bit map. This
is a CP internal indicator of
release level of the program
product. For the meaning of the
bit map, see the output
descriptions of Diagnose X'00'
in the CP Programming Services
manual.
28 1C Character 8 MTRSYS_HCPCPEID Version number, in EBCDIC
format. Byte 0 = release
number. Byte 1 = modification
level number. Bytes 2-3 =
version number. Bytes 4-7 =
service level.
36 24 Character 8 MTRSYS_SYSTODST TOD clock at last IPL
44 2C Character 8 MTRSYS_SYSTERM TOD clock at termination
52 34 Character 8 MTRSYS_SYSDATE Current date
60 3C Character 8 MTRSYS_SYSABNCD Abend code of last
termination
68 44 Unsigned 4 * Reserved for IBM use.
Previous field is no longer
meaningful. (MTRSYS_SYSVFCVM)
72 48 Unsigned 4 * Reserved for IBM use.
Previous field is no longer
meaningful. (MTRSYS_SYSVFIVM)
76 4C Unsigned 4 * Reserved for IBM use.
Previous field is no longer
meaningful. (MTRSYS_SYSVFOVM)
80 50 Unsigned 4 MTRSYS_SYSZONE TOD clock time zone facility
differential. Add this to a TOD
time stamp to get the local
time. The units here are
seconds.
84 54 Bitstring 1 MTRSYS_CALFLGS Miscellaneous Flags
1... .... MTRSYS_SYSMASFI ESA/370 hardware (Access
Registers) is installed
.1.. .... MTRSYS_CALADMF Asynchronous Data Mover
Installed
..1. .... MTRSYS_SYSDVACT Subchannel-Device-Active-Only
Measurement Protocol is
installed - this means that the
hardware is accumulating
device-active-only measurements
as opposed to CP calculating
them manually
...1 .... MTRSYS_SYSCPMF Channel Path Measurment
Facility (CPMF) is installed
.... 1... MTRSYS_SYSECPMF CPMF with extended channel
meas. is installed
.... .1.. MTRSYS_CALESAME The CP nucleus is a z/Arch
nucleus.
.... ..1. MTRSYS_SYSSI370 Interpretive execution of
S/370 guests is installed.
.... ...1 MTRSYS_SYSSTIOP Store I/O Processor
Utilization Data is available
85 55 Unsigned 1 MTRSYS_SYSVRFSG Preferred guest storage
granularity. The defined
storage size of each V=F guest
must be a multiple of this
number of megabytes
86 56 Bitstring 1 MTRSYS_CALFLG2 Miscellaneous Flags
1... .... MTRSYS_SYSXIOMB
Extended-I/O-measurement-block
facility is installed. This
means Device-Busy Time is being
stored in the measurement block
and format-1 measurement blocks
are being used.
.1.. .... MTRSYS_SYSMASST Collaborative Memory
Management Facility permitted.
Note: Even if this flag
indicates the Collaborative
Memory Management Facility is
off, some users may be using
CMM prior to it being turned
off. These users will be in
"active, pending off" state.
..1. .... MTRSYS_PFXACMM Collaborative Memory
Management Facility is
available. Note: If this flag
is off, any virtual machines
with VMDMAACT=1 are using the
CMM Facility as simulated by
VM.
...1 .... MTRSYS_SSI1TRNS Transient CCR and CAI.
.... 1... *
.... .1.. MTRSYS_CALNCPMF CPMF with the extended
channel measurement facility
is installed but due to the
Global Performance Data
setting on the HMC it cannot
be started.
.... ..1. *
.... ...1 *
87 57 Bitstring 1 MTRSYS_CALLEVEL Monitor service level
based on APARs available.
1... .... MTRSYS_LEVEL1 Reserved for IBM use.
.1.. .... MTRSYS_LEVEL2 Reserved for IBM use.
..1. .... MTRSYS_LEVEL3 Reserved for IBM use.
...1 .... MTRSYS_LEVEL4 Reserved for IBM use.
.... 1... MTRSYS_LEVEL5 Reserved for IBM use.
.... .1.. MTRSYS_LEVEL6 Reserved for IBM use.
.... ..1. MTRSYS_LEVEL7 Reserved for IBM use.
.... ...1 MTRSYS_LEVEL8 Reserved for IBM use.
88 58 Character 8 MTRSYS_SYSTMID System Identifier
96 60 Character 6 MTRSYS_SYSCKVOL The volume serial of the
Checkpoint volume.
102 66 Character 6 MTRSYS_SYSWMVOL The volume serial of the
Warmstart volume.
STSI 1.1.1 fields
Offsets
Dec Hex Type Len Name (Dim) Description
108 6C Character 4 MTRSYS_SYSMTYPE Machine Type number of the
configuration.
112 70 Character 16 MTRSYS_SYSMMODL Model-Capacity Identifier of
the configuration.
128 80 Character 16 MTRSYS_SYSMSEQC The sequence Code of the
configuration.
144 90 Character 4 MTRSYS_SYSMPOM Identifies the Plant of
manufacture for the
configuration.
STSI 2.2.2 fields Obtain STSI level-2 data when available. This
configuration data will indicate the configuration information for an
LPAR when available otherwise it will remain as default binary 0 values.
Offsets
Dec Hex Type Len Name (Dim) Description
148 94 Unsigned 2 MTRSYS_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.
150 96 Bitstring 1 MTRSYS_CPUCHAR Describes the characteristics
of the logical CPUs that are
provided for the level-2
configuration.
151 97 Bitstring 1 * RESERVED and available for
use
152 98 Unsigned 2 MTRSYS_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.
Secondary processors are not
included in this count.
154 9A Unsigned 2 MTRSYS_CPUCFGCT Specifies the number of
logical CPUs for this level-2
configuration that are in the
configured state. Secondary
processors are not included in
this count.
156 9C Unsigned 2 MTRSYS_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. Secondary
processors are not included in
this count.
158 9E Unsigned 2 MTRSYS_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.
Secondary processors are not
included in this count.
160 A0 Character 8 MTRSYS_LPARNAME Specified the name of this
level-2 configuration.
168 A8 Unsigned 4 MTRSYS_LPARCAF The LPAR Capability
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.
172 AC Unsigned 2 MTRSYS_CPUDEDCT Specifies the number of
configured state logical CPUs
for this level-2 configuration
that are provided using
dedicated level-1 CPUs
174 AE Unsigned 2 MTRSYS_CPUSHARD Specifies the number of
configured state logical CPUs
for this level-2 configuration
that are provided using shared
level-1 CPUs.
176 B0 Unsigned 4 MTRSYS_CPUCAPAB The capability of a CPU in
the configuration. The lower
the value, the higher the CPU
capacity. The value indicates
the capability of a CPU
relative to other CPU models.
This value applies to each of
the primary CPUs in the
configuration; all the primary
CPUs have the same capability.
180 B4 Unsigned 4 MTRSYS_SCPCAPAB The capability of a secondary
CPU in the configuration. The
value indicates the capability
of the CPU relative to the
capability of other CPU models
and also relative to the
capability of other CPU types
within a model. All CPUs in the
configuration of an applicable
type have the same capability.
When zero, all CPUs of any CPU
type in the configuration have
the same capability, as
specified by the CPU
capability, MTRSYS_CPUCAPAB.
184 B8 Bitstring 1 MTRSYS_SYSCMODE Processor Configuration Mode
Only one bit value may be set
at a time
1... .... *
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. MTRSYS_SYSCMESA ESA/390
.... ..1. MTRSYS_SYSCMLIN Linux-only
.... ...1 MTRSYS_SYSCMVM z/VM
185 B9 Unsigned 1 MTRSYS_SYSCCR Capacity-Change Reason from
STSI 1.1.1
186 BA Unsigned 1 MTRSYS_SYSCAI Capacity-Adjustment
Indication from STSI 1.1.1
187 BB Bitstring 1 * RESERVED and available for
use
188 BC Character 8 MTRSYS_STITODOF STP TOD clock offset
188 BC Character 4 MTRSYS_TODOFHI Hi-order half of TOD
192 C0 Character 4 MTRSYS_TODOFLO Lo-order half of TOD
196 C4 Bitstring 1 MTRSYS_SYSSTPFL STP configuration info
1... .... MTRSYS_SYSSTPEN STP Timestamping enabled in
the configuration file
.1.. .... MTRSYS_SYSSTPTZ STP Timezone usage enabled
in the configuration file
..1. .... MTRSYS_SYSSTPND XRC_OPTIONAL enabled in the
configuration file
...1 .... MTRSYS_SYSSTPTS XRC_TEST enabled in the
configuration file
.... 1... MTRSYS_SYSSTPAC STP is active
.... .1.. MTRSYS_SYSSTPSU STP is suspended
.... ..1. MTRSYS_SYSSTPMI STP suspension message has
been issued
.... ...1 *
197 C5 Bitstring 1 MTRSYS_SYSSTPF2 STP configuration info
1... .... MTRSYS_SYSSTPFI STP hardware feature is
installed
.1.. .... MTRSYS_SYSSTPFE STP hardware feature is
enabled
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
198 C6 Bitstring 2 * Reserved for IBM use
200 C8 Character 40 * Reserved for IBM use
240 F0 Character 180 MTRSYS_STSI111 First 180 bytes of the STSI
1.1.1 output.
420 1A8 Character 0 MTRSYS_END End of record
MRMTRSYS 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
MTRSYS 0 420
MTRSYS_CALADMF 54 40
MTRSYS_CALESAME 54 04
MTRSYS_CALFLGS 54 1
MTRSYS_CALFLG2 56 1
MTRSYS_CALLEVEL 57 1
MTRSYS_CALNCPMF 56 04
MTRSYS_CPUCAPAB B0 4
MTRSYS_CPUCFGCT 9A 2
MTRSYS_CPUCHAR 96 1
MTRSYS_CPUCOUNT 98 2
MTRSYS_CPUDEDCT AC 2
MTRSYS_CPURESVD 9E 2
MTRSYS_CPUSHARD AE 2
MTRSYS_CPUSTNBY 9C 2
MTRSYS_END 1A4 0
MTRSYS_HCPCPEID 1C 8
MTRSYS_HCPCPEPP 14 8
MTRSYS_LEVEL1 57 80
MTRSYS_LEVEL2 57 40
MTRSYS_LEVEL3 57 20
MTRSYS_LEVEL4 57 10
MTRSYS_LEVEL5 57 08
MTRSYS_LEVEL6 57 04
MTRSYS_LEVEL7 57 02
MTRSYS_LEVEL8 57 01
MTRSYS_LPARCAF A8 4
MTRSYS_LPARNAME A0 8
MTRSYS_LPNUMBER 94 2
MTRSYS_MRHDR 0 0
MTRSYS_PFXACMM 56 20
MTRSYS_SCPCAPAB B4 4
MTRSYS_SSI1TRNS 56 10
MTRSYS_STITODOF BC 8
MTRSYS_STSI111 F0 180
MTRSYS_SYSABNCD 3C 8
MTRSYS_SYSCAI BA 1
MTRSYS_SYSCCR B9 1
MTRSYS_SYSCKVOL 60 6
MTRSYS_SYSCMESA B8 04
MTRSYS_SYSCMLIN B8 02
MTRSYS_SYSCMODE B8 1
MTRSYS_SYSCMVM B8 01
MTRSYS_SYSCPMF 54 10
MTRSYS_SYSDATE 34 8
MTRSYS_SYSDVACT 54 20
MTRSYS_SYSECPMF 54 08
MTRSYS_SYSMASFI 54 80
MTRSYS_SYSMASST 56 40
MTRSYS_SYSMMODL 70 16
MTRSYS_SYSMPOM 90 4
MTRSYS_SYSMSEQC 80 16
MTRSYS_SYSMTYPE 6C 4
MTRSYS_SYSSI370 54 02
MTRSYS_SYSSTIOP 54 01
MTRSYS_SYSSTPAC C4 08
MTRSYS_SYSSTPEN C4 80
MTRSYS_SYSSTPFE C5 40
MTRSYS_SYSSTPFI C5 80
MTRSYS_SYSSTPFL C4 1
MTRSYS_SYSSTPF2 C5 1
MTRSYS_SYSSTPMI C4 02
MTRSYS_SYSSTPND C4 20
MTRSYS_SYSSTPSU C4 04
MTRSYS_SYSSTPTS C4 10
MTRSYS_SYSSTPTZ C4 40
MTRSYS_SYSTERM 2C 8
MTRSYS_SYSTMID 58 8
MTRSYS_SYSTODST 24 8
MTRSYS_SYSVRFSG 55 1
MTRSYS_SYSWMVOL 66 6
MTRSYS_SYSXIOMB 56 80
MTRSYS_SYSZONE 50 4
MTRSYS_TODOFHI BC 4
MTRSYS_TODOFLO C0 4
This information is
based on z/VM V5R4.0.
Last updated on 16 Aug 2011 at 15:14:41.
Copyright IBM Corporation, 1990, 2011