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 V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001