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  356  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 single
                                                    frame available list low
                                                    threshold value. Indicates when
                                                    the <2G single frame demand
                                                    scan should be invoked. This
                                                    provides a buffer of frames for
                                                    the system to use while the
                                                    demand scan is replenishing the
                                                    <2G single frame available
                                                    list.
     44  2C  Unsigned     4  STORSG_RSAAVLHT        Cardinal count of <2G single
                                                    frame available list high
                                                    threshold. Number of frames
                                                    that should be taken by the <2G
                                                    single frame available list
                                                    replenishment functions to
                                                    satisfy the current user and
                                                    system needs.
     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 single
                                                    frame available list high
                                                    threshold. Number of frames
                                                    that should be taken by the >2G
                                                    single frame available list
                                                    replenishment functions to
                                                    satisfy the current user and
                                                    system needs.
     92  5C  Unsigned     4  STORSG_RSAAVLLG        Cardinal count of >2G single
                                                    frame available list low
                                                    threshold value. Indicates when
                                                    the >2G single frame demand
                                                    scan should be invoked. This
                                                    provides a buffer of frames for
                                                    the system to use while the
                                                    demand scan is replenishing the
                                                    >2G single frame available
                                                    list.
     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  Unsigned     4  STORSG_RSAAVCLT        Cardinal count of <2G
                                                    contiguous available list low
                                                    threshold. Indicates when <2G
                                                    contiguous frame demand scan
                                                    should be invoked. This
                                                    provides a buffer of frames for
                                                    the system to use while demand
                                                    scan is replenishing the <2G
                                                    contiguous frame available
                                                    list.
    304 130  Unsigned     4  STORSG_RSAAVCHT        Cardinal count of <2G
                                                    contiguous available list high
                                                    threshold. Number of frames
                                                    that should be taken by the <2G
                                                    contig avail list replenishment
                                                    functions to satisfy the
                                                    current user & system needs.
    308 134  Unsigned     4  STORSG_RSAAVCLG        Cardinal count of >2G
                                                    contiguous available list low
                                                    threshold. Indicates when >2G
                                                    contiguous frame demand scan
                                                    should be invoked. This
                                                    provides a buffer of frames for
                                                    the system to use while demand
                                                    scan is replenishing the >2G
                                                    contiguous frame available
                                                    list.
    312 138  Unsigned     4  STORSG_RSAAVCHG        Cardinal count of >2G
                                                    contiguous available list high
                                                    threshold. Number of frames
                                                    that should be taken by the >2G
                                                    contig avail list replenishment
                                                    functions to satisfy the
                                                    current user & system needs.
    316 13C  Unsigned     4  STORSG_RSAEMLO         Cardinal count of the low
                                                    threshhold for the emergency
                                                    PGMBK pool.
    320 140  Unsigned     4  STORSG_RSAEMHI         Cardinal count of the high
                                                    threshhold for the emergency
                                                    PGMBK pool.
    324 144  Unsigned     4  STORSG_RSAEMCPC        Cardinal count of the number
                                                    of PGMBKs in the emergency pool
                                                    at the moment.
    328 148  Unsigned     4  STORSG_RSAEMERG        Cardinal count of the number
                                                    of times a request was made for
                                                    an emergency PGMBK. This
                                                    counter may wrap.
    332 14C  Unsigned     4  STORSG_RSAEMBLO        Cardinal count of the number
                                                    of times the pool dipped below
                                                    RSAemLO but was still not
                                                    empty. This counter may wrap.
    336 150  Unsigned     4  STORSG_RSAEMPTY        Cardinal count of the number
                                                    of times the pool went empty.
                                                    This counter may wrap.
    340 154  Unsigned     4  STORSG_RSAEMDFR        Cardinal count of the number
                                                    of times a guest was deferred
                                                    because an emergency PGMBK was
                                                    needed. This counter may wrap.
    344 158  Unsigned     4  STORSG_RSASWPWT        Count of available list
                                                    replenishment page writes to
                                                    DASD for < 2G PGMBKs in frames.
    348 15C  Unsigned     4  STORSG_RSASWP2G        Count of available list
                                                    replenishment page writes to
                                                    DASD for >= 2G PGMBKs in
                                                    frames.
    352 160  Bitstring    1  STORSG_RSAREOFL        Flag byte
              1... ....      STORSG_RSAREOSY        If on, reorder processing is
                                                    in effect for the system
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    353 161  Bitstring    3  *                      Reserved for IBM use
    356 164  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    356
    STORSG_CALASCUT           4C      4
    STORSG_CALCAAFP           48      4
    STORSG_CALPTRRT           44      4
    STORSG_CALSSUBG           64      4
    STORSG_CALSSUBT           14      4
    STORSG_END               164      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_RSAAVCHG          138      4
    STORSG_RSAAVCHT          130      4
    STORSG_RSAAVCLG          134      4
    STORSG_RSAAVCLT          12C      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_RSAEMBLO          14C      4
    STORSG_RSAEMCPC          144      4
    STORSG_RSAEMDFR          154      4
    STORSG_RSAEMERG          148      4
    STORSG_RSAEMHI           140      4
    STORSG_RSAEMLO           13C      4
    STORSG_RSAEMPTY          150      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_RSAREOFL          160      1
    STORSG_RSAREOSY          160           80
    STORSG_RSARSVSY           68      4
    STORSG_RSASAVFR           1C      4
    STORSG_RSASTLWT           BC      4
    STORSG_RSASWG2G           C0      4
    STORSG_RSASWPWT          158      4
    STORSG_RSASWP2G          15C      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 V6R1.0.

    Last updated on 14 Sep 2010 at 22:59:13.

    Copyright IBM Corporation, 1990, 2010