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   80  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
 24  18  Unsigned     4  STORSG_CALVSUBT        Cardinal count of blocks on
                                                each V=R free storage subpool
                                                list
 28  1C  Unsigned     4  STORSG_RSASAVFR        Cardinal count of frames in
                                                use for saveareas.
 32  20  Unsigned     4  STORSG_RSAMAXPP        Cardinal count or reserved
                                                frames per processor.
 36  24  Unsigned     4  STORSG_RSACPLOK        Cardinal count of frames
                                                locked by CP LOCK command.
 40  28  Unsigned     4  STORSG_RSAAVLLT        Cardinal count of available
                                                list low threshold value.
                                                Indicates when the demand scan
                                                should be invoked. This
                                                provides a buffer of frames for
                                                the system to use while the
                                                demand scan is replenishing the
                                                available list.
 44  2C  Unsigned     4  STORSG_RSAAVLHT        Cardinal count of available
                                                list high threshold. Number of
                                                frames that should be taken by
                                                the 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
                                                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  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     80
STORSG_CALASCUT           4C      4
STORSG_CALCAAFP           48      4
STORSG_CALPTRRT           44      4
STORSG_CALSSUBT           14      4
STORSG_CALVSUBT           18      4
STORSG_END                50      0
STORSG_MRHDR               0      0
STORSG_RSAAVLHT           2C      4
STORSG_RSAAVLLT           28      4
STORSG_RSACPLOK           24      4
STORSG_RSAMAXPP           20      4
STORSG_RSASAVFR           1C      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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004