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