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

#### MRSTORSG

Prolog
Control Block Contents
Cross Reference

#### MRSTORSG Prolog

####

####

     DSECT NAME - STORSG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor control area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTORSG
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3 - Storage Domain
                        Record 1 - Real Storage Management (Global)
     DESCRIPTION - Utilization of real memory.  This includes available
                   list replenishment and free storage management.

    MRSTORSG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  300  STORSG                 Start of monitor record
      0   0  Character    0  STORSG_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  STORSG_CALSSUBT        Cardinal count of blocks on
                                                    each regular free storage
                                                    subpool list <2G. See
                                                    STORSG_CALSSUBG for the >2G
                                                    value.
     24  18  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSG_CALVSUBT)
     28  1C  Unsigned     4  STORSG_RSASAVFR        Cardinal count of frames in
                                                    use for saveareas.
     32  20  Unsigned     4  STORSG_RSAMAXPP        Cardinal count of reserved
                                                    frames per processor. See also
                                                    STORSG_RSARSVSY.
     36  24  Unsigned     4  STORSG_RSACPLOK        Cardinal count of frames
                                                    locked below 2G by the CP LOCK
                                                    REAL command. See
                                                    STORSG_RSACPLKG for the >2G
                                                    count.
     40  28  Unsigned     4  STORSG_RSAAVLLT        Cardinal count of <2G
                                                    available list low threshold
                                                    value. Indicates when the <2G
                                                    demand scan should be invoked.
                                                    This provides a buffer of
                                                    frames for the system to use
                                                    while the demand scan is
                                                    replenishing the <2G available
                                                    list. See STORSG_RSAAVLLG for
                                                    the >2G value.
     44  2C  Unsigned     4  STORSG_RSAAVLHT        Cardinal count of <2G
                                                    available list high threshold.
                                                    Number of frames that should be
                                                    taken by the <2G available list
                                                    replenishment functions to
                                                    satisfy the current user and
                                                    system needs. See
                                                    STORSG_RSAAVLHG for the >2G
                                                    value.
     48  30  Unsigned     4  STORSG_XSTBPRCT        Number of page faults that
                                                    involved DASD blocked pages
     52  34  Unsigned     4  STORSG_XSTSRGCT        Number of single page reads
                                                    for a guest
     56  38  Unsigned     4  STORSG_XSTMRABI        Number of pages that were
                                                    brought in as part of a block
                                                    (the guest referenced a
                                                    different page that was a
                                                    member of the block) but which
                                                    have not been referenced by the
                                                    time they were selected for
                                                    migration
     60  3C  Unsigned     4  STORSG_XSTSRABI        Number of pages that were
                                                    brought in as part of a block
                                                    (the guest referenced a
                                                    different page that was a
                                                    member of the block) but which
                                                    have not been referenced by the
                                                    time they were selected for
                                                    steal
     64  40  Unsigned     4  STORSG_XSTSRSCT        Number of single reads for
                                                    the system. System pages are
                                                    never formed into blocks, so
                                                    this number represents all
                                                    system page reads
     68  44  Unsigned     4  STORSG_CALPTRRT        Number of times the pageable
                                                    page address space was
                                                    reorganized to manage the
                                                    segment paging control
                                                    fragmentation. PTRROGCT
     72  48  Unsigned     4  STORSG_CALCAAFP        Number of allocated, but
                                                    unused, pages of virtual
                                                    storage for paging virtual
                                                    segment control. CAAFPAG
     76  4C  Unsigned     4  STORSG_CALASCUT        Number of frames of storage
                                                    used for paging virtual segment
                                                    control. ASCUSTE
     80  50  Unsigned     4  STORSG_RSASXCPL        Count of locked System
                                                    Execution Space alias pages
                                                    locked in logical via the CP
                                                    LOCK command.
     84  54  Unsigned     4  STORSG_RSASXCLA        Count of locked System
                                                    Execution Space alias pages
                                                    locked in logical. RSASXCLA >=
                                                    RSASXCPL
     88  58  Unsigned     4  STORSG_RSAAVLHG        Cardinal count of >2G
                                                    available list high threshold.
                                                    Number of frames that should be
                                                    taken by the >2G available list
                                                    replenishment functions to
                                                    satisfy the current user and
                                                    system needs. See
                                                    STORSG_RSAAVLHT for the <2G
                                                    value.
     92  5C  Unsigned     4  STORSG_RSAAVLLG        Cardinal count of >2G
                                                    available list low threshold
                                                    value. Indicates when the >2G
                                                    demand scan should be invoked.
                                                    This provides a buffer of
                                                    frames for the system to use
                                                    while the demand scan is
                                                    replenishing the >2G available
                                                    list. See STORSG_RSAAVLLT for
                                                    the <2G value.
     96  60  Unsigned     4  STORSG_RSACPLKG        Cardinal count of frames
                                                    locked above 2G by the CP LOCK
                                                    REAL command. See
                                                    STORSG_RSACPLOK for the <2G
                                                    count.
    100  64  Unsigned     4  STORSG_CALSSUBG        Cardinal count of blocks on
                                                    each regular free storage
                                                    subpool list >2G. See
                                                    STORSG_CALSSUBT for the <2G
                                                    value.
    104  68  Unsigned     4  STORSG_RSARSVSY        Total count of reserved pages
                                                    including the number of pages
                                                    reserved per processor. See
                                                    STORSG_RSAMAXPP.
    108  6C  Character    8  STORSG_RSACALLT        Lower Threshold: Non-negative
                                                    number of FRMTEs on the Cleared
                                                    Available List below which the
                                                    the Dispatcher must call a
                                                    foreground replenishment task
                                                    since the background task is
                                                    not being called frequently
                                                    enough to keep the list at a
                                                    sufficient level.
    116  74  Character    8  STORSG_RSACALMT        Middle Threshold:
                                                    Non-negative number of FRMTEs
                                                    for the foreground
                                                    replenishment task to have on
                                                    the Cleared Available List.
                                                    Note that we do not want to
                                                    fill to the Upper Threshold in
                                                    the foreground because this
                                                    might take too long and we
                                                    would rather have the
                                                    replenishment done in the
                                                    background if possible.
    124  7C  Character    8  STORSG_RSACALUT        Upper Threshold: Non-negative
                                                    target number of FRMTEs for the
                                                    background replenishment task
                                                    to have on the Cleared
                                                    Available List.
    132  84  Unsigned     4  STORSG_RSAAFSDW        Count of doublewords of host
                                                    logical aligned free storage
                                                    backed >2G.
    136  88  Unsigned     4  STORSG_RSAAFSDB        Count of doublewords of host
                                                    logical aligned free storage
                                                    backed <2G.
    140  8C  Unsigned     4  STORSG_RSAAFSIU        Count of doublewords of
                                                    in-use host logical aligned
                                                    free storage backed >2G.
    144  90  Unsigned     4  STORSG_RSAAFSIB        Count of doublewords of
                                                    in-use host logical aligned
                                                    free storage backed <2G.
    148  94  Unsigned     4  STORSG_RSAVCBDW        Count of doublewords of
                                                    verifiable free storage backed
                                                    >2G.
    152  98  Unsigned     4  STORSG_RSAVCBDB        Count of doublewords of
                                                    verifiable free storage backed
                                                    <2G.
    156  9C  Unsigned     4  STORSG_RSAVCBIU        Count of doublewords of
                                                    in-use verifiable free storage
                                                    backed >2G.
    160  A0  Unsigned     4  STORSG_RSAVCBIB        Count of doublewords of
                                                    in-use verifiable free storage
                                                    backed <2G.
    164  A4  Unsigned     4  STORSG_RSAVFSDW        Count of doublewords of
                                                    virtual free storage.
    168  A8  Unsigned     4  STORSG_RSAVFSIU        Count of doublewords of
                                                    virtual free storage in use.
    172  AC  Unsigned     4  STORSG_RSA2GDCT        Count of deferred frame
                                                    requests that are waiting for
                                                    any available frame. This count
                                                    plus RSAFRQWT is the total wait
                                                    count.
    176  B0  Unsigned     4  STORSG_RSAFRQWT        Non-negative count of
                                                    deferred requests for real
                                                    frames which have not yet been
                                                    satisfied since there are no
                                                    frames available. Requests are
                                                    for frames <2G. See
                                                    STORSG_RSA2GDCT.
    180  B4  Unsigned     4  STORSG_RSAFRRDA        Count of attempts to redrive
                                                    tasks waiting for frames <2G.
    184  B8  Unsigned     4  STORSG_RSAFRRDC        Count of individual task
                                                    redrives performed for frames
                                                    <2G.
    188  BC  Unsigned     4  STORSG_RSASTLWT        Count of available list
                                                    replenishment page writes
                                                    (steal writes) for <2G frames.
    192  C0  Unsigned     4  STORSG_RSASWG2G        Count of available list
                                                    replenishment page writes
                                                    (steal writes) for >=2G frames.
    196  C4  Unsigned     4  STORSG_RSAFVMUD        Count of doublewords of VMDBK
                                                    free storage in use >2G.
                                                    Allocated from VMDBKs, VMDBK
                                                    free storage pages, and system
                                                    free storage pages. This count
                                                    does not include the storage
                                                    allocated from the free storage
                                                    subpools.
    200  C8  Unsigned     4  STORSG_RSAFVMUB        Count of doublewords of VMDBK
                                                    free storage in use <2G.
                                                    Allocated from VMDBKs, VMDBK
                                                    free storage pages, and system
                                                    free storage pages. This count
                                                    does not include the storage
                                                    allocated from the free storage
                                                    subpools.
    204  CC  Unsigned     4  STORSG_RSAVMXFR        Count of pages in use for
                                                    VMDBK free storage >2G, i.e.,
                                                    user free pages allocated. This
                                                    count does not include VMDBKs
                                                    themselves.
    208  D0  Unsigned     4  STORSG_RSAVMXFB        Count of pages in use for
                                                    VMDBK free storage <2G, i.e.,
                                                    user free pages allocated. This
                                                    count does not include VMDBKs
                                                    themselves.
    212  D4  Unsigned     4  STORSG_RSAVMXUD        Count of in-use user free
                                                    storage doublewords (allocated
                                                    from VMDBK free storage pages)
                                                    backed >2G. This count does not
                                                    include storage in the VMDBKs
                                                    themselves.
    216  D8  Unsigned     4  STORSG_RSAVMXUB        Count of in-use user free
                                                    storage doublewords (allocated
                                                    from VMDBK free storage pages)
                                                    backed <2G. This count does not
                                                    include storage in the VMDBKs
                                                    themselves.
    220  DC  Unsigned     4  STORSG_RSASYSFR        Count of pages in use for
                                                    system free storage >2G.
    224  E0  Unsigned     4  STORSG_RSASYSFB        Count of pages in use for
                                                    system free storage <2G.
    228  E4  Unsigned     4  STORSG_RSASYSUD        Count of doublewords of
                                                    in-use system free storage >2G.
    232  E8  Unsigned     4  STORSG_RSASYSUB        Count of doublewords of
                                                    in-use system free storage <2G.
    236  EC  Unsigned     4  STORSG_RSAPLPCT        Count of processors looping
                                                    in HCPFRFGP/GB trying to get a
                                                    System Execution Space page
                                                    backed any for free storage.
    240  F0  Unsigned     4  STORSG_RSAPLPCB        Count of processors looping
                                                    in HCPFRFGP/GB trying to get a
                                                    System Execution Space page
                                                    backed <2G for free storage.
    244  F4  Unsigned     4  STORSG_RSANPGCT        Count of consecutive failures
                                                    from SXPFS where no pages were
                                                    available for free storage.
    248  F8  Unsigned     4  STORSG_RSANPGHI        High water mark for number of
                                                    consecutive failures from SXPFS
                                                    when trying to get a page for
                                                    free storage (all processors).
    252  FC  Unsigned     4  STORSG_RSANOLKL        Count of no-owned locked
                                                    pages in host logical storage.
    256 100  Character    8  STORSG_RSANOLKA        Count of no-owned locked
                                                    pages in absolute storage.
    264 108  Unsigned     4  STORSG_RSASXNOP        Count of no-owned System
                                                    Execution Space aliases.
    268 10C  Unsigned     4  STORSG_RSAPPTPS        Access Register Translaton
                                                    Lookaside Buffer (ALB) and
                                                    Translation Lookaside Buffer
                                                    (TLB) purges started prior to
                                                    entering wait.
    272 110  Unsigned     4  STORSG_RSAPPTPF        ALB/TLB purges finished prior
                                                    to entering wait.
    276 114  Unsigned     4  STORSG_RSAPPTCS        ALB/TLB purges using Compare,
                                                    Swap and Purge (CSP) during
                                                    emergency Paged PGMBK aging
                                                    list (PPAL) processing.
    280 118  Unsigned     4  STORSG_RSABLKGC        Count of tasks representing
                                                    frame requests requesting or
                                                    deferred on the RSABLKGF lock.
    284 11C  Unsigned     4  STORSG_RSAFRQMW        Count of tasks currently
                                                    attempting to obtain multiple
                                                    frames for PGMBKs.
    288 120  Unsigned     4  STORSG_RSAFRQDF        Count of deferred multiple
                                                    frame requests for PGMBKs.
    292 124  Unsigned     4  STORSG_RSAFRQDL        Count of delayed multiple
                                                    frame requests for PGMBKs.
    296 128  Unsigned     4  STORSG_RSAALFMF        Total count of contiguous
                                                    frames being scanned for by
                                                    active frame table scan
                                                    (HCPALFMF FREXSCAN) tasks.
    300 12C  Character    0  STORSG_END

    MRSTORSG 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
    STORSG                     0    300
    STORSG_CALASCUT           4C      4
    STORSG_CALCAAFP           48      4
    STORSG_CALPTRRT           44      4
    STORSG_CALSSUBG           64      4
    STORSG_CALSSUBT           14      4
    STORSG_END               12C      0
    STORSG_MRHDR               0      0
    STORSG_RSAAFSDB           88      4
    STORSG_RSAAFSDW           84      4
    STORSG_RSAAFSIB           90      4
    STORSG_RSAAFSIU           8C      4
    STORSG_RSAALFMF          128      4
    STORSG_RSAAVLHG           58      4
    STORSG_RSAAVLHT           2C      4
    STORSG_RSAAVLLG           5C      4
    STORSG_RSAAVLLT           28      4
    STORSG_RSABLKGC          118      4
    STORSG_RSACALLT           6C      8
    STORSG_RSACALMT           74      8
    STORSG_RSACALUT           7C      8
    STORSG_RSACPLKG           60      4
    STORSG_RSACPLOK           24      4
    STORSG_RSAFRQDF          120      4
    STORSG_RSAFRQDL          124      4
    STORSG_RSAFRQMW          11C      4
    STORSG_RSAFRQWT           B0      4
    STORSG_RSAFRRDA           B4      4
    STORSG_RSAFRRDC           B8      4
    STORSG_RSAFVMUB           C8      4
    STORSG_RSAFVMUD           C4      4
    STORSG_RSAMAXPP           20      4
    STORSG_RSANOLKA          100      8
    STORSG_RSANOLKL           FC      4
    STORSG_RSANPGCT           F4      4
    STORSG_RSANPGHI           F8      4
    STORSG_RSAPLPCB           F0      4
    STORSG_RSAPLPCT           EC      4
    STORSG_RSAPPTCS          114      4
    STORSG_RSAPPTPF          110      4
    STORSG_RSAPPTPS          10C      4
    STORSG_RSARSVSY           68      4
    STORSG_RSASAVFR           1C      4
    STORSG_RSASTLWT           BC      4
    STORSG_RSASWG2G           C0      4
    STORSG_RSASXCLA           54      4
    STORSG_RSASXCPL           50      4
    STORSG_RSASXNOP          108      4
    STORSG_RSASYSFB           E0      4
    STORSG_RSASYSFR           DC      4
    STORSG_RSASYSUB           E8      4
    STORSG_RSASYSUD           E4      4
    STORSG_RSAVCBDB           98      4
    STORSG_RSAVCBDW           94      4
    STORSG_RSAVCBIB           A0      4
    STORSG_RSAVCBIU           9C      4
    STORSG_RSAVFSDW           A4      4
    STORSG_RSAVFSIU           A8      4
    STORSG_RSAVMXFB           D0      4
    STORSG_RSAVMXFR           CC      4
    STORSG_RSAVMXUB           D8      4
    STORSG_RSAVMXUD           D4      4
    STORSG_RSA2GDCT           AC      4
    STORSG_XSTBPRCT           30      4
    STORSG_XSTMRABI           38      4
    STORSG_XSTSRABI           3C      4
    STORSG_XSTSRGCT           34      4
    STORSG_XSTSRSCT           40      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