Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRMTRSYS

Prolog
Control 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