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
Storage Layout
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  100  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 64-bit
                                                 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 64-bit
                                                 systems. The preferred field is
                                                 MTRMEM_SYSGTORS.
     28  1C  Unsigned     4  MTRMEM_SYSVRSZ      Cardinal count of size of V=R
                                                 area (excluding V=R reserved free
                                                 storage) in bytes. It is set to 0
                                                 if there is no V=R machine
                                                 defined, or set to the largest
                                                 value V=R address. It is set to 0
                                                 when the V=R area is unlocked if
                                                 the V=R user has logged off.
     32  20  Unsigned     4  MTRMEM_SYSVRFRE     Cardinal count of size of V=R
                                                 reserved free storage (including
                                                 the VMDBK) in bytes. It is set to
                                                 0 when the V=R area is unlocked if
                                                 there are no outstanding free
                                                 storage blocks. The sum of this
                                                 value and MTRMEM_SYSVRSZ gives the
                                                 total V=R size.
     36  24  Unsigned     4  MTRMEM_SYSTRAC      Cardinal count of frames that
                                                 are used for CP trace pages for
                                                 the master processor.
     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
     48  30  Unsigned     4  MTRMEM_RSAPGABL     Cardinal count of pageable
                                                 frames in the system. This
                                                 includes those that had been made
                                                 non-pageable (see
                                                 MTRMEM_RSANONPG). The size of the
                                                 dynamic area (DPA) may be
                                                 calculated by subtracting RSANONPG
                                                 from RSAPGABL.
     52  34  Unsigned     4  MTRMEM_RSANONPG     Cardinal count of 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.
     56  38  Unsigned     4  MTRMEM_RSAOFFLN     Cardinal count of off-line
                                                 frames.
     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
     66  42  Character    2  *                   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     Total number of SCMBKs contained
                                                 in the contiguous storage set
                                                 aside for the SCMBK area.
     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    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    100
    MTRMEM_CALSCMAX        4C      4
    MTRMEM_END             64      0
    MTRMEM_HCPMM0          44      4
    MTRMEM_HCPMM1          28      4
    MTRMEM_HCPMM4          2C      4
    MTRMEM_HCPSYS          48      4
    MTRMEM_MRHDR            0      0
    MTRMEM_RSAGSTOR        5C      8
    MTRMEM_RSANONPG        34      4
    MTRMEM_RSAOFFLN        38      4
    MTRMEM_RSAPGABL        30      4
    MTRMEM_RSASTORE        14      4
    MTRMEM_SYSGTORS        54      8
    MTRMEM_SYSSCMEX        50      4
    MTRMEM_SYSTORS         18      4
    MTRMEM_SYSTRAC         24      4
    MTRMEM_SYSTRCPC        40      2
    MTRMEM_SYSVRFRE        20      4
    MTRMEM_SYSVRSZ         1C      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