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')
Parent topic: IPCS subcommands