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 APAR VM64798 is available. .1.. .... MTRSYS_LEVEL2 APAR VM64794 is available. ..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 Unsigned 1 MTRSYS_SYSESTAT Ensemble status X'00' Unavailable X'01' Disabled by CP X'02' Waiting for SMAPI server X'03' Disabled by SMAPI server X'80' Ensemble member 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 1A4 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_SYSESTAT BB 1 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 V6R1.0.
Last updated on 16 Aug 2011 at 15:23:13.
Copyright IBM Corporation, 1990, 2011