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

#### MRSTOSXG

Prolog
Control Block Contents
Cross Reference

#### MRSTOSXG Prolog

####

####

     DSECT NAME - STOSXG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOSXG
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3  - Storage Domain
                        Record 19 - System Execution Space (Global)
     DESCRIPTION - Utilization of System Execution Space storage on a
                   global basis.

    MRSTOSXG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   88  STOSXG                 Start of monitor record
      0   0  Character    0  STOSXG_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  STOSXG_RSASXUOT        Count of pages of other CP
                                                    type pages: (SYTSXG_RSASXUCP -
                                                    (SYTSXG_RSASXUID +
                                                    SYTSXG_RSASXUFS +
                                                    SYTSXG_RSASXUFG)).
     24  18  Unsigned     4  STOSXG_RSASXCTG        Count of System Execution
                                                    Space pages in use as part of a
                                                    contiguous page request from
                                                    HCPGETST with PAGES>1. This
                                                    count does not include the
                                                    pages that were pre-allocated
                                                    as a part of initialization.
     28  1C  Unsigned     4  STOSXG_RSASXCPL        Count of locked System
                                                    Execution Space alias pages
                                                    locked by the CP LOCK command.
     32  20  Unsigned     4  STOSXG_RSASXPCT        Number of pages on the System
                                                    Execution Space potentially-
                                                    stealable queue.
     36  24  Unsigned     4  STOSXG_RSASXDCT        Number of System Execution
                                                    Space page requests that are
                                                    currently deferred.
     40  28  Unsigned     4  STOSXG_RSASXDCA        Number of System Execution
                                                    Space create alias requests
                                                    that are currently deferred.
     44  2C  Unsigned     4  STOSXG_RSASXDPA        Number of System Execution
                                                    Space page requests with
                                                    backing=any that are currently
                                                    deferred for a page.
     48  30  Unsigned     4  STOSXG_RSASXDPB        Number of System Execution
                                                    Space page requests with
                                                    backing=below 2G that are
                                                    currently deferred for a page.
     52  34  Unsigned     4  STOSXG_RSASXDFA        Number of System Execution
                                                    Space page requests that are
                                                    currently deferred for any
                                                    frame.
     56  38  Unsigned     4  STOSXG_RSASXDFB        Number of System Execution
                                                    Space page requests that are
                                                    currently deferred for a frame
                                                    below 2G.
     60  3C  Unsigned     4  STOSXG_RSASXRDA        Count of times an attempt was
                                                    made to redrive tasks waiting
                                                    for an available page.
     64  40  Unsigned     4  STOSXG_RSASXRDC        Count of individual task
                                                    redrives for tasks waiting for
                                                    an available page.
     68  44  Unsigned     4  STOSXG_RSASXAMX        Maximum number of pages on
                                                    the backed above 2G queue.
     72  48  Unsigned     4  STOSXG_RSASXBMX        Maximum number of pages on
                                                    the backed below 2G queue.
     76  4C  Unsigned     4  STOSXG_RSASXQMN        Threshold that triggers
                                                    replenishment of the available
                                                    unbacked SXS page queue.
     80  50  Unsigned     4  STOSXG_RSASXQRA        Number of aliases that are
                                                    stolen during a single
                                                    replenishment of the available
                                                    unbacked SXS page queue.
     84  54  Unsigned     4  STOSXG_RSASXRPM        Smallest number of pages on
                                                    the available, unbacked SXS
                                                    page queue at the completion of
                                                    replenishments.
     88  58  Character    0  STOSXG_END

    MRSTOSXG 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
    STOSXG                     0     88
    STOSXG_END                58      0
    STOSXG_MRHDR               0      0
    STOSXG_RSASXAMX           44      4
    STOSXG_RSASXBMX           48      4
    STOSXG_RSASXCPL           1C      4
    STOSXG_RSASXCTG           18      4
    STOSXG_RSASXDCA           28      4
    STOSXG_RSASXDCT           24      4
    STOSXG_RSASXDFA           34      4
    STOSXG_RSASXDFB           38      4
    STOSXG_RSASXDPA           2C      4
    STOSXG_RSASXDPB           30      4
    STOSXG_RSASXPCT           20      4
    STOSXG_RSASXQMN           4C      4
    STOSXG_RSASXQRA           50      4
    STOSXG_RSASXRDA           3C      4
    STOSXG_RSASXRDC           40      4
    STOSXG_RSASXRPM           54      4
    STOSXG_RSASXUOT           14      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