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