RSMDATA REALFRAME subcommand output

The RSM real frame report (Figure 1) provides information about real frames in central storage. The report displays information about each frame's status, location, and current, or most recent owner. For an RSMDATA REALFRAME subcommand, the report is sorted by the ASID of the current (or most recent) owner of the frame. For an RSMDATA REALFRAME ALL subcommand, the report is sorted by frame number. The numbers in the top section of the report are hexadecimal. The totals at the bottom of the report are decimal.

Figure 1. Example: A portion of the RSMDATA REALFRAME subcommand output (1 of 2)
                                     R S M   R E A L   S T O R A G E   F R A M E   R E P O R T                  
                                                                                                                
   R FRM STATUS   JOBNAME  ASID DSP NAME      PAGE ID       P E D R PAGE I/O UI FIX   DG           DG       DG  
-------- -------- -------- ---- -------- ------------------ - - - - -------- -- ----- -----------  -------- ----
⋮  
0068A782 ALLOC    AXR05    0124 -        00000000_7F01E000  N N N D -        00 0000     1A29E080  00000000 0000
Start of change004F6D4C ALLOC    AXR05    0124 -        00000000_29468000f N N N E -        00 0000     13DB5300  00000000 0000
00542074 ALLOC    AXR05    0124 -        00000000_2946D000f N N N E -        00 0000     15081D00  00000000 0000
006155EE ALLOC    AXR05    0124 -        00000000_29469000f N N N E -        00 0000     18557B80  00000000 0000End of change
00569D1F ALLOC    AXR05    0124 -        00000000_29473000  N N N E -        00 0000     15A747C0  00000000 0000
005452E1 ALLOC    AXR05    0124 -        00000000_29474000  N N N E -        00 0000     1514B840  00000000 0000
004C9BB3 ALLOC    AXR05    0124 -        00000000_29475000  N N N E -        00 0000     1326ECC0  00000000 0000
Start of change00514F10 ALLOC    AXR05    0124 -        00000000_29476000f N N N E -        00 0000     1453C400  00000000 0000
0056A15A ALLOC    AXR05    0124 -        00000000_29477000f N N N E -        00 0000     15A85680  00000000 0000End of change
006E66CF ALLOC    AXR05    0124 -        00000000_006BA000  N N N E -        00 0000     1B99B3C0  00000000 0000
00576FD3 ALLOC    AXR05    0124 -        00000000_006B9000  N N N E -        00 0000     15DBF4C0  00000000 0000
005BF9EA ALLOC    AXR05    0124 -        00000000_006B8000  N N N E -        00 0000     16FE7A80  00000000 0000
Start of change00619441 ALLOC    AXR05    0124 -        00000000_2945A000f N N N E -        00 0000     18651040  00000000 0000End of change
0050FE92 ALLOC    AXR05    0124 -        00000008_00400000  N N N E -        00 0000     143FA480  00000000 0000
005D8857 ALLOC    AXR05    0124 -        00000008_00500000  N N N E -        00 0000     176215C0  00000000 0000
003938BA ALLOC    AXR05    0124 -        00000008_00600000  Y N N E -        00 0000     0E4E2E80  00000000 0000
0045620E ALLOC    AXR05    0124 -        00000008_00800000  N N N E -        00 0000     11588380  00000000 0000
0057A7A8 ALLOC    AXR05    0124 -        00000008_008FF000  N N N E -        00 0000     15E9EA00  00000000 0000
0055EF61 ALLOC    AXR05    0124 -        00000008_00900000  N N N E -        00 0000     157BD840  00000000 0000
006FDEF2 ALLOC    AXR05    0124 -        00000008_00A00000  N N N E -        00 0000     1BF7BC80  00000000 0000
0056EBDF ALLOC    AXR05    0124 -        00000008_00AFF000  N N N E -        00 0000     15BAF7C0  00000000 0000
00527CF2 ALLOC    AXR05    0124 -        00000008_00B00000  N N N E -        00 0000     149F3C80  00000000 0000
001FB09F ALLOC    AXR05    0124 -        00000008_00C00000  Y N N E -        00 0000     07EC27C0  00000000 0000
0037FE37 ALLOC    AXR05    0124 -        00000008_00CFF000  Y N N E -        00 0000     0DFF8DC0  00000000 0000
                                                                                                                
                                                                                                                
   R FRM STATUS   JOBNAME  ASID DSP NAME      PAGE ID       P E D R PAGE I/O UI FIX   DG           DG       DG  
-------- -------- -------- ---- -------- ------------------ - - - - -------- -- ----- -----------  -------- ----
0066A4BD ALLOC    AXR05    0124 -        00000008_00CFE000  N N N E -        00 0000     19A92F40  00000000 0000
0062586D ALLOC    AXR05    0124 -        00000008_00D00000  N N N E -        00 0000     18961B40  00000000 0000
0068603C ALLOC    AXR05    0124 -        00000008_00400000d N N N E -        00 0001i    1A180F00  00000000 0000
006103F8 ALLOC    AXR05    0124 -        00000008_00500000d N N N E -        00 0001i    1840FE00  00000000 0000
00336442 ALLOC    AXR05    0124 -        00000008_00600000d Y N N E -        00 0001i    0CD91080  00000000 0000
00586E2B ALLOC    AXR05    0124 -        00000008_00800000d N N N E -        00 0002i    161B8AC0  00000000 0000
0045BF7A ALLOC    AXR05    0124 -        00000008_00900000d N N N E -        00 0001i    116FDE80  00000000 0000
0068F6E1 ALLOC    AXR05    0124 -        00000008_00A00000d N N N E -        00 0002i    1A3DB840  00000000 0000
005A10A9 ALLOC    AXR05    0124 -        00000008_00B00000d N N N E -        00 0001i    16842A40  00000000 0000
0059F63A ALLOC    AXR05    0124 -        00000008_00C00000d N N N E -        00 0003i    167D8E80  00000000 0000
004DDBBF ALLOC    AXR05    0124 -        00000008_00D00000d N N N E -        00 0001i    1376EFC0  00000000 0000
009F5228 ALLOC    AXR05    0124 -        00000000_00000000d N N Q E -        00 0022i    27D48A00  00000000 0000
009F5229 ALLOC    AXR05    0124 -        00000000_00000000d N N Q E -        00 0000i    27D48A40  00000000 0000
009F522A ALLOC    AXR05    0124 -        00000000_00000000d N N Q E -        00 0000i    27D48A80  00000000 0000
009F522B ALLOC    AXR05    0124 -        00000000_00000000d N N Q E -        00 0000i    27D48AC0  00000000 0000
009F7EDC ALLOC    AXR05    0124 -        00000008_00000000d N N Q E -        00 0009i    27DFB700  00000000 0000
009F7EDD ALLOC    AXR05    0124 -        00000008_00000000d N N Q E -        00 0000i    27DFB740  00000000 0000
009F7EDE ALLOC    AXR05    0124 -        00000008_00000000d N N Q E -        00 0000i    27DFB780  00000000 0000
009F7EDF ALLOC    AXR05    0124 -        00000008_00000000d N N Q E -        00 0000i    27DFB7C0  00000000 0000
0041EF0D ALLOC    AXR05    0124 -        00000000_7FF16000  N N N E -        00 0000i    107BC340  00000000 0000
0054B6EF ALLOC    AXR05    0124 -        00000000_7FF15000  N N N E -        00 0000i    152DBBC0  00000000 0000
0047F887 ALLOC    AXR05    0124 -        00000000_7FF14000  N N N E -        00 0000i    11FE21C0  00000000 0000
009F804C ALLOC    AXR05    0124 -        00000000_7FF09000  N N Q E -        00 0000i    27E01300  00000000 0000
009F804D ALLOC    AXR05    0124 -        00000000_7FF0A000  N N Q E -        00 0000i    27E01340  00000000 0000
009F804E ALLOC    AXR05    0124 -        00000000_7FF0B000  N N Q E -        00 0000i    27E01380  00000000 0000

⋮
Figure 2. Example: A portion of the RSMDATA REALFRAME subcommand output (2 of 2)
⋮  

R FRM STATUS   JOBNAME  ASID DSP NAME      PAGE ID       P E D R PAGE I/O UI FIX   DG           DG       DG 
-------- -------- -------- ---- -------- ------------------ - - - - -------- -- ----- -----------  -------- ----
0006B4FD ALLOC    AXR05    0124 -        00000000_7EEAF000  Y N N E -        00 0000i    01AD3F40  00000000 0000
000683B1 ALLOC    AXR05    0124 -        00000000_7EEAA000  Y N N E -        00 0000i    01A0EC40  00000000 0000
0006C39F ALLOC    AXR05    0124 -        00000000_7EEAB000  Y N N E -        00 0000i    01B0E7C0  00000000 0000
0006955E ALLOC    AXR05    0124 -        00000000_7EED7000  Y N N E -        00 0000i    01A55780  00000000 0000
0006BF9D ALLOC    AXR05    0124 -        00000000_7EED8000  Y N N E -        00 0000i    01AFE740  00000000 0000

⋮  

 Totals for this real frame report (in decimal 4K units):              
                                                                       
         ALLOC       ALLOCVR       ALLOC1M         AVAIL       AVAIL1M 
           758             0             0             0             0 
                                                                       
       POLLUTE         VRINT       ALLOC2G       AVAIL2G    Start of changeFREEMAINEDEnd of change 
             0             0             0             0            Start of change40End of change 
                                                                       
       OFFLINE        OFFINT      OFFINTVR      OFFINTPL          TOTAL
             0             0             0             0            758

The fields in the report are:

R FRM
The real frame number. To obtain the real address of the frame, add three zeros to the right of the frame number.
STATUS
The status of the real frame:
ALLOC
Allocated 4K frame.
ALLOCSM
Frame is backing a page that is part of a shared segment.
ALLOCVR
Allocated to a V=R job that is running or waiting for additional frames.
ALLOC2G
Allocated 2G frame.
AVAIL
Available 4K frame.
AVAIL2G
Available 2G frame.
OFFINT
Offline intercepted. When freed from its current owner, the frame will be taken offline. This status overrides any pending interceptions for a V=R job.
OFFINTPL
Offline intercepted, but the frame is in use by a job that is polluting the V=R area with a long-term resident page.
OFFINTVR
Offline intercepted, but the frame is allocated to a V=R job.
OFFLINE
Offline.
POLLUTE
The frame is part of the V=R area, but is allocated to a long-term resident that is not a V=R page.
VRINT
V=R intercepted. When freed from its current owner, the frame will be assigned to a waiting V=R job.
ALLOC1M
Allocated 1M frame.
AVAIL1M
Available 1M frame.
JOBNAME
One of the following:
  • The name of the current frame owner.
  • The name of the most recent frame owner, when the STATUS is AVAIL or OFFLINE.
    DATOFF
    A permanently resident frame that contains a portion of the DAT-off nucleus.
    FIXCOMM
    A frame that backs a page from the system queue area (SQA) or the fixed common service area (CSA).
    FLPA
    A frame that backs a permanently resident common area page that contains a portion of the fixed link pack area.
    HSA
    A permanently resident frame that contains a portion of the hardware system area.
    HVCOMN
    A frame that backs a page from high virtual common.
    HVSHARED
    An indication that the data in the central storage frame is shared through the IARV64 macro.
    PAGECOMM
    A frame that backs a page from a pageable common area subpool (including common area disabled reference subpools), the pageable link pack area (PLPA), or the modified link pack area (MLPA).
    PERMCOMM
    A frame that backs a permanently resident common area page.
    RONUC
    A frame that backs a permanently resident common area page that contains a portion of the read-only nucleus.
    RSBUFFER
    A frame that is reserved for use as a central storage buffer for SVC dump processing.
    RWNUC
    A frame that backs a permanently resident common area page that contains a portion of the read-write nucleus.
    SADMP
    A frame that was claimed by stand-alone dump on an SADMP IPL previous to the one that created this dump.
    *SHARED*
    An indication that the data in the central storage frame is shared through the IARVSERV macro.
    SQARESRV
    A frame that is reserved for potential SQA usage.
ASID
The address space identifier (ASID) of the current frame owner or, if the STATUS is AVAIL or OFFLINE, the most recent frame owner. A dash (–) indicates that the frame is in the common area or the high virtual shared area.
DSP NAME
The name of the data space that contains the page. A dash (–) indicates that the page is not within a data space.
PAGE ID
The virtual address of the current, or most recent, page residing in the real frame. The page ID is the shared page token, if *SHARED* appears in the JOBNAME column. (The shared page token appears in the Shared Data Report in the SH TOKEN column.)
  • A d after the entry indicates that the frame is backing a high virtual DAT structure (region table, segment table, page table). When the frame is backing a high virtual DAT structure, the PAGE ID contains the lowest VSA for which the table provides translation.
  • Start of changeAn f after the entry indicates that the frame is backing a page that is freemained. See z/OS MVS Initialization and Tuning Guide for a description of this type of frame.End of change
  • A v after the entry indicates that the page is a virtual input/output (VIO) page and the entry contains a VIO token that represents the individual page within the VIO data set. A VIO page is not always marked with a v.
P
An indication of the storage area for the frame. In general, this indicator is relevant only when the RSU system parameter, which defines the number of reconfigurable storage units, is non-zero.
Y
The frame is in the preferred area
N
The frame is in the non-preferred area
E
An indication of an error, if any, that occurred on the frame:
N
No errors occurred
C
One or more correctable hardware errors occurred
U
One or more uncorrectable hardware errors occurred
S
A software error occurred
D
An indication of the frame use:
Y
The frame is intended for use in a double-frame pair. (Only for ESA/390 dumps)
N
The frame is not intended for use in a double-frame pair nor intended for use in a quad-frame group for z/Architecture dumps.
Q
The frame is intended for use as part of a quad-frame group for z/Architecture dumps.
D
The frame is intended for use as part of a double-frame pair for z/Architecture dumps.
The frame may not be currently in use as a double-frame pair or quad-frame group.
R
An indication of the page backed by the frame:
E
The frame backs an enabled reference page
D
The frame backs a disabled reference page
PAGE I/O
The name of the function that initiated the active I/O for the frame. A dash (-) indicates that I/O is not active for the frame.
ASPCREAT
Address space create
CHGKEY
Change key service (CHANGKEY macro)
COPYSERV
COPYSERV function.
COPYSRVH
High virtual copy service
COUNTS
RSM event and resource count service
DFSTEAL
Double frame steal
DIVACCUN
DIV ACCESS and DIV UNACCESS services
DIVMAP
Data-in-virtual MAP service
DIVMAPLV
Data-in-virtual MAP service with LOCVIEW = MAP processor
DIVRES
Data-in-virtual RESET service
DIVRESLV
Data-in-virtual RESET service with LOCVIEW = MAP processor
DIVRTR
Data-in-virtual router
DIVSAVE
Data-in-virtual SAVE service
DIVSLIST
DIV SAVELIST
DIVUNMAP
Data-in-virtual UNMAP service
DSPCONV
Data space convert services
DSPCREAT
Data space create
DSPDELET
Data space delete
DSPDRFOF
Data space define DREF off
DSPDRFON
Data space define DREF on
DSPSRTRD
Data space services router (DSPSERV macro) for disabled callers
DSPEXTEN
Data space extend service
DSPIOOF
Data space define I/O off
DSPIOON
Data space define I/O on
DSPLIMIT
Data space limit services
DSPLOAD
Data space load
DSPOUT
Data space out
DSPREL
Data space release
DSPSRTR
Data space services router (DSPSERV macro)
DUMPSERV
Dump services
FLTADPAG
Address space disabled page fault
FLTAEPAG
Address space enabled page fault
FLTAESEG
Address space enabled segment fault
FLTAHPAG
Address space page faults for address above the 2 gigabytes bar
FLTAHSEG
Address space segment faults for addresses above the 2 gigabytes bar
FLTAREGN
Address space region faults
FLTATYPE
Address space type faults
FLTDDIS
Data space disabled fault
FLTDEN
Data space enabled fault
FLTEPROT
Enabled protection fault
FREEFRAM
Free frame service
GENDEFER
General defer processor (handles requests waiting for frames to become available)
GENIOCMP
General I/O completion (handles paging I/O completion)
GENTERM
General abend (handles clean-up for RB, task, or address space abend)
GLRUSTL
Global LRU steal
HSPCACHE
Hiperspace™ cache services, that is, the HSPSERV macro with a CREAD or CWRITE parameter
HSPSCROL
Hiperspace scroll services, that is, the HSPSERV macro with an SREAD or SWRITE parameter
MACHCHK
Storage machine check handler
MIGRAT
Migration from expanded storage to auxiliary storage
NIP
RSM system initialization routines
PER
Program event recording support
PGANY
Page any
PGFIX
Page fix
PGFREE
Page free
PGLOAD
Page load
PGOUT
Page out
PGPROT
PGSER PROTECT service
PGREL
Page release
PGSRTR
Paging services router (PGSER macro)
PGUNPROT
PGSER UNPROTECT service
QFSTEAL
Quad frame steal
REALSWAP
In-real swap
RECONFIG
Real storage reconfiguration processing
RECOVERY
RSM recovery
RECREC
Recovery for RSM recovery
REFINST
REFPAT install
REFPAT
REFPAT router
REFREM
REFPAT remove
RPBPMGT
RSM request buffer management
RSMPIN
RSMPIN services
SRMEXIT
SRM exit call
SSPASSIG
Subspace assign
SSPCONV
Subspace convert
SSPCREAT
Subspace create
SSPDELET
Subspace delete
SSPIDENT
Subspace identify
SSPSRTR
Subspace router
SSPUNAS
Subspace unassign
SSPUNID
Subspace unidentify
SWAPIN
Swap in
SWAPOUT
Swap out
TRACE
RSM component trace service
UIC
Unreferenced interval count (UIC) update or steal
UMCPU
Free CPU related frames
V6CHACC
IARV64 CHANGEACCESS service
V6CHGURD
IARV64 CHANGEGUARD service
V6DETACH
IARV64 DETACH service
V6DISCAR
IARV64 DISCARDDATA service
V6GETSHR
IARV64 GETSHARES service
V6GETSTR
IARV64 GETSTOR service
V6LIST
IARV64 LIST service
V6PAGFIX
IARV64 PAGEFIX service
V6PAGIN
IARV64 PAGEUNFIX service
V6PAGOUT
IARV64 PAGEOUT service
V6PAGUNF
IARV64 PAGEUNFIX service
V6ROUTR
IARV64 service router
V6SHMOMB
IARV64 SHARMEMOBJ service
VFETCH
Virtual fetch services
VIO
VIO services
VR
V=R services
VSMFRMN
FREEMAIN processing
VSMGTMN
GETMAIN processing
VSCHGACC
IARVSERV CHANGEACCESS service
VSROUTR
IARVSERV router
VSSHARE
IARVSERV SHARE service
VSUNSHAR
IARVSERV UNSHARE service
WAITSER
RSM wait services
XFINDPAGE
Find page information service
XMPOST
RSM cross memory POST service
UI
The unreferenced interval count (UIC) for the page residing in the frame. The higher the UIC, the longer the page has been unreferenced.
FIX
The fix count for the page residing in the frame. An i at the end of the entry indicates that the page is implicitly fixed. Examples of implicitly fixed pages are permanently assigned pages and pages residing in fixed subpools.
DG
Diagnostic data useful to IBM.
Totals for this real frame report (in decimal):
These totals are located at the end of the report.
The total number, in decimal, is recorded for the real frames that are in the following states: ALLOC, ALLOCVR, ALLOC1M, Start of changeALLOC2G,End of change AVAIL, AVAIL1M, Start of changeAVAIL2G,End of change Start of changeFREEMAINED,End of change OFFLINE, OFFINT, OFFINTVR, OFFINTPL, POLLUTE, or VRINT. These states are described in the STATUS field. A dash (–) indicates that real frames for that STATUS were not selected for the report.
Note: When frames that are allocated to shared segments (ALLOCSM) are included in the report, their total number will be included in the ALLOC total.
The total number, in decimal, of frames evaluated in the report is recorded in the TOTAL field.
Parent topic: Real Storage Manager (RSM)