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
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  128  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. This field is valid
                                                only when format-0 measurement
                                                blocks are being used
                                                (MTRSYS_CALFLG2 <> x'80').
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  Unsigned     4  SYTRSG_SYSSCGCT        Number of SCGBKs currently
                                                allocated. This field is valid
                                                only when format-1 measurement
                                                blocks are being used
                                                (MTRSYS_CALFLG2 = x'80').
128  80  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    128
SYTRSG_CALFLAG1           49      1
SYTRSG_CALSTAT            48      1
SYTRSG_END                80      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_SYSSCGCT           7C      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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004