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  424  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
      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  STORSP_PFXCPUAD        Processor address
     22  16  Unsigned     2  *                      Reserved for IBM use
     24  18  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFRECT)
     28  1C  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFRET)
     32  20  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSPGXTD)
     36  24  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFSPCT)
     40  28  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSDXFRE)
     44  2C  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFVRRQ)
     48  30  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFVRCT)
     52  34  Unsigned     4  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (STORSP_PLSFVRLS)
     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 <2G
                                                    available list. See
                                                    STORSP_PLSRETFG for the >2G
                                                    value.
     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 <2G available list.
                                                    See STORSP_PLSALNCG for the >2G
                                                    value.
     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  Unsigned     4  STORSP_PLSALNCG        Number of frames obtained
                                                    from the >2G available list.
                                                    See See STORSP_PLSALNCT for the
                                                    <2G value.
    248  F8  Unsigned     4  STORSP_PLSRETFG        Total number of frames that
                                                    are returned to the >2G
                                                    available list. See
                                                    STORSP_PLSRETFR for the <2G
                                                    value.
    252  FC  Unsigned     4  STORSP_PLSFSPRB        Total number of free storage
                                                    pages returned backed below 2G.
    256 100  Unsigned     4  STORSP_PLSFSPRA        Total number of free storage
                                                    pages returned backed above 2G.
    260 104  Unsigned     4  STORSP_PLSFSCTB        Count of free storage obtains
                                                    backed below 2G.
    264 108  Unsigned     4  STORSP_PLSFSCTA        Count of free storage obtains
                                                    backed above 2G.
    268 10C  Unsigned     4  STORSP_PLSFRETB        Count of free storage returns
                                                    backed below 2G.
    272 110  Unsigned     4  STORSP_PLSFRETA        Count of free storage returns
                                                    backed above 2G.
    276 114  Unsigned     4  STORSP_PLSFSSGB        Count of regular free storage
                                                    obtains backed below 2G.
    280 118  Unsigned     4  STORSP_PLSFSSGA        Count of regular free storage
                                                    obtains backed above 2G.
    284 11C  Unsigned     4  STORSP_PLSFSPGB        Count of free storage page
                                                    requests backed below 2G.
    288 120  Unsigned     4  STORSP_PLSFSPGA        Count of free storage page
                                                    requests backed any.
    292 124  Unsigned     4  STORSP_PLSBGCNT        Number of times the
                                                    background replenishment of the
                                                    Cleared Global Available List
                                                    has run.
    296 128  Character    8  STORSP_PLSFGCTM        Amount of time spent
                                                    performing foreground
                                                    replenishment of the Cleared
                                                    Global Available List.
    304 130  Unsigned     4  STORSP_PLSFGCNT        Number of times foreground
                                                    replenishment of the Cleared
                                                    Global Available List has run.
    308 134  Unsigned     4  STORSP_PLSFOBEM        Unsigned count of times the
                                                    FCP Operations Block (FOB) list
                                                    for this processor was empty
                                                    when a FOB was requested since
                                                    the list was last trimmed.
    312 138  Unsigned     4  STORSP_PLSFSSRA        Count of regular subpool free
                                                    storage returns backed >2G.
    316 13C  Unsigned     4  STORSP_PLSFSSRB        Count of regular subpool free
                                                    storage returns backed <2G.
    320 140  Unsigned     4  STORSP_PLSVATCL        Count of guest virtual to
                                                    host logical address
                                                    translations.
    324 144  Unsigned     4  STORSP_PLSUPAGE        Number of Collaborative
                                                    Memory Management unused pages
                                                    stolen.
    328 148  Unsigned     4  STORSP_PLSVPAGE        Number of Collaborative
                                                    Memory Management volatile
                                                    pages stolen
    332 14C  Unsigned     4  STORSP_PLSPCPAG        Number of Collaborative
                                                    Memory Management
                                                    potentially-volatile changed
                                                    pages stolen.
    336 150  Unsigned     4  STORSP_PLSPUPAG        Number of Collaborative
                                                    Memory Management
                                                    potentially-volatile unchanged
                                                    pages stolen.
    340 154  Unsigned     4  STORSP_PLSUPREC        Number of Collaborative
                                                    Memory Management unused user
                                                    state pages released by
                                                    reorder.
    344 158  Unsigned     4  STORSP_PLSESSA         ESSA instruction count
    348 15C  Unsigned     4  STORSP_PLSLTDPE        Number of long term dormant
                                                    emergency passes.
    352 160  Unsigned     4  STORSP_PLSASFCL        Count of times a single frame
                                                    request <2G took a frame from
                                                    the <2G contiguous frame
                                                    available list.
    356 164  Unsigned     4  STORSP_PLSASFCG        Count of times a single frame
                                                    request >2G took a frame from
                                                    the >2G contiguous frame
                                                    available list.
    360 168  Unsigned     1  STORSP_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)
    361 169  Character    3  *                      Reserved for IBM use
    364 16C  Character   60  *                      QDIO stats
    364 16C  Unsigned     4  STORSP_PFXAFOBC        Local List (LL) count of FOBs
    368 170  Unsigned     4  STORSP_PLSFOBLO        LL low threshold
    372 174  Unsigned     4  STORSP_PLSFOBHI        LL high threshold
    376 178  Character    8  STORSP_PLSFOB1E        count of times LL found empty
    384 180  Character    8  STORSP_PLSFOB1T        TOD 1st trim request for LL
    392 188  Character    8  STORSP_PLSFOBTM        TOD most recent trim req for
                                                    LL
    400 190  Character    8  *                      Reserved for IBM
    408 198  Character    8  *                      Reserved for IBM
    416 1A0  Character    8  *                      Reserved for IBM
    424 1A8  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    424
    STORSP_END               1A8      0
    STORSP_FSTPASS            60     24
    STORSP_FSTPFRM            9C     24
    STORSP_MRHDR               0      0
    STORSP_PFXAFOBC          16C      4
    STORSP_PFXCLEAR           40      4
    STORSP_PFXCPUAD           14      2
    STORSP_PFXCPUTY          168      1
    STORSP_PFXPTRCT           44      4
    STORSP_PLSALNCG           F4      4
    STORSP_PLSALNCT           54      4
    STORSP_PLSASFCG          164      4
    STORSP_PLSASFCL          160      4
    STORSP_PLSBGCNT          124      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_PLSELGPE           D8      4
    STORSP_PLSELGP1           B0      4
    STORSP_PLSELGP2           C4      4
    STORSP_PLSELIGE           90      4
    STORSP_PLSELIG1           70      4
    STORSP_PLSELIG2           80      4
    STORSP_PLSESSA           158      4
    STORSP_PLSFGCNT          130      4
    STORSP_PLSFGCTM          128      8
    STORSP_PLSFOBEM          134      4
    STORSP_PLSFOBHI          174      4
    STORSP_PLSFOBLO          170      4
    STORSP_PLSFOBTM          188      8
    STORSP_PLSFOB1E          178      8
    STORSP_PLSFOB1T          180      8
    STORSP_PLSFRETA          110      4
    STORSP_PLSFRETB          10C      4
    STORSP_PLSFSCTA          108      4
    STORSP_PLSFSCTB          104      4
    STORSP_PLSFSPGA          120      4
    STORSP_PLSFSPGB          11C      4
    STORSP_PLSFSPRA          100      4
    STORSP_PLSFSPRB           FC      4
    STORSP_PLSFSSGA          118      4
    STORSP_PLSFSSGB          114      4
    STORSP_PLSFSSRA          138      4
    STORSP_PLSFSSRB          13C      4
    STORSP_PLSLTDPE          15C      4
    STORSP_PLSLTDP1           9C      4
    STORSP_PLSLTDP2           B4      4
    STORSP_PLSLTD1            60      4
    STORSP_PLSLTD2            78      4
    STORSP_PLSPCPAG          14C      4
    STORSP_PLSPGDRD           EC      4
    STORSP_PLSPGDWT           F0      4
    STORSP_PLSPNEW            3C      4
    STORSP_PLSPREAD           38      4
    STORSP_PLSPUPAG          150      4
    STORSP_PLSRELES           48      4
    STORSP_PLSRELFR           50      4
    STORSP_PLSRETFG           F8      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_PLSUPAGE          144      4
    STORSP_PLSUPREC          154      4
    STORSP_PLSVATCL          140      4
    STORSP_PLSVPAGE          148      4
    STORSP_SECPASSE           88     20
    STORSP_SECPASSN           78     16
    STORSP_SECPEFRM           C8     20
    STORSP_SECPFRM            B4     20

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

    Last updated on 24 Nov 2009 at 13:21:24.

    Copyright IBM Corporation, 1990, 2009