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

#### MRMTRMEM

Prolog
Control Block Contents
Cross Reference

#### MRMTRMEM Prolog

####

####

     DSECT NAME - MTRMEM
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRMEM
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1 - Monitor Domain
                        Record 7 - Memory Configuration Data
     DESCRIPTION - Defines the real memory configuration of the
                   processor complex and the operating system.

    MRMTRMEM Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  160  MTRMEM                 Start of monitor record
      0   0  Character    0  MTRMEM_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     4  MTRMEM_RSASTORE        Cardinal count of actual real
                                                    storage size, in bytes,
                                                    calculated during system
                                                    initialization. This field is
                                                    kept for compatability and may
                                                    not be accurate for z/Arch
                                                    systems. The preferred field is
                                                    MTRMEM_RSAGSTOR.
     24  18  Unsigned     4  MTRMEM_SYSTORS         Storage size of the real
                                                    machine (sysgenned storage) in
                                                    bytes. This field is kept for
                                                    compatability and may not be
                                                    accurate for z/Arch systems.
                                                    The preferred field is
                                                    MTRMEM_SYSGTORS.
     28  1C  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (MTRMEM_SYSVRSZ)
     32  20  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (MTRMEM_SYSVRFRE)
     36  24  Unsigned     4  MTRMEM_SYSTRAC         Cardinal count of frames that
                                                    are used for CP trace pages for
                                                    the master processor. Count
                                                    applies to both alternate and
                                                    secondary processors.
     40  28  Address      4  MTRMEM_HCPMM1          Address of the Marker module
                                                    to mark the start of the
                                                    resident executable modules
     44  2C  Address      4  MTRMEM_HCPMM4          Address of the Marker module
                                                    to mark the boundary between
                                                    resident and pageable modules.
                                                    But since we have no more
                                                    Pageable modules, this
                                                    effectively marks the end of
                                                    the executable nucleus.
                                                    However, HCPMM3 officially
                                                    provides the "end of nucleus"
                                                    marker and should continue to
                                                    be used for that purpose.
     48  30  Unsigned     4  MTRMEM_RSAPGABL        Cardinal count of <2G
                                                    pageable frames in the system.
                                                    This includes those that had
                                                    been made non-pageable (see
                                                    MTRMEM_RSANONPG). The size of
                                                    the dynamic area (DPA) or the
                                                    count of useable frames may be
                                                    calculated by subtracting
                                                    RSANONPG from RSAPGABL. See
                                                    MTRMEM_RSALGFRM for the >2G
                                                    field for the count of useable
                                                    frames. NOTE: There is no
                                                    separate count for pageable
                                                    frames (RSAPAGBL) and frames
                                                    made non-pageable (RSANONPG)
                                                    >2G.
     52  34  Unsigned     4  MTRMEM_RSANONPG        Cardinal count of <2G
                                                    pageable frames in the system
                                                    that have been made
                                                    non-pageable. This includes
                                                    pages locked for I/O, CP LOCK
                                                    command, virtual system lock
                                                    functions, etc. See
                                                    MTRMEM_RSAPGABL and
                                                    MTRMEM_RSALGFRM.
     56  38  Unsigned     4  MTRMEM_RSAOFFLN        Cardinal count of off-line
                                                    frames <2G. See MTRMEM_RSAGOFFL
                                                    for the >2G value.
     60  3C  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (MTRMEM_RSARIOSZ)
     64  40  Unsigned     2  MTRMEM_SYSTRCPC        Percentage of master
                                                    processor trace table size to
                                                    be used for alternate
                                                    processors. Percentage applies
                                                    to secondary processors as
                                                    well.
     66  42  Bitstring    1  MTRMEM_FLG1            Flag byte
              1... ....      MTRMEM_RSAAASTA        Anti-aliasing status bit.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     67  43  Character    1  *                      Reserved for IBM use.
     68  44  Address      4  MTRMEM_HCPMM0          Address of the Marker module
                                                    to mark the start of resident
                                                    MP modules.
     72  48  Address      4  MTRMEM_HCPSYS          Address of the HCPSYS module
                                                    which is the start of the
                                                    resident CP nucleus.
     76  4C  Unsigned     4  MTRMEM_CALSCMAX        When MTRSYS_CALFLG2 <> x'80'
                                                    (format-0 measurement blocks),
                                                    this is the total number of
                                                    SCMBKs contained in the
                                                    contiguous storage set aside
                                                    for the SCMBK area. When When
                                                    MTRSYS_CALFLG2 = x'80'
                                                    (format-1 measurement blocks),
                                                    this is the total number of
                                                    SCGBKs allocated.
     80  50  Unsigned     4  MTRMEM_SYSSCMEX        Number of extra pages
                                                    requested for the SCMBK area in
                                                    the system config file.
     84  54  Character    8  MTRMEM_SYSGTORS        The sysgen specified storage
                                                    size minus 1 byte. This
                                                    includes storage above 2GB. The
                                                    minus one notation is used so
                                                    that a total size of 16
                                                    Exabytes may be represented
                                                    without ambiguity (as
                                                    x'FFFFFFFF_FFFFFFFF').
     92  5C  Character    8  MTRMEM_RSAGSTOR        The actual real storage size
                                                    minuz 1 byte. This is
                                                    calculated at system
                                                    initialization and includes
                                                    storage above 2GB. The minus
                                                    one notation is used so that a
                                                    total size of 16 Exabytes may
                                                    be represented without
                                                    ambiguity (as
                                                    x'FFFFFFFF_FFFFFFFF').
    100  64  Character    8  MTRMEM_RSAGOFFL        Cardinal count of off-line
                                                    frames >2G. See MTRMEM_RSAOFFLN
                                                    for the <2G value.
    108  6C  Character    8  MTRMEM_RSALGFRM        Cardinal count of >2G useable
                                                    frames. See MTRMEM_RSAPGABL and
                                                    MTRMEM_RSANONPG for the <2G
                                                    value.
    116  74  Unsigned     4  MTRMEM_SXSSIZE         System Execution Space size
                                                    in pages.
    120  78  Character    8  MTRMEM_PFXSTLEN        Length of the System
                                                    Execution Space page management
                                                    table.
    128  80  Character    8  MTRMEM_PFXFTLEN        Length of the frame table.
    136  88  Character    8  MTRMEM_RSAFNOTI        Count of the not initialized
                                                    FRMTEs >=2G.
    144  90  Character    8  MTRMEM_SYSGSTBY        The standby real storage size
                                                    in bytes
    152  98  Character    8  MTRMEM_SYSGSTRS        The reserved real storage
                                                    size in bytes
    160  A0  Character    0  MTRMEM_END

    MRMTRMEM 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
    MTRMEM                     0    160
    MTRMEM_CALSCMAX           4C      4
    MTRMEM_END                A0      0
    MTRMEM_FLG1               42      1
    MTRMEM_HCPMM0             44      4
    MTRMEM_HCPMM1             28      4
    MTRMEM_HCPMM4             2C      4
    MTRMEM_HCPSYS             48      4
    MTRMEM_MRHDR               0      0
    MTRMEM_PFXFTLEN           80      8
    MTRMEM_PFXSTLEN           78      8
    MTRMEM_RSAAASTA           42           80
    MTRMEM_RSAFNOTI           88      8
    MTRMEM_RSAGOFFL           64      8
    MTRMEM_RSAGSTOR           5C      8
    MTRMEM_RSALGFRM           6C      8
    MTRMEM_RSANONPG           34      4
    MTRMEM_RSAOFFLN           38      4
    MTRMEM_RSAPGABL           30      4
    MTRMEM_RSASTORE           14      4
    MTRMEM_SXSSIZE            74      4
    MTRMEM_SYSGSTBY           90      8
    MTRMEM_SYSGSTRS           98      8
    MTRMEM_SYSGTORS           54      8
    MTRMEM_SYSSCMEX           50      4
    MTRMEM_SYSTORS            18      4
    MTRMEM_SYSTRAC            24      4
    MTRMEM_SYSTRCPC           40      2

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

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009