RSMDATA subcommand — analyze real storage manager data

Use the RSMDATA subcommand to generate reports about the attributes and status of the real storage manager (RSM) at the time of a dump. This subcommand produces the following types of reports:

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

Address space selection, data selection, and report type parameters limit the scope and extent of the information that appears in a 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.
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)
```
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:
  1. Determine the range of the V=R region using RSMDATA SUMMARY.
  2. 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.
Example 3: Generate a report showing all RSM requests for the CURRENT address space.
- Action
```
COMMAND ===> RSMDATA RSMREQ
```
Example 4
Generate a report showing real storage usage summary for every address space in the dump.
- Action
```
COMMAND ===> RSMDATA ADDRSPACE ALL
```
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')
```