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

#### MRSTORSP

Prolog
Control Block Contents
Cross Reference

#### MRSTORSP Prolog

####

####

     DSECT NAME - STORSP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTORSP
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3 - Storage Domain
                        Record 2 - Real Storage Activity (Per Processor)
     DESCRIPTION - Utilization of real memory on a processor basis.
                   This record is needed because free storage requests
                   are not expected to be evenly distributed across all
                   processors in a complex.  A separate record is
                   generated for each online processor.

    MRSTORSP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  244  STORSP              Start of monitor record
      0   0  Character    0  STORSP_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  STORSP_PFXCPUAD     Processor address
     22  16  Unsigned     2  *                   Reserved for IBM use
     24  18  Unsigned     4  STORSP_PLSFRECT     Count of requests to obtain free
                                                 storage
     28  1C  Unsigned     4  STORSP_PLSFRET      Count of free storage returns
     32  20  Unsigned     4  STORSP_PLSPGXTD     Count of free storage frame
                                                 requests
     36  24  Unsigned     4  STORSP_PLSFSPCT     Count of calls for free storage
                                                 that are satisfied from regular
                                                 free storage subpools
     40  28  Unsigned     4  STORSP_PLSDXFRE     Total number of regular free
                                                 storage frames returned
     44  2C  Unsigned     4  STORSP_PLSFVRRQ     Total number of V=R free storage
                                                 requests
     48  30  Unsigned     4  STORSP_PLSFVRCT     Count of calls for free storage
                                                 that are satisfied from V=R
                                                 subpools
     52  34  Unsigned     4  STORSP_PLSFVRLS     Total number of V=R requests
                                                 satisfied from V=R free storage,
                                                 but not from the V=R subpools
     56  38  Unsigned     4  STORSP_PLSPREAD     Total number of page
                                                 translations that resulted in a
                                                 page read
     60  3C  Unsigned     4  STORSP_PLSPNEW      Number of first-time referenced
                                                 page translations, including
                                                 fastpath page faults
     64  40  Unsigned     4  STORSP_PFXCLEAR     Number of first-time referenced
                                                 fastpath page faults
     68  44  Unsigned     4  STORSP_PFXPTRCT     Number of fast path page
                                                 translations
     72  48  Unsigned     4  STORSP_PLSRELES     Total number of times any
                                                 release function was performed.
                                                 Includes releasing any range of
                                                 virtual system pages as well as
                                                 shared pages
     76  4C  Unsigned     4  STORSP_PLSRETFR     Total number of frames that are
                                                 returned to the available list.
     80  50  Unsigned     4  STORSP_PLSRELFR     Total number of frames that are
                                                 returned by any release function
     84  54  Unsigned     4  STORSP_PLSALNCT     Number of frames obtained from
                                                 the available list
     88  58  Unsigned     4  STORSP_PLSSTLWT     Count of frame replacement
                                                 writes pending that are requested
                                                 by the available list
                                                 replenishment demand scan
     92  5C  Unsigned     4  *                   Reserved for IBM use
     96  60  Character   24  STORSP_FSTPASS
     96  60  Unsigned     4  STORSP_PLSLTD1      Count of times the demand scan
                                                 completed after the first pass of
                                                 the long term dormant list
    100  64  Unsigned     4  STORSP_PLSDORM1     Count of times the demand scan
                                                 completed after the first pass of
                                                 the dormant list
    104  68  Unsigned     4  *                   Reserved for IBM use
    108  6C  Unsigned     4  STORSP_PLSSHAR1     Count of times the demand scan
                                                 completed after the first scan of
                                                 the system VMDBK, NSSs, DCSSs and
                                                 shared address spaces
    112  70  Unsigned     4  STORSP_PLSELIG1     Count of times the demand scan
                                                 completed after the first scan of
                                                 the eligible list
    116  74  Unsigned     4  STORSP_PLSDISP1     Count of times the demand scan
                                                 completed after the first scan of
                                                 the dispatch list
    120  78  Character   16  STORSP_SECPASSN
    120  78  Unsigned     4  STORSP_PLSLTD2      Count of times the demand scan
                                                 completed after the second pass of
                                                 the long term dormant list
    124  7C  Unsigned     4  STORSP_PLSDORM2     Count of times the demand scan
                                                 completed after the second pass of
                                                 the dormant list
    128  80  Unsigned     4  STORSP_PLSELIG2     Count of times the demand scan
                                                 completed after the second scan of
                                                 the eligible list
    132  84  Unsigned     4  STORSP_PLSDISP2     Count of times the demand scan
                                                 completed after the second scan of
                                                 the dispatch list
    136  88  Character   20  STORSP_SECPASSE
    136  88  Unsigned     4  STORSP_PLSSHARE     Count of times the demand scan
                                                 completed after the emergency scan
                                                 of the system VMDBK, NSSs, DCSSs,
                                                 and shared address spaces
    140  8C  Unsigned     4  STORSP_PLSDORME     Count of times the demand scan
                                                 completed after the emergency pass
                                                 of the dormant list
    144  90  Unsigned     4  STORSP_PLSELIGE     Count of times the demand scan
                                                 completed after the emergency scan
                                                 of the eligible list
    148  94  Unsigned     4  *                   Reserved for IBM use
    152  98  Unsigned     4  STORSP_PLSDISPE     Count of times the demand scan
                                                 completed after the emergency scan
                                                 of the dispatch list
    156  9C  Character   24  STORSP_FSTPFRM
    156  9C  Unsigned     4  STORSP_PLSLTDP1     Number of frames taken from the
                                                 long term dormant users in pass 1
                                                 of the demand scan.
    160  A0  Unsigned     4  STORSP_PLSDRMP1     Number of frames taken from the
                                                 dormant users in pass 1 of the
                                                 demand scan
    164  A4  Unsigned     4  STORSP_PLSSHRP1     Number of frames taken from NSSs
                                                 and DCSSs in pass 1 of the demand
                                                 scan
    168  A8  Unsigned     4  *                   Reserved for IBM use
    172  AC  Unsigned     4  STORSP_PLSDSPP1     Number of frames taken from the
                                                 dispatch users in pass 1 of the
                                                 demand scan
    176  B0  Unsigned     4  STORSP_PLSELGP1     Number of frames taken from the
                                                 eligible users in pass 1 of the
                                                 demand scan
    180  B4  Character   20  STORSP_SECPFRM
    180  B4  Unsigned     4  STORSP_PLSLTDP2     Number of frames taken from the
                                                 long term dormant users in pass 2
                                                 of the demand scan
    184  B8  Unsigned     4  STORSP_PLSDRMP2     Number of frames taken from the
                                                 dormant users in pass 2 of the
                                                 demand scan
    188  BC  Unsigned     4  STORSP_PLSSHRP2     Number of frames taken from NSSs
                                                 and DCSSs in pass 2 of the demand
                                                 scan.
    192  C0  Unsigned     4  STORSP_PLSDSPP2     Number of frames taken from the
                                                 dispatch users in pass 2 of the
                                                 demand scan.
    196  C4  Unsigned     4  STORSP_PLSELGP2     Number of frames taken from the
                                                 eligible users in pass 2 of the
                                                 demand scan.
    200  C8  Character   20  STORSP_SECPEFRM
    200  C8  Unsigned     4  STORSP_PLSDRMPE     Number of frames taken from the
                                                 dormant users in pass E of the
                                                 demand scan
    204  CC  Unsigned     4  STORSP_PLSSHRPE     Number of frames taken from NSSs
                                                 and DCSSs in pass E of the demand
                                                 scan
    208  D0  Unsigned     4  *                   Reserved for IBM use
    212  D4  Unsigned     4  STORSP_PLSDSPPE     Number of frames taken from the
                                                 dispatch users in pass E of the
                                                 demand scan
    216  D8  Unsigned     4  STORSP_PLSELGPE     Number of frames taken from the
                                                 eligible users in pass E of the
                                                 demand scan
    220  DC  Unsigned     4  *                   Reserved for IBM use
    224  E0  Unsigned     4  *                   Reserved for IBM use
    228  E4  Unsigned     4  *                   Reserved for IBM use
    232  E8  Unsigned     4  *                   Reserved for IBM use
    236  EC  Unsigned     4  STORSP_PLSPGDRD     Number of page table
                                                 translations that resulted in a
                                                 page read from auxiliary storage
                                                 (DASD)
    240  F0  Unsigned     4  STORSP_PLSPGDWT     Number of page tables paged to
                                                 auxiliary storage (DASD)
    244  F4  Character    0  STORSP_END

    MRSTORSP 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
    STORSP                  0    244
    STORSP_END             F4      0
    STORSP_FSTPASS         60     24
    STORSP_FSTPFRM         9C     24
    STORSP_MRHDR            0      0
    STORSP_PFXCLEAR        40      4
    STORSP_PFXCPUAD        14      2
    STORSP_PFXPTRCT        44      4
    STORSP_PLSALNCT        54      4
    STORSP_PLSDISPE        98      4
    STORSP_PLSDISP1        74      4
    STORSP_PLSDISP2        84      4
    STORSP_PLSDORME        8C      4
    STORSP_PLSDORM1        64      4
    STORSP_PLSDORM2        7C      4
    STORSP_PLSDRMPE        C8      4
    STORSP_PLSDRMP1        A0      4
    STORSP_PLSDRMP2        B8      4
    STORSP_PLSDSPPE        D4      4
    STORSP_PLSDSPP1        AC      4
    STORSP_PLSDSPP2        C0      4
    STORSP_PLSDXFRE        28      4
    STORSP_PLSELGPE        D8      4
    STORSP_PLSELGP1        B0      4
    STORSP_PLSELGP2        C4      4
    STORSP_PLSELIGE        90      4
    STORSP_PLSELIG1        70      4
    STORSP_PLSELIG2        80      4
    STORSP_PLSFRECT        18      4
    STORSP_PLSFRET         1C      4
    STORSP_PLSFSPCT        24      4
    STORSP_PLSFVRCT        30      4
    STORSP_PLSFVRLS        34      4
    STORSP_PLSFVRRQ        2C      4
    STORSP_PLSLTDP1        9C      4
    STORSP_PLSLTDP2        B4      4
    STORSP_PLSLTD1         60      4
    STORSP_PLSLTD2         78      4
    STORSP_PLSPGDRD        EC      4
    STORSP_PLSPGDWT        F0      4
    STORSP_PLSPGXTD        20      4
    STORSP_PLSPNEW         3C      4
    STORSP_PLSPREAD        38      4
    STORSP_PLSRELES        48      4
    STORSP_PLSRELFR        50      4
    STORSP_PLSRETFR        4C      4
    STORSP_PLSSHARE        88      4
    STORSP_PLSSHAR1        6C      4
    STORSP_PLSSHRPE        CC      4
    STORSP_PLSSHRP1        A4      4
    STORSP_PLSSHRP2        BC      4
    STORSP_PLSSTLWT        58      4
    STORSP_SECPASSE        88     20
    STORSP_SECPASSN        78     16
    STORSP_SECPEFRM        C8     20
    STORSP_SECPFRM         B4     20

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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003