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

#### MRSTOSXP

Prolog
Control Block Contents
Cross Reference

#### MRSTOSXP Prolog

####

####

     DSECT NAME - STOSXP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOSXP
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3  - Storage Domain
                        Record 20 - System Execution Space
                                    (Per Processor)
     DESCRIPTION - Utilization of System Execution Space storage on a
                   per processor basis.
                   This record is needed because System Execution Space
                   usage is not expected to be evenly distributed across
                   all processors in a complex. A separate record is
                   generated for each online processor.

    MRSTOSXP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  132  STOSXP                 Start of monitor record
      0   0  Character    0  STOSXP_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     2  STOSXP_PFXCPUAD        Processor address.
     22  16  Unsigned     2  *                      Reserved for IBM use.
     24  18  Unsigned     4  STOSXP_PLSSUTKC        Number of pages taken from
                                                    the unbacked available queue.
     28  1C  Unsigned     4  STOSXP_PLSSURTC        Number of pages returned to
                                                    the unbacked available queue.
     32  20  Unsigned     4  STOSXP_PLSSUPUC        Number of times the available
                                                    unbacked queue was the
                                                    preferred queue for request
                                                    type and was used to satisfy a
                                                    request.
     36  24  Unsigned     4  STOSXP_PLSSUQMT        Number of times the available
                                                    unbacked queue was empty but
                                                    was the preferred queue for the
                                                    request type.
     40  28  Unsigned     4  STOSXP_PLSSATKC        Number of pages taken from
                                                    the backed-above-2G available
                                                    queue.
     44  2C  Unsigned     4  STOSXP_PLSSARTC        Number of pages returned to
                                                    the backed-above-2G available
                                                    queue.
     48  30  Unsigned     4  STOSXP_PLSSAPUC        Number of times the available
                                                    backed-above-2G queue was the
                                                    preferred queue for the request
                                                    type and was used to satisfy
                                                    the request.
     52  34  Unsigned     4  STOSXP_PLSSAQMT        Number of times the available
                                                    backed-above-2G queue was empty
                                                    but was the preferred queue for
                                                    the request type.
     56  38  Unsigned     4  STOSXP_PLSSBTKC        Number of pages taken from
                                                    the backed-below-2G queue.
     60  3C  Unsigned     4  STOSXP_PLSSBRTC        Number of pages returned to
                                                    the backed-below-2G available
                                                    queue.
     64  40  Unsigned     4  STOSXP_PLSSBPUC        Number of times the available
                                                    backed-below-2G queue was the
                                                    preferred queue for the request
                                                    type and was used to satisfy
                                                    the request.
     68  44  Unsigned     4  STOSXP_PLSSBQMT        Number of times the available
                                                    backed-below-2G queue was empty
                                                    but was the preferred queue for
                                                    the request type.
     72  48  Unsigned     4  STOSXP_PLSSXALS        Number of times an alias was
                                                    stolen from the potentially
                                                    stealable queue because the
                                                    available page queues were
                                                    empty.
     76  4C  Unsigned     4  STOSXP_PLSSXADC        Count of locked aliases
                                                    dequeued while searching the
                                                    potentially stealable queue for
                                                    one to steal.
     80  50  Unsigned     4  STOSXP_PLSSXASC        Count of aliases stolen by
                                                    the System Execution Space page
                                                    manager.
     84  54  Unsigned     4  STOSXP_PLSSPNDP        Number of non-deferrable page
                                                    requests that failed due to the
                                                    lack of a page.
     88  58  Unsigned     4  STOSXP_PLSSPNDF        Number of non-deferrable page
                                                    requests that failed due to the
                                                    lack of a frame.
     92  5C  Unsigned     4  STOSXP_PLSSPGPD        Number of times a page
                                                    request deferred on a page.
     96  60  Unsigned     4  STOSXP_PLSSPGFD        Number of times a page
                                                    request deferred on any frame.
    100  64  Unsigned     4  STOSXP_PLSSPGBD        Number of times a page
                                                    request deferred on a frame
                                                    below 2G.
    104  68  Unsigned     4  STOSXP_PLSSPDQC        Number of times HCPFRFDQ was
                                                    called to ask free storage to
                                                    release a page.
    108  6C  Unsigned     4  STOSXP_PLSSXIPC        Number of IPTE instructions
                                                    executed to invalidate an SXS
                                                    PTE.
    112  70  Unsigned     4  STOSXP_PLSSXNST        Number of times the RSASXNST
                                                    flag was turned on, indicating
                                                    only free storage requests are
                                                    allowed to steal from the
                                                    potentially-stealable queue.
    116  74  Unsigned     4  STOSXP_PLSSXAFC        Number of times a
                                                    non-deferrable System Execution
                                                    Space alias request could not
                                                    be fulfilled.
    120  78  Unsigned     4  STOSXP_PLSSXCSP        Number of CSP instructions
                                                    used instead of IPTE when
                                                    invalidating multiple PTEs.
    124  7C  Unsigned     4  STOSXP_PLSSXALD        Number of create alias
                                                    requests that were deferred.
    128  80  Unsigned     1  STOSXP_PFXCPUTY        CPU Type. Valid values: X'00'
                                                    - General Purpose (CP) X'02' -
                                                    zSeries Application Assist
                                                    (zAAP) X'03' - Integrated
                                                    Facility for Linux (IFL) X'04'
                                                    - Internal Coupling Facility
                                                    (ICF) X'05' - zSeries
                                                    Integrated Information (zIIP)
    129  81  Character    3  *                      Reserved for IBM use
    132  84  Character    0  STOSXP_END

    MRSTOSXP 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
    STOSXP                     0    132
    STOSXP_END                84      0
    STOSXP_MRHDR               0      0
    STOSXP_PFXCPUAD           14      2
    STOSXP_PFXCPUTY           80      1
    STOSXP_PLSSAPUC           30      4
    STOSXP_PLSSAQMT           34      4
    STOSXP_PLSSARTC           2C      4
    STOSXP_PLSSATKC           28      4
    STOSXP_PLSSBPUC           40      4
    STOSXP_PLSSBQMT           44      4
    STOSXP_PLSSBRTC           3C      4
    STOSXP_PLSSBTKC           38      4
    STOSXP_PLSSPDQC           68      4
    STOSXP_PLSSPGBD           64      4
    STOSXP_PLSSPGFD           60      4
    STOSXP_PLSSPGPD           5C      4
    STOSXP_PLSSPNDF           58      4
    STOSXP_PLSSPNDP           54      4
    STOSXP_PLSSUPUC           20      4
    STOSXP_PLSSUQMT           24      4
    STOSXP_PLSSURTC           1C      4
    STOSXP_PLSSUTKC           18      4
    STOSXP_PLSSXADC           4C      4
    STOSXP_PLSSXAFC           74      4
    STOSXP_PLSSXALD           7C      4
    STOSXP_PLSSXALS           48      4
    STOSXP_PLSSXASC           50      4
    STOSXP_PLSSXCSP           78      4
    STOSXP_PLSSXIPC           6C      4
    STOSXP_PLSSXNST           70      4

    This information is
    based on z/VM V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009