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