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  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 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  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
                                                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 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        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    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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004