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   326  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
   2   2  Unsigned      2  MRHDRZER
   4   4  Unsigned      1  MRHDRDM
   5   5  Unsigned      1  *
   6   6  Unsigned      2  MRHDRRC
   8   8  Character     8  MRHDRTOD
  16  10  Character     4  *
  20  14  Character     0  MRHDR_END
  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        Last addressable 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  Unsigned      8  MTRMEM_PFXFTLEN
 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  Unsigned      4  MTRMEM_RSACKMB2G       Count of CP frames below 2G
                                                  allocated as stand-alone dump
                                                  crashkernel memory. The count
                                                  is not included in RSADmpCP.
                                                  This field is only updated
                                                  during system init.
 164  A4  Unsigned      4  MTRMEM_RSACKMA2G       Count of CP frames above 2G
                                                  allocated as stand-alone dump
                                                  crashkernel memory. The count
                                                  is not included in RSADmpCP.
                                                  This field is only updated
                                                  during system init.
 168  A8  Character     8  MTRMEM_RSAPIN0B        Cardinal count of the
                                                  system total pinned pages
                                                  class 0 below 2G
 176  B0  Character     8  MTRMEM_RSAPIN0A        Cardinal count of the
                                                  system total pinned pages
                                                  class 0 above 2G
 184  B8  Character     8  MTRMEM_RSAPIN1B        Cardinal count of the
                                                  system total pinned pages
                                                  class 1 below 2G
 192  C0  Character     8  MTRMEM_RSAPIN1A        Cardinal count of the
                                                  system total pinned pages
                                                  class 1 above 2G
 200  C8  Unsigned      4  MTRMEM_RSAPINWP        Cardinal percent of the
                                                  total pinned page count
                                                  compared to the DPA that
                                                  causes a warning message when
                                                  a pin request is made.
 204  CC  Unsigned      4  MTRMEM_RSAPINFP        Cardinal percent of the
                                                  total pinned page count
                                                  compared to the DPA that
                                                  causes a pin request to to
                                                  fail.
 208  D0  Character     8  MTRMEM_RSAIOUSD        Cardinal current usage in
                                                  BYTES of the IOAT subpool
                                                  storage.
 216  D8  Unsigned      4  MTRMEM_RSAIOSIZE       Cardinal size in MB of of
                                                  the IOAT subpool.
 220  DC  Unsigned      4  MTRMEM_RSAIOWRNP       Cardinal percent of the
                                                  IOAT subpool current usage
                                                  compared to the size when a
                                                  warning message is issued.
 224  E0  Unsigned      2  MTRMEM_SYSHPIOM        Maximum number of
                                                  concurrent I/O requests to a
                                                  paging volume
 226  E2  Unsigned      1  MTRMEM_SYSHPFLG        HyperPAV paging flags
          1... ....        MTRMEM_SYSFHPAV        HyperPAV aliases are
                                                  enabled for the paging
                                                  subsystem
          .1.. ....        MTRMEM_SYSFHPF         The High Performance FICON
                                                  is enabled for the paging
                                                  subsytem
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1                               Reserved and unavailable
                                                  for use. Formerly
                                                  MTRMEM_SYSPG63.
 227  E3  Bitstring     1  MTRMEM_RSAAGEFL        Global Aging List flags
          1... ....        MTRMEM_RSAAGEFX        The Aging List is a fixed
                                                  size.
          .1.. ....        *
          ..1. ....        MTRMEM_RSAAGEEW        Early Writes are enabled.
                                                  Page content is backed up in
                                                  advance of frame reclaim to
                                                  maintain a pool of readily
                                                  reclaimable frames.
          ...1 ....        MTRMEM_RSAAGEKS        Keep slot is enabled. The
                                                  auxiliary slot to which a
                                                  page was written during frame
                                                  replenishment remains
                                                  allocated after the page is
                                                  read into central storage.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 228  E4  Bitstring     1  MTRMEM_RSAIPLST        Flags to identify the
                                                  source of the storage
                                                  configuration specific- ation
                                                  at the last start of the
                                                  system.
          1... ....        MTRMEM_RSASTEQL        Obtained from the IPL
                                                  Parameter STORE=.
          .1.. ....        MTRMEM_RSASYSCF        Obtained frm the STORAGE
                                                  PERMANENT and/or STORAGE
                                                  RECONFIGURABLE config
                                                  statement(s).
          ..1. ....        MTRMEM_RSANONE         No explicit storage
                                                  configuration data was
                                                  provided on the IPL parameter
                                                  STORE= or the STORAGE
                                                  configuration statement. In
                                                  this case, CP brings online,
                                                  as permanent, the amount of
                                                  storage already configrd to
                                                  partition at IPL
          ...1 ....        MTRMEM_RSAKEEP         Storage configuration was
                                                  restored to the values in
                                                  effect at the previous system
                                                  termination. This bit can be
                                                  set only if MTRMEM_RSAABEND
                                                  or MTRMEM_RSASHUT is also
                                                  set.
          .... 1...        MTRMEM_RSAABEND        CP restarted itself after
                                                  an ABEND (includes PSW
                                                  RESTART).
          .... .1..        MTRMEM_RSASHUT         CP was restarted by the
                                                  operator's issuance of the CP
                                                  SHUTDOWN command with the
                                                  REIPL operand
          .... ..1.        MTRMEM_RSASYSIPL       CP was started by the
                                                  operator at the system
                                                  console
          .... ...1        *
 229  E5  Character     3  *                      Reserved for IBM use
 232  E8  Unsigned      8  MTRMEM_DSRUSIZEB       The effective storage
                                                  increment size. Storage can
                                                  be added or removed from the
                                                  configuration in multiples of
                                                  this size
 240  F0  Unsigned      8  MTRMEM_RSAPZONESACTIVEB2G Number of available
                                                  list zones in storage < 2G.
 248  F8  Unsigned      8  MTRMEM_RSAPZONESACTIVEA2G Number of available
                                                  list zones in storage < 2G.
 256 100  Unsigned      8  MTRMEM_RSARZONESACTIVEA2G Number of
                                                  (reconfig) available list
                                                  zones in storage >2G.
 264 108  Unsigned      8  MTRMEM_SYSPERMA        Amount of perm storage in
                                                  bytes that is currently
                                                  online.
 272 110  Unsigned      8  MTRMEM_SYSRECNF        Amount of reconfigurable
                                                  storage in bytes that is
                                                  currently online.
 280 118  Unsigned      8  MTRMEM_RSASTPRM        Amount of perm storage in
                                                  bytes that was specified on
                                                  the STORAGE PERM system
                                                  config statement.
 288 120  Unsigned      8  MTRMEM_RSASTRCF        Amount of reconfigurable
                                                  storage in bytes that was
                                                  specified on the STORAGE
                                                  RECONF system config
                                                  statement.
 296 128  Unsigned      8  MTRMEM_RSARQPRM        Amount of permanent storage
                                                  in bytes that was requested
                                                  at IPL.This field will be
                                                  zero when no storage
                                                  configuration data was
                                                  provided on the STORAGE
                                                  statement in the system
                                                  configuration file or via the
                                                  IPL parameter
                                                  STORE=(MTRMEM_RSASTEQL = 1),
                                                  or it is an automatic restart
                                                  and the storage configuration
                                                  was kept from the previous
                                                  IPL (MTRMEM_RSAKEEP = 1).
 304 130  Unsigned      8  MTRMEM_RSARQRCF        Amount of reconfigurable
                                                  storage in bytes that was
                                                  requested at IPL.This field
                                                  will be zero when no storage
                                                  configuration data was
                                                  provided on the STORAGE
                                                  statement in the system
                                                  configuration file or via the
                                                  IPL parameter
                                                  STORE=(MTRMEM_RSASTEQL = 1),
                                                  or it is an automatic restart
                                                  and the storage configuration
                                                  was kept from the previous
                                                  IPL (MTRMEM_RSAKEEP = 1).
 312 138  Unsigned      8  MTRMEM_RSAACPRM        Amount of perm storage in
                                                  bytes that was init- ialized
                                                  at IPL.
 320 140  Unsigned      8  MTRMEM_RSAACRCF        Amount of reconfigurable
                                                  storage in bytes that was
                                                  initialized at IPL
 328 148  Unsigned      1  MTRMEM_SALWRNCF        Current value of the
                                                  paging-warning percent
                                                  established by the PAGING
                                                  WARNING system configuration
                                                  statement or a previous SET
                                                  PAGING WARNING cmd.
                                                  MTRMRM_SALPGWRN has been
                                                  deprecated.
 329 149  Character     3  *
 332 14C  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    326
MTRMEM_CALSCMAX           4C      4
MTRMEM_DSRUSIZEB          E8      8
MTRMEM_END               14C      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_RSAABEND           E4           08
MTRMEM_RSAACPRM          138      8
MTRMEM_RSAACRCF          140      8
MTRMEM_RSAAGEEW           E3           20
MTRMEM_RSAAGEFL           E3      1
MTRMEM_RSAAGEFX           E3           80
MTRMEM_RSAAGEKS           E3           10
MTRMEM_RSACKMA2G          A4      4
MTRMEM_RSACKMB2G          A0      4
MTRMEM_RSAFNOTI           88      8
MTRMEM_RSAGOFFL           64      8
MTRMEM_RSAGSTOR           5C      8
MTRMEM_RSAIOSIZE          D8      4
MTRMEM_RSAIOUSD           D0      8
MTRMEM_RSAIOWRNP          DC      4
MTRMEM_RSAIPLST           E4      1
MTRMEM_RSAKEEP            E4           10
MTRMEM_RSALGFRM           6C      8
MTRMEM_RSANONE            E4           20
MTRMEM_RSANONPG           34      4
MTRMEM_RSAOFFLN           38      4
MTRMEM_RSAPGABL           30      4
MTRMEM_RSAPINFP           CC      4
MTRMEM_RSAPINWP           C8      4
MTRMEM_RSAPIN0A           B0      8
MTRMEM_RSAPIN0B           A8      8
MTRMEM_RSAPIN1A           C0      8
MTRMEM_RSAPIN1B           B8      8
MTRMEM_RSAPZONESACTIVEA2G F8      8
MTRMEM_RSAPZONESACTIVEB2G F0      8
MTRMEM_RSARQPRM          128      8
MTRMEM_RSARQRCF          130      8
MTRMEM_RSARZONESACTIVEA2G 100      8
MTRMEM_RSASHUT            E4           04
MTRMEM_RSASTEQL           E4           80
MTRMEM_RSASTORE           14      4
MTRMEM_RSASTPRM          118      8
MTRMEM_RSASTRCF          120      8
MTRMEM_RSASYSCF           E4           40
MTRMEM_RSASYSIPL          E4           02
MTRMEM_SALWRNCF          148      1
MTRMEM_SXSSIZE            74      4
MTRMEM_SYSFHPAV           E2           80
MTRMEM_SYSFHPF            E2           40
MTRMEM_SYSGSTBY           90      8
MTRMEM_SYSGSTRS           98      8
MTRMEM_SYSGTORS           54      8
MTRMEM_SYSHPFLG           E2      1
MTRMEM_SYSHPIOM           E0      2
MTRMEM_SYSPERMA          108      8
MTRMEM_SYSRECNF          110      8
MTRMEM_SYSSCMEX           50      4
MTRMEM_SYSTORS            18      4
MTRMEM_SYSTRAC            24      4
MTRMEM_SYSTRCPC           40      2

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

Last updated on 06 August 2021 at 14:42:07.
Copyright IBM Corporation, 1990, 2021