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