Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRSYTRSG

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRSYTRSG Prolog

####

####

     DSECT NAME - SYTRSG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTRSG
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 0 - System Domain
                        Record 3 - Real Storage Data (Global)
     DESCRIPTION - Real storage allocation and use. Provides
                   dynamically changing classes of usage.
                   Static classes of usage are provided in the
                   MONITOR domain.

    MRSYTRSG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  124  SYTRSG              Start of monitor record
      0   0  Character    0  SYTRSG_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  SYTRSG_RSAFSTOR     Cardinal count (in doublewords)
                                                 of subpool free storage currently
                                                 available and in use.
     24  18  Unsigned     4  SYTRSG_SYSVRSZ      Cardinal count of the V=R area,
                                                 in bytes.
     28  1C  Unsigned     4  SYTRSG_RSAFSYUD     Cardinal count (in doublewords)
                                                 of subpool free storage currently
                                                 in use.
     32  20  Unsigned     4  SYTRSG_RSAFVRUD     Cardinal count (in doublewords)
                                                 of V=R free storage currently in
                                                 use.
     36  24  Unsigned     4  SYTRSG_SYSRSVPG     Cardinal count of reserved
                                                 pages.
     40  28  Unsigned     4  SYTRSG_RSACPLOK     Cardinal count of frames locked
                                                 by CP LOCK command.
     44  2C  Unsigned     4  SYTRSG_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.
     48  30  Unsigned     4  SYTRSG_RSAPGABL     Cardinal count of pageable
                                                 frames in the system. This
                                                 includes those that had been made
                                                 non-pageable (see
                                                 SYTRSG_RSANONPG). The size of the
                                                 dynamic area (DPA) may be
                                                 calculated by subtracting RSANONPG
                                                 from RSAPGABL.
     52  34  Unsigned     4  SYTRSG_RSAAVAIL     Cardinal count of frames that
                                                 are currently on the available
                                                 list.
     56  38  Unsigned     4  SYTRSG_RSAFRQWT     Cardinal count of deferred tasks
                                                 waiting for a frame. This
                                                 represents the number of requests
                                                 for real frames which have not
                                                 been satisfied yet because no
                                                 frames are available. It includes
                                                 both tasks waiting for frames
                                                 above and below the 2GB line. For
                                                 a count of tasks waiting for a
                                                 frame below 2GB, subtract
                                                 SYTRSG_RSA2GDCT from this field.
     60  3C  Unsigned     4  SYTRSG_RSAXTEND     Cardinal count of frames missing
                                                 from the free storage reserved
                                                 frames list.
     64  40  Unsigned     4  SYTRSG_RSAXFREE     Cardinal count of frames in use
                                                 for Save and Subpool, System, and
                                                 VMDBK free storage.
     68  44  Unsigned     4  SYTRSG_RSASAVFR     Cardinal count of frames in use
                                                 for saveareas.
     72  48  Bitstring    1  SYTRSG_CALSTAT      V=R flag byte (VMDGSRSM)
              1... ....      SYTRSG_VMDGSEXH     Guest survival free storage
                                                 exhausted
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     73  49  Bitstring    1  SYTRSG_CALFLAG1     Flags byte.
              1... ....      SYTRSG_TCMCACHE     Minidisk Caching is enabled.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     74  4A  Unsigned     2  SYTRSG_HCPSTPMB     Bias for minidisk cache use of
                                                 real storage. A decimal point is
                                                 assumed to the left of the low
                                                 order 2 digits. For example, a
                                                 value of decimal 95 in this field
                                                 would be a bias setting of .95 .
     76  4C  Unsigned     4  SYTRSG_SYS98XA      Cardinal number of pages locked
                                                 by Diagnose X'98' in 31-bit mode
     80  50  Unsigned     4  *                   Reserved for IBM use. Previous
                                                 field is no longer meaningful.
                                                 (SYTRSG_SYS98370)
     84  54  Unsigned     4  SYTRSG_TCMMIDSZ     Maximum allowable number of
                                                 pages in mindisk cache (based on
                                                 average age of a page in DPA).
     88  58  Unsigned     4  SYTRSG_TCMMAIN      Current number of pages in main
                                                 storage being used as track cache
                                                 pages. For a breakdown of pages
                                                 below and above the 2GB line, see
                                                 SYTRSG_TCMMNBLW and
                                                 SYTRSG_TCMMNABV.
     92  5C  Unsigned     4  SYTRSG_TCMMNMIN     Minimum number of main storage
                                                 pages used by cache as set by user
                                                 command
     96  60  Unsigned     4  SYTRSG_TCMMNMAX     Maximum number of main storage
                                                 pages used by cache as set by user
                                                 command
    100  64  Unsigned     4  SYTRSG_TCMMNDL      Number of main storage pages
                                                 deleted from cache
    104  68  Unsigned     4  SYTRSG_TCMSTLMN     Number of times the steal
                                                 function was invoked to steal main
                                                 storage pages from the track cache
    108  6C  Unsigned     4  SYTRSG_SYSSCMAV     Number of SCMBKs that are
                                                 available
    112  70  Unsigned     4  SYTRSG_TCMMNBLW     Number of pages in main storage
                                                 below 2GB in use as track cache
                                                 pages. For ESA/390 systems this
                                                 field will be equal to
                                                 SYTRSG_TCMMAIN.
    116  74  Unsigned     4  SYTRSG_TCMMNABV     Number of pages in main storage
                                                 at or above 2GB in use as track
                                                 cache pages. For ESA/390 systems
                                                 this field will be zero.
    120  78  Unsigned     4  SYTRSG_RSA2GDCT     Cardinal count of deferred tasks
                                                 that are waiting for frames that
                                                 can be above the 2GB line. See
                                                 SYTRSG_RSADFRQWT for the total
                                                 count. For a count of tasks
                                                 waiting for frames below the 2GB
                                                 line, subtract this field from
                                                 SYTRSG_RSADFRQWT.
    124  7C  Character    0  SYTRSG_END

    MRSYTRSG 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
    SYTRSG                  0    124
    SYTRSG_CALFLAG1        49      1
    SYTRSG_CALSTAT         48      1
    SYTRSG_END             7C      0
    SYTRSG_HCPSTPMB        4A      2
    SYTRSG_MRHDR            0      0
    SYTRSG_RSAAVAIL        34      4
    SYTRSG_RSACPLOK        28      4
    SYTRSG_RSAFRQWT        38      4
    SYTRSG_RSAFSTOR        14      4
    SYTRSG_RSAFSYUD        1C      4
    SYTRSG_RSAFVRUD        20      4
    SYTRSG_RSANONPG        2C      4
    SYTRSG_RSAPGABL        30      4
    SYTRSG_RSASAVFR        44      4
    SYTRSG_RSAXFREE        40      4
    SYTRSG_RSAXTEND        3C      4
    SYTRSG_RSA2GDCT        78      4
    SYTRSG_SYSRSVPG        24      4
    SYTRSG_SYSSCMAV        6C      4
    SYTRSG_SYSVRSZ         18      4
    SYTRSG_SYS98XA         4C      4
    SYTRSG_TCMCACHE        49           80
    SYTRSG_TCMMAIN         58      4
    SYTRSG_TCMMIDSZ        54      4
    SYTRSG_TCMMNABV        74      4
    SYTRSG_TCMMNBLW        70      4
    SYTRSG_TCMMNDL         64      4
    SYTRSG_TCMMNMAX        60      4
    SYTRSG_TCMMNMIN        5C      4
    SYTRSG_TCMSTLMN        68      4
    SYTRSG_VMDGSEXH        48           80

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002