|
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 176 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 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 176
MTRSYS_CALADMF 54 40
MTRSYS_CALESAME 54 04
MTRSYS_CALFLGS 54 1
MTRSYS_CALFLG2 56 1
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 B0 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_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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003