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 * 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 .... * .... 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 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 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_PFXACMM 56 20 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_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_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
This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007