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  128  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  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    128
STOSXP_END                80      0
STOSXP_MRHDR               0      0
STOSXP_PFXCPUAD           14      2
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 V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005