RSMDATA subcommand — analyze real storage manager data
- Address spaces report
- Common Pools
- Data-in-virtual mapped range report
- Data space report
- Exception report
- Execution status report
- Expanded storage report
- High virtual common
- High virtual page report
- High virtual shared data report
- Real frames report
- RSM requests report
- RSM shared data report
- Subspace report
- Summary report
- Trace
- Virtual pages report
- Syntax
RSMDATA
-------- Report Type Parameters -----------------------------
{ ADDRSPACE } { DIVMAP } { DSPACE } { EXCEPTION } { EXECUTION } { EXPFRAME } { HIGHVIRTUAL} { HVSHRDATA } { HVCOMMON } { REALFRAME } { RSMREQ } { SHRDATA } { SUBSPACE } { SUMMARY } { VIRTPAGE }
-------- Data Selection Parameters -------------------------
[ COMMON ] [ DATASPACES ] [ DETAIL ] [ HVCOMM ] [ HVSHARED ] [ PERMCOMM ] [ RANGE(rangelist) ] [ SAVEAREA(address) ] [ SHARED ] [ SHORT ] [ STATUS(statuslist) ] [ TOKEN(token) ] [ TOTONLY ]
-------- Address Space Selection Parameters ----------------
[ ALL ] [ ASIDLIST(asidlist) ] [ CURRENT ] [ ERROR ] [ JOBLIST(joblist) | JOBNAME(joblist) ]
-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.[ ACTIVE | MAIN | STORAGE ] [ DSNAME(dsname) | DATASET(dsname) ] [ FILE(ddname) | DDNAME(ddname) ] [ PATH(path-name) ] [ FLAG(severity) ] [ PRINT | NOPRINT ] [ TERMINAL | NOTERMINAL ] [ TEST | NOTEST ]
- Report type parameters
Use these parameters to select the type of report. Specify only one; if you specify more than one, RSMDATA processes only the right-most parameter. If you omit a report type parameter, the default is SUMMARY.
Some of the selection parameters do not apply to all reports. Matrix of report type parameters and other parameters summarizes the parameters you can specify with a given report.- ADDRSPACE
- Requests the RSM address spaces report. This report summarizes
real storage usage for specified address spaces. The report is sorted
by ASID.
Usage note: The only data selection parameters that apply to this report are STATUS, SHORT, and TOTONLY.
- DIVMAP
- Requests the data-in-virtual mapped range report. This report
displays information relating to areas of storage that are identified
to data-in-virtual and that have been mapped. The information is sorted
by address space identifier (ASID) and by the status of each data-in-virtual
mapped range.
Usage note: The only data selection parameters that apply to this report are STATUS and TOTONLY.
- DSPACE
- Requests the data space report. This report displays information
about all data spaces in the system. All installation-defined and
RSM-defined data spaces are summarized.
Usage note: The only data selection parameter that applies to this report is TOTONLY.
- EXCEPTION
- Requests the RSM diagnostics report. This report verifies RSM
global data structures and generates information about areas that
are in error. You can also request verification of local data structures
for specific address spaces using address space selection parameters.
Usage note: The only data selection parameters that apply to this report are DATASPACES and SAVEAREA.
Note: The EXCEPTION report might take an excessive amount of time to run when one or both of these conditions is true:- You specify more than 3 address spaces.
- You have specified DATASPACES and any of the specified address space owns more than 3 data spaces.
You might consider submitting a batch job to obtain an EXCEPTION report under these circumstances.
- EXECUTION
- Requests the RSM execution status report. This report contains
information for IBM® internal
use. IBM might ask you to run
this report for use in problem determination.
Usage note: The only data selection parameter that applies to this report is SAVEAREA. Address space selection parameters do not apply to this report.
- HVCOMMON
- Requests the high virtual common report. This report displays
the status of high virtual common memory objects including owner,
size, and status.
Usage note: The only selection parameter that applies to this report is RANGE.
- HIGHVIRTUAL
- Requests the high virtual page report. This report identifies
the page owner, the location and status for virtual pages in the system
that are above 2 Gigabytes, and a summary of the memory objects.
Usage note: The only data selection parameters that apply to this report are RANGE, STATUS, and TOTONLY.
Note: The VIRTPAGE report might take an excessive amount of time to run when large ranges are specified. - HVSHRDATA
- Requests the high virtual shared data report. This report provides
information about virtual storage above 2 gigabytes that is shared
using the IARV64 macro.
Usage note: The only data selection parameters that apply to this report are RANGE and DETAIL.
- REALFRAME
- Requests the real frame report. This report displays information
about each frame's status, location, and current/most recent owner.
The information is sorted by the ASID of the current/most recent
owner unless you specify the ALL address space selection parameter.
In this case the information is sorted by frame number.
Usage note: The only data selection parameters that apply to this report are COMMON, PERMCOMM, RANGE, SHARED, HVCOMM, HVSHARED, STATUS, and TOTONLY.
- RSMREQ
- Requests the RSM requests report. This report summarizes asynchronous
RSM activity in the system or for a particular job. It identifies
the requester, lists the request's status, and identifies the requested
pages for asynchronous requests.
Usage note: The only data selection parameters that apply to this report are COMMON, SHARED, HVCOMM, HVSHARED, STATUS, and TOTONLY.
- SHRDATA
- Requests the RSM shared data report. This report provides information
about the virtual storage locations that are defined as shared through
the IARVSERV macro.
Usage note: The only data selection parameters that apply to this report are COMMON, STATUS, TOKEN, and TOTONLY.
- SUBSPACE
- Requests the subspace report. This report displays information
about subspaces in an address space. The information is sorted by
ASID and, within the address space, by the address at the lower limit
of the range.
Usage note: The only data selection parameters that apply to this report are RANGE and STATUS.
- SUMMARY
- Requests the RSM summary report and is the default. This report
provides statistics about system-wide real and auxiliary storage usage.
It also contains information about any unusual RSM conditions that
exists in the dump.
Usage note: Data selection and address space parameters do not apply to this report.
- VIRTPAGE
- Requests the virtual page report. This report identifies the page
owner and its location and status for virtual pages in the system.
Usage note: The only data selection parameters that apply to this report are COMMON, DATASPACES, PERMCOMM, RANGE, STATUS and TOTONLY.
Note: The VIRTPAGE report might take an excessive amount of time to run when one or both of these conditions is true:- You specify more than 3 address spaces.
- You have specified DATASPACES and any of the specified address space owns more than 3 data spaces.
You might consider submitting a batch job to obtain a VIRTPAGE report under these circumstances.
- Matrix of report type parameters and other parameters The following two tables summarize for each report type use of address space selection parameters and data selection parameters.
Report Type Parameter ALL ASIDLIST CURRENT JOBLIST/ JOBNAME COMMON DATASPACES DETAIL HVCOMM HVSHARED PERMCOMM ADDRSPACE X DIVMAP X DSPACE X EXCEPTION X X EXECUTION HIGHVIRTUAL X HVCOMMON HVSHRDATA X REALFRAME X X X X X RSMREQ X X X X SHRDATA X X SUBSPACE X SUMMARY VIRTPAGE X X X X Report Type Parameter RANGE SAVE AREA SHARED STATUS TOKEN TOTONLY SHORT ADDRSPACE X X X DIVMAP X X DSPACE X EXCEPTION X EXECUTION X HIGHVIRTUAL X X X HVCOMMON X HVSHRDATA X REALFRAME X X X X RSMREQ X X X SHRDATA X X X SUBSPACE X X SUMMARY X VIRTPAGE X X X - Data selection parameters
Use these parameters to limit the scope of the data in the report.
Note: Common area data is not included when you specify ASIDLIST, JOBNAME, or JOBLIST. You need to specify COMMON or PERMCOMM with the report parameters that accept them if you want to see common area resources in the report. High virtual shared data is not included when you specify ASIDLIST, JOBNAME, or JOBLIST. You need to specify HVSHARED with the report parameters that accept them if you want to see high virtual shared resources in the report.- COMMON
- Requests that any non-permanently-assigned common area page found in CSA, SQA, PLPA, MLPA, or common disabled reference storage appear in the report. Use COMMON to select data in the EXPFRAME, REALFRAME, RSMREQ, SHRDATA, and VIRTPAGE reports.
- DATASPACES
- Requests information about data spaces for the VIRTPAGE and EXCEPTION reports. (For these reports, data space-related information will not appear unless you explicitly request it.)
- DETAIL
- Requests that more detailed information be reported. For the HVSHRDATA report this information includes the view of segments from each address space sharing the memory object. Use DETAIL with the HVSHRDATA report.
- HVCOMM
- Requests that the report contain information about data defined as high virtual common. Use HVCOMM to select data in the REALFRAME or RSMREQ reports.
- HVSHARED
- Requests that the report contain information about data defined as high virtual shared (shared storage above two gigabytes). Use HVSHARED to select data in the REALFRAME or RSMREQ reports.
- PERMCOMM
- Requests that permanently assigned pages in the nucleus, absolute frame zero, PSAs, HSA, or FLPA appear in the report. Use PERMCOMM to select data in the REALFRAME and VIRTPAGE reports.
- RANGE(rangelist)
- Specifies a range of real frames or virtual pages to include in
the report. Use RANGE with the REALFRAME, SUBSPACE, VIRTPAGE,
HIGHVIRTUAL, HVCOMMON, and HVSHRDATA reports.
The rangelist is one or more ranges. In each range, the lower and upper limits are separated by a colon character (:).
The value to specify for rangelist depends on the report:- Report Parameter
- Value for rangelist
- HIGHVIRTUAL
- Hexadecimal virtual addresses from 80000000 to FFFFFFFF_FFFFFFFF.
The default range for this report is 1_00000000:1_80000000. Note: Each range limit can be 17 characters each and may contain underscores.
- HVCOMMON
- Hexadecimal virtual addresses from 80000000 to FFFFFFFF_FFFFFFFF. The default range for this report is the defined common area for the system which is dumped.
- HVSHRDATA
- Hexadecimal virtual addresses from 80000000 to FFFFFFFF_FFFFFFFF. The default range for this report is the defined shared area for the system which is dumped.
- REALFRAME
- Hexadecimal real frame numbers from 0 to the number of real frames in the system (up to 8 hexadecimal digits).
- VIRTPAGE
- Hexadecimal virtual addresses from 0 to 7FFFFFFF.
- SUBSPACE
- Hexadecimal virtual addresses from 0 to 7FFFFFFF.
Note: Hexadecimal notation (X'n...') is optional, that is, 7FFF as opposed to X'7FFF'. - SAVEAREA(address)
- Requests that the report contain information about the RSM module save area at the specified address. Use SAVEAREA for the EXCEPTION and EXECUTION reports.
- SHARED
- Requests that the report contain information about data defined as shared. Use SHARED to select data in the REALFRAME and RSMREQ reports.
- SHORT
- Requests that the report contain abbreviated information that can be obtained quickly. Use SHORT to select data in the ADDRSPACE report.
- STATUS(statuslist)
- Requests that the report include the status of each object. The statuslist is a list of one or more object states, separated by blanks or commas. The following is a list of report parameters and the object states for each report. If you do not specify STATUS, the report will contain information about all possible states for a given object.
- Object states for ADDRSPACE report:
- NONSWAP
- Indicates that you want to see the address spaces that are non-swappable.
- RESWPIP
- Indicates that you want to see the address spaces that are in the process of in-real swap (real swap).
- SWAUX
- Indicates that you want to see the address spaces that are swapped to auxiliary storage.
- SWAUXIP
- Indicates that you want to see the address spaces that are in the process of being swapped to auxiliary storage.
- SWIN
- Displays the address spaces that are swapped in.
- SWINIP
- Displays the address spaces that are in the process of being swapped in.
- TERM
- Displays the address spaces that are in the process of terminating.
- Object states for DIVMAP report:
- MAPIP
- Displays the data-in-virtual mapped ranges that are involved in a DIV MAP request
- MAPRPIP
- Displays the data-in-virtual mapped ranges that are involved in a DIV MAP-reprime request
- UNMAPIP
- Displays the data-in-virtual mapped ranges that are involved in a DIV UNMAP request
- SAVEIP
- Displays the data-in-virtual mapped ranges that are involved in a DIV SAVE request
- RESETIP
- Displays the data-in-virtual mapped ranges that are involved in a DIV RESET request
- MAPPED
- Displays the data-in-virtual mapped ranges that are not involved in a DIV request
- Object states for HIGHVIRTUAL report:
- AUX
- Displays pages that have their most recent copies on a DASD paging data set or on storage-class memory (SCM).
- DASD
- Displays pages that have their most recent copies on a DASD paging data set.
- FREF
- Displays all 4 KB pages that are in first-reference
state. That is, one of the following conditions is true for a given
4 KB page:
- It was never referenced.
- It was released through the IARV64 macro.
- FRFM
- Displays all 1 MB pages that are in a first-reference
state. That is, one of the following conditions is true for a given
1 MB page:
- It was never referenced.
- It was released through the IARV64 macro.
- GUARD
- Displays pages that are in the guard area of a memory object.
- HIDE
- Displays pages that are hidden. Note: Hidden pages that are part of globally shared memory objects may not show up as hidden in this report. Run the HVSHRDATA report to see the global view of those memory objects.
- REAL
- Displays all 4 KB pages that reside in real storage. They are either valid or have output paging I/O in progress.
- RL_M
- Displays 1 MB pages that reside in real storage. They are either valid or have output paging I/O in progress.
- RL2G
- Displays 2 GB pages that reside in real storage.
- SCM
- Displays pages that have their most recent copies on storage-class memory (SCM).
- SCMM
- Displays 1 MB pages that have their most recent copies on storage-class memory (SCM).
- SIAI
- Displays pages that are in the process of being swapped in from auxiliary storage.
- SOAI
- Displays pages that are in the process of being swapped out to auxiliary storage.
- SWAX
- Displays pages that have their most recent copies swapped to auxiliary storage.
- Object states for REALFRAME report:
- ALLOC
- Displays the 4 KB frames that are allocated.
- ALLOC1M
- Displays the 1 MB pages that are allocated.
- ALLOC2G
- Displays the 2 GB pages that are allocated.
- ALLOCSM
- Displays only frames backing pages of shared segments.
- ALLOCVR
- Displays frames allocated to V=R jobs that are either running or waiting for additional frames.
- AVAIL
- Displays the 4 KB frames that are available.
- AVAIL1M
- Displays the 1 MB pages that are not allocated.
- AVAIL2G
- Displays the 2 GB pages that are not allocated.
- OFFINT
- Displays the frames that will be taken offline when freed from the current owner.
- OFFINTPL
- Displays the frames that are offline intercepted and currently in use by a job that is polluting the V=R area with a long term resident page.
- OFFINTVR
- Displays frames that are offline intercepted and allocated to a V=R job.
- OFFLINE
- Displays frames that are offline.
- POLLUTE
- Displays frames that are part of the V=R area, but are allocated to a long-term resident page that is not V=R.
- VRINT
- Displays frames that will be assigned to a waiting V=R job when freed from the current owner.
- Object states for RSMREQ report:
- CANCEL
- Displays any canceled requests.
- COMPLETE
- Displays non-fast path PGSER FIX requests that have completed and are awaiting the corresponding PGSER FREE request.
- DBLFRAME
- Displays requests that are waiting for a real frame pair.
- FAIL
- Displays requests that had failures other than I/O or cross memory access failures.
- FRAMEAA
- Displays requests that are waiting for any type of real frame.
- FRAMEAB
- Displays requests that are waiting for a real storage frame that resides below 16 megabytes.
- FRAMEPA
- Displays requests that are waiting for a real frame that resides in the preferred area.
- FRAMEPB
- Displays requests that are waiting for a real frame that resides in the preferred area below 16 megabytes.
- INPROGR
- Displays requests that are in progress. These requests may or may not be waiting for a frame or I/O. The presence or absence of other entries in this report for the same request indicates if a wait for a frame or I/O exists.
- IOFAIL
- Displays requests that had I/O failures.
- PGREAD
- Displays requests that are waiting for a page to be read in from a paging data set, or some other data set.
- PGWRITE
- Displays requests that are waiting for a page to be written to a paging data set or some other data set.
- XMFAIL
- Displays requests that had cross memory access errors.
- Object states for SHRDATA report:
- AUX
- Displays pages that have their most recent copies on a DASD paging data set or in storage-class memory (SCM).
- DASD
- Displays pages that have their most recent copies on a DASD paging data set.
- DSN
- Displays pages that have their most recent copies on a data set containing the data-in-virtual object of which the pages are a part.
- FREF
- Displays all 4 KB pages that were in a first-reference state.
That is, one of the following conditions is true for a given page:
- It was never referenced.
- It was released through the PGSER macro.
- It was released through the DSPSERV macro.
- REAL
- Displays all 4 KB pages that reside in real storage. They are either valid or have output paging I/O in progress.
- SCM
- Displays 4 KB pages that have their most recent copies on storage-class memory (SCM).
- Object states for SUBSPACE report:
- GLOBAL
- Displays the storage that is addressable by all subspaces within this address space.
- ASSIGN
- Displays the storage in this address space that is assigned to subspaces. In the report, the names of the subspaces to which the storage is assigned appear in the SSP NAME column.
- UNASSIGN
- Displays the storage in the address space that is not assigned to any subspace.
- Object states for VIRTPAGE report:
- AUX
- Displays pages that have their most recent copies on a DASD paging data set or in storage-class memory (SCM).
- DASD
- Displays pages that have their most recent copies on a DASD paging data set.
- DSN
- Displays pages that have their most recent copies on a data set containing the data-in-virtual object of which the pages are a part.
- FREF
- Displays all 4 KB pages that are in first-reference
state. That is, one of the following conditions is true for a given
4 KB page:
- It was never referenced.
- It was released through the PGSER macro.
- It was released through the DSPSERV macro.
- FRFM
- Displays all 1 MB pages that are in a first-reference
state. That is, one of the following conditions is true for a given
1 MB page:
- It was never referenced.
- It was released through the PGSER macro.
- MIG
- Displays pages for which both of the following conditions are
true:
- The most recent copies are migrated to auxiliary storage from expanded storage.
- The most recent copies reside in incorrect segments.
- REAL
- Displays all 4 KB pages that reside in real storage. They are either valid or have output paging I/O in progress.
- RL_M
- Displays 1 MB pages that reside in real storage. They are either valid or have output paging I/O in progress.
- SCM
- Displays pages that have their most recent copies on storage-class memory (SCM).
- SCMM
- Displays 1 MB pages that have their most recent copies on storage-class memory (SCM).
- SMEG
- Displays pages that are part of a shared segment.
- VIO
- Displays pages that have their most recent copies on a VIO data set.
Note: All of the following swap states apply only to working set pages.- SIAI
- Displays pages that are in the process of being swapped in from auxiliary storage.
- SIEI
- Displays pages that are in the process of being swapped in from expanded storage.
- SOAI
- Displays pages that are in the process of being swapped out to auxiliary storage.
- SOEI
- Displays pages that are in the process of being swapped out to expanded storage.
- SWAX
- Displays pages that have their most recent copies swapped to auxiliary storage.
- SWEX
- Displays pages that have their most recent copies swapped to expanded storage.
- SWMG
- Displays pages that are in the process of migrating from expanded storage to auxiliary storage.
- Object states for ADDRSPACE report:
- TOKEN(token)
- Requests that the SHRDATA report be run only for the input token.
Usage note: The system ignores all other data selection parameters when you specify TOKEN.
- TOTONLY
- Requests that for tabular reports, only the totals should be produced. All other output is suppressed. If you do not specify TOTONLY, RSMDATA prints all report data. Use TOTONLY for the ADDRSPACE, DIVMAP, DSPACE, REALFRAME, RSMREQ, SHRDATA, and VIRTPAGE tabular reports.
- Address space selection parameters Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs). Use these parameters for ADDRSPACE, DIVMAP, DSPACE, EXCEPTION, REALFRAME, RSMREQ, SHRDATA, SUBSPACE, and VIRTPAGE reports. In these reports, if you omit an address space selection parameter, the defaults are CURRENT and ERROR. For more information, see the select ASID service in z/OS MVS IPCS Customization.
- ALL
- Specifies processing of RSM control blocks for all address spaces in the system at the time the dump is generated.
- ASIDLIST(asidlist)
- Specifies the list of address space identifiers for which you
want to process RSM control blocks.
The asidlist can be specified as a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs. When you specify a range, separate the first and last ASIDs in the range with a colon. When you specify a list, separate the list members with commas.
The ASID can be 1 through 65535. An ASID can be expressed in the notation X'nnn', F‘nnn’, or B'nnn'. An unqualified number is assumed to be fixed.
- CURRENT
- Specifies processing of RSM control blocks for each active address space (that is, address spaces dispatched on some central processor, or bound by cross memory to an address space dispatched on some central processor) at the time of the dump.
- ERROR
- Specifies processing of RSM control blocks for the error address space(s).
- JOBLIST(joblist) or JOBNAME(joblist)
- Specifies the list of job names whose associated address spaces are to be processed for RSM control blocks. Use commas to separate the job names in the list; do not enclose job names in apostrophes; and do not specify a range of job names.
- Return codes
See Standard subcommand return codes for a description of the return codes produced by the RSMDATA subcommand.
- Examples: See z/OS MVS Diagnosis: Reference for
detailed descriptions and examples of RSMDATA output.
When viewing RSMDATA output through the IPCS dialog, you can enter the HELP primary command (or PF key). Choosing option 6 from the HELP selection panel will display full help text on the contents of the RSMDATA report.
- Example 1: Generate a report on virtual pages, including
data space pages, residing on expanded storage for job MYJOB.
- Action
COMMAND ===> RSMDATA VIRTPAGE JOBNAME(MYJOB) DATASPACES STATUS(EXP)
- Action
- Example 2: Generate a report showing all real frames (not
just CURRENT and ERROR) in the V=R region that are intercepted for
use by a V=R job, or are polluting the V=R region.
- Action
COMMAND ===> RSMDATA REALFRAME ALL STATUS(VRINT,POLLUTE) RANGE(5:86)
Note:- Determine the range of the V=R region using RSMDATA SUMMARY.
- In this case, specify ALL to override the default CURRENT address space selection parameters, so that the report will contain all the real frames that satisfy the selection criteria.
- Action
- Example 3: Generate a report showing all RSM requests for
the CURRENT address space.
- Action
COMMAND ===> RSMDATA RSMREQ
- Action
- Example 4 Generate a report showing real storage usage summary for every address space in the dump.
- Action
COMMAND ===> RSMDATA ADDRSPACE ALL
- Action
- Example 5: Generate a report showing the storage in address
space X'023' that is assigned to a subspace, not assigned
to a subspace, or available to all subspaces.
- Action
COMMAND ===> RSMDATA SUBSPACE STATUS(GLOBAL,ASSIGN,UNASSIGN) ASIDLIST(X' 023')
- Action