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.

    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
      2   2  Unsigned     2  MRHDRZER
      4   4  Unsigned     1  MRHDRDM
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC
      8   8  Character    8  MRHDRTOD
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END
     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.. ....      *
              ..1. ....      *
              ...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        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  Unsigned     4  MTRSYS_CPUCAPAB        The capability of a CPU in
                                                    the configuration
    180  B4  Unsigned     4  MTRSYS_SCPCAPAB        The capability of a secondary
                                                    CPU in the configuration
    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_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_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 V5R2.0.

    Last updated on 11 Dec 2005 at 20:53:58.

    Copyright IBM Corporation, 1990, 2005