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

#### MRMTRTOP

Prolog
Control Block Contents
Cross Reference

#### MRMTRTOP Prolog

####

####

     DSECT NAME - MTRTOP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRTOP
     DESCRIPTIVE NAME - Monitor Configuration Record
                        Domain  1 - Monitor Domain
                        Record 26 - System Topology
     DESCRIPTION - Provides System Topology counts and
                   STSI 15.1.x output.
     NOTES -
         1. The system topology monitor records are identical
            and need to stay that way. The identical records
            are MRPRCTOP (D5R14) and MRMTRTOP (D1R26).
         2. For additional information about the format and meaning
            of fields defined in this record (especially the
            MTRTOP_STSI field), refer to the following books:
              - Principles of Operation for the layout of the
                variable length STSI 15.1.x output which is
                documented in Chapter 10 under "STORE SYSTEM
                INFORMATION".  Anyone looking at the STSI data
                in this record should read about the format of
                the data and the CPU Topology Overview contained
                there. (SA22-7832-08)

    MRMTRTOP Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    36  MTRTOP                 Start of monitor record
       0   0  Character     0  MTRTOP_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  Unsigned      2  MTRTOP_STSIOFF         Offset to STSI 15.1.x
                                                      output
      22  16  Unsigned      2  MTRTOP_STSILEN         Length of STSI 15.1.x
                                                      output in this monitor record
      24  18  Bitstring     1  MTRTOP_PCCMNEST        Maximum MNest value from
                                                      the RSCP Information response
      25  19  Bitstring     1  MTRTOP_RCCMNEST        The selector-2 (x) value
                                                      used for the STSI 15.1.x
                                                      output.
      26  1A  Unsigned      2  *                      Reserved for IBM Use
      28  1C  Unsigned      4  MTRTOP_RCCTOPPL        Cumulative number of times
                                                      CP checked for system
                                                      topology changes via PTF FC
                                                      2.
      32  20  Unsigned      4  MTRTOP_RCCTOPCH        Cumulative number of times
                                                      CP updated the system
                                                      topology because it changed
                                                      (ie: the PTF FC 2 returned
                                                      CC=1).
      36  24  Character     0  MTRTOP_STSI            STSI 15.1.x output. This
                                                      section is variable length.
                                                      MTRTOP_STSIOFF and
                                                      MTRTOP_STSILEN should always
                                                      be used to determine the byte
                                                      offset of this field in the
                                                      record and the byte length of
                                                      this field.

    MRMTRTOP 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
    MTRTOP                     0     36
    MTRTOP_MRHDR               0      0
    MTRTOP_PCCMNEST           18      1
    MTRTOP_RCCMNEST           19      1
    MTRTOP_RCCTOPCH           20      4
    MTRTOP_RCCTOPPL           1C      4
    MTRTOP_STSI               24      0
    MTRTOP_STSILEN            16      2
    MTRTOP_STSIOFF            14      2

    This information is
    based on z/VM V6R1.0.

    Last updated on 10 Apr 2012 at 13:00:13.

    Copyright IBM Corporation, 1990, 2012