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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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 V7R2.0.

    Last updated on 08 August 2020 at 15:04:11.

    Copyright IBM Corporation, 1990, 2020