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. For alternate
                                                  processors, the size of the
                                                  trace table is a percentage
                                                  of this value as reported in
                                                  MTRMEM_SYSTRCPC.
  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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011