|
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.
MRMTRSYS Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 184 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 MTRSYS_SYSVFCVM Map of the connected vector
facility
72 48 Unsigned 4 MTRSYS_SYSVFIVM Map of the installed vector
facility
76 4C Unsigned 4 MTRSYS_SYSVFOVM Map of the operational vector
facility
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=R and
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.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
87 57 Character 1 * 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 Machine Model number 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.
154 9A Unsigned 2 MTRSYS_CPUCFGCT Specifies the number of
logical CPUs for this level-2
configuration that are in the
configured state.
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.
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.
160 A0 Character 8 MTRSYS_LPARNAME Specified the name of this
level-2 configuration.
168 A8 Unsigned 4 MTRSYS_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.
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
180 B4 Unsigned 4 MTRSYS_SCPCAPAB The capability of a secondary
CPU in the configuration
184 B8 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 184
MTRSYS_CALADMF 54 40
MTRSYS_CALESAME 54 04
MTRSYS_CALFLGS 54 1
MTRSYS_CALFLG2 56 1
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 B8 0
MTRSYS_HCPCPEID 1C 8
MTRSYS_HCPCPEPP 14 8
MTRSYS_LPARCAF A8 4
MTRSYS_LPARNAME A0 8
MTRSYS_LPNUMBER 94 2
MTRSYS_MRHDR 0 0
MTRSYS_SCPCAPAB B4 4
MTRSYS_SYSABNCD 3C 8
MTRSYS_SYSCKVOL 60 6
MTRSYS_SYSCPMF 54 10
MTRSYS_SYSDATE 34 8
MTRSYS_SYSDVACT 54 20
MTRSYS_SYSECPMF 54 08
MTRSYS_SYSMASFI 54 80
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_SYSTERM 2C 8
MTRSYS_SYSTMID 58 8
MTRSYS_SYSTODST 24 8
MTRSYS_SYSVFCVM 44 4
MTRSYS_SYSVFIVM 48 4
MTRSYS_SYSVFOVM 4C 4
MTRSYS_SYSVRFSG 55 1
MTRSYS_SYSWMVOL 66 6
MTRSYS_SYSXIOMB 56 80
MTRSYS_SYSZONE 50 4
This information is
based on z/VM V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004