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  224  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  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meangingul. (SYTRSG_RSAFSTOR)
     24  18  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (SYTRSG_SYSVRSZ)
     28  1C  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (SYTRSG_RSAFSYUD)
     32  20  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (SYTRSG_RSAFVRUD)
     36  24  Unsigned     4  SYTRSG_SYSRSVPG        Cardinal count of reserved
                                                    pages.
     40  28  Unsigned     4  SYTRSG_RSACPLOK        Cardinal count of frames
                                                    locked below 2G by the CP LOCK
                                                    REAL command. See
                                                    SYTRSG_RSACPLKG for the >2G
                                                    count.
     44  2C  Unsigned     4  SYTRSG_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
                                                    SYTRSG_RSAPGABL and
                                                    SYTRSG_RSALGFRM.
     48  30  Unsigned     4  SYTRSG_RSAPGABL        Cardinal count of <2G
                                                    pageable frames in the system.
                                                    This includes those that had
                                                    been made non-pageable (see
                                                    SYTRSG_RSANONPG). The size of
                                                    the dynamic area (DPA) or the
                                                    count of useable frames may be
                                                    calculated by subtracting
                                                    RSANONPG from RSAPGABL. See
                                                    SYTRSG_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  SYTRSG_RSAAVAIL        Cardinal count of frames that
                                                    are currently on the <2G
                                                    available list. See
                                                    SYTRSG_RSA2GAVL for the >2G
                                                    count.
     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  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (SYTRSG_RSAXFREE)
     68  44  Unsigned     4  SYTRSG_RSASAVFR        Cardinal count of frames in
                                                    use for saveareas.
     72  48  Bitstring    1  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (SYTRSG_CALSTAT)
     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    8  SYTRSG_RSALGFRM        Cardinal count of >2G useable
                                                    frames. See SYTRSG_RSAPGABL and
                                                    STYRSG_RSANONPG for the <2G
                                                    value.
    136  88  Unsigned     4  SYTRSG_RSACPLKG        Cardinal count of frames
                                                    locked above 2G by the CP LOCK
                                                    REAL command. See
                                                    SYTRSG_RSACPLOK for the <2G
                                                    count.
    140  8C  Character    8  SYTRSG_RSA2GAVL        Cardinal count of frames that
                                                    are currently on the >2G
                                                    available list. See
                                                    SYTRSG_RSAAVAIL for the <2G
                                                    count.
    148  94  Unsigned     4  SYTRSG_RSAFSB2G        Count of doublewords assigned
                                                    to subpool free storage backed
                                                    below 2G.
    152  98  Unsigned     4  SYTRSG_RSAFSA2G        Count of doublewords assigned
                                                    to subpool free storage backed
                                                    above 2G.
    156  9C  Unsigned     4  SYTRSG_RSAFSYUB        Count of doublewords of in
                                                    use subpool free storage backed
                                                    below 2G.
    160  A0  Unsigned     4  SYTRSG_RSAFSYUA        Count of doublewords of in
                                                    use subpool free storage backed
                                                    above 2G.
    164  A4  Unsigned     4  SYTRSG_RSASXCPL        Count of locked System
                                                    Execution Space alias pages
                                                    locked in logical via the CP
                                                    LOCK command.
    168  A8  Unsigned     4  SYTRSG_RSASXCLA        Count of locked System
                                                    Execution Space alias pages
                                                    locked in logical. RSASXCLA >=
                                                    RSASXCPL
    172  AC  Unsigned     4  SYTRSG_RSARFRST        Count of frames allocated for
                                                    real free storage <2G.
    176  B0  Character    8  SYTRSG_RSARFRSG        Count of frames allocated for
                                                    real free storage >2G.
    184  B8  Unsigned     4  SYTRSG_RSASXBCT        Count of SXS pages on the
                                                    queue of SXS pages backed below
                                                    2G.
    188  BC  Unsigned     4  SYTRSG_RSASXACT        Count of SXS pages on the
                                                    queue of SXS pages backed above
                                                    2G.
    192  C0  Unsigned     4  SYTRSG_RSAAFRDB        Count of doublewords of
                                                    aligned real free storage <2G.
                                                    This count includes active as
                                                    well as inactive aligned free
                                                    storage.
    196  C4  Character    8  SYTRSG_RSAAFRDW        Count of doublewords of
                                                    aligned real free storage >2G.
                                                    This count includes active as
                                                    well as inactive aligned free
                                                    storage.
    204  CC  Unsigned     4  SYTRSG_RSAAFRIB        Count of doublewords of in
                                                    use aligned real free storage
                                                    <2G. This count includes only
                                                    active aligned free storage.
    208  D0  Character    8  SYTRSG_RSAAFRIU        Count of doublewords of in
                                                    use aligned real free storage
                                                    >2G. This count includes only
                                                    active aligned free storage.
    216  D8  Character    8  SYTRSG_RSACALCT        Count of the total number of
                                                    frames on the cleared available
                                                    list.
    224  E0  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    224
    SYTRSG_CALFLAG1           49      1
    SYTRSG_END                E0      0
    SYTRSG_HCPSTPMB           4A      2
    SYTRSG_MRHDR               0      0
    SYTRSG_RSAAFRDB           C0      4
    SYTRSG_RSAAFRDW           C4      8
    SYTRSG_RSAAFRIB           CC      4
    SYTRSG_RSAAFRIU           D0      8
    SYTRSG_RSAAVAIL           34      4
    SYTRSG_RSACALCT           D8      8
    SYTRSG_RSACPLKG           88      4
    SYTRSG_RSACPLOK           28      4
    SYTRSG_RSAFRQWT           38      4
    SYTRSG_RSAFSA2G           98      4
    SYTRSG_RSAFSB2G           94      4
    SYTRSG_RSAFSYUA           A0      4
    SYTRSG_RSAFSYUB           9C      4
    SYTRSG_RSALGFRM           80      8
    SYTRSG_RSANONPG           2C      4
    SYTRSG_RSAPGABL           30      4
    SYTRSG_RSARFRSG           B0      8
    SYTRSG_RSARFRST           AC      4
    SYTRSG_RSASAVFR           44      4
    SYTRSG_RSASXACT           BC      4
    SYTRSG_RSASXBCT           B8      4
    SYTRSG_RSASXCLA           A8      4
    SYTRSG_RSASXCPL           A4      4
    SYTRSG_RSAXTEND           3C      4
    SYTRSG_RSA2GAVL           8C      8
    SYTRSG_RSA2GDCT           78      4
    SYTRSG_SYSRSVPG           24      4
    SYTRSG_SYSSCGCT           7C      4
    SYTRSG_SYSSCMAV           6C      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

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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005