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