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
Storage Layout
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 V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002