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
Storage Layout
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 64-bit 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 Character 2 * 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_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_SYSZONE 50 4
This information is based on z/VM V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002