Using the DFSMSrmm report generator

The DFSMSrmm report generator is an Interactive System Productivity Facility (ISPF) application that you can use to create reports. The report generator:

Provides reports that you can run as-is or that you can modify as you wish. You can use samples to create reports for volumes, data sets, racks, owners, and the retention and movement policies that are established for your installation. You can modify these samples to create tailored reports. DFSMSrmm ships samples in SYS1.SAMPLIB. See Running a report generator report to run one of these reports.
Generates job control language (JCL) that is based on specifications that you use to submit the report jobs. The generation of JCL depends on the report type and therefore the macros that map the data records. The generation knows, based on the macro name and keyword options used, whether to generate a DCOLLECT jobstep, a DFSMShsm FSR and WWFSR reformat, a DFSMSrmm extract, or a copy of SMF records.
Includes samples for reporting from DCOLLECT and DFSMShsm data.
Provides a ‘Report Migration Tasks’ dialog to cause new information shipped in report types to be inherited into existing report definitions.

To create reports with the report generator, provide any input data along with an Assembler language mapping macro to map the input data. The DFSMSrmm samples use the DFSMSrmm extract data set, the System Management Facility (SMF) file, and the ACTIVITY file as input. DFSMSrmm mapping macros map the input data.

The report definitions and report types specify the format and contents of reports, the input files for the reports, and the tools used to create the reports. To use or modify a report, you work with report definitions as described in Working with report definitions. Create new report definitions for reports that are required by your users. Store the report definitions in the installation library to make the reports available to all your users from the installation library. To create a new report that uses input data other than the DFSMSrmm files, you work with report types as described in Working with report types.

The report generator samples use DFSORT ICETOOL as the default tool. The report generator creates a DFSORT ICETOOL job that you can run in batch. See Working with reporting tools for information about specifying a tool for creating reports.

You store report definitions, report types, and the reporting tools in three separate libraries.

The product library which contains predefined report definitions, report types, and reporting tools.
The installation library which contains any versions that your installation has modified or created.
The user library where any new or modified versions are stored.

The DFSMSrmm report generator also uses a JCL library to save and submit the DFSMSrmm-generated report JCL to run your reports.

Define all the libraries as partitioned data sets with fixed 80 byte records. When you do not allocate libraries, DFSMSrmm allocates the libraries automatically with a primary and secondary space of 10 tracks and 50 directory blocks. Specify the data set names as fully qualified names with single quotation marks or without quotation marks and a high-level qualifier. DFSMSrmm automatically expands the data set names to the fully qualified name including the single quotes. DFSMSrmm uses the RACF® user ID as the high level qualifier for the data sets if you do not specify NOPREFIX in the TSO profile. See Specifying libraries for the report generator for information about setting up the libraries for the report generator.

When you install new function APARs onto your system for the report generator and then create or update any report types, reports, or tool definitions, you must ensure that any other system that uses those new or updated report types, reports, or tool definitions also has the new function installed.