Choosing a report creation method

Figure 1 shows two reporting paths leading to reports. This section discusses some possibilities for creating reports.

You can access the records of the data collection data set through your own program. A user-written program can produce a report that addresses the specific needs of an installation. This approach is more flexible, but requires some additional programming to produce the custom reports.
See the DCOLREXX sample program written in the TSO/E REXX programming language as an example for processing these records. DFSMShsm sample tools describes the way to access this program.
You can use simple reports that have been predefined and are available through the NaviQuest product. NaviQuest provides support for DCOLLECT data by including a starter set of Log, Summary, and Parameter Tables and Views. For additional information, refer to the NaviQuest appendix in the z/OS DFSMSdfp Storage Administration .
The DFSORT™ product includes ICETOOL, a DFSORT utility that makes it easy for you to create reports. A set of illustrative examples of analyzing data created by DFSMShsm, DFSMSrmm, DCOLLECT, and SMF are included with the DFSORT R13 product. Refer to z/OS DFSORT Application Programming Guide under "Storage Administrator Examples" for more information.
The DFSMSrmm Report Generator can be used with utilities like DFSORT's ICETOOL to create customized reports. You can create DFSMShsm report definitions, save reporting jobs, and submit reporting jobs using the DFSMSrmm Report Generator.
For information on FSR and DCOLLECT Records see Running New Reports with Report Generator in Chapter 14, Obtaining Information from DFSMShsm of z/OS DFSMShsm Storage Administration.

For more detailed information of how the DFSMSrmm Report Generator works see Chapter 2, Using the DFSMSrmm Report Generator in z/OS DFSMSrmm Reporting.

To add and change report types so DCOLLECT users can use DFSMSrmm Report Generator see Figure 28. Adding a Report Type Using the Add a Report Type Panel and Figure 32. Changing a Report Type Using the Change a Report Type Panel in Chapter 2, Using the DFSMSrmm Report Generator of z/OS DFSMSrmm Reporting.
```
Panel  Help                                                                 
------------------------------------------------------------------------------
EDGPG022            DFSMSrmm Report Generation - DCOLLECT                    
Command ===>                                                                 
                                                                             
Enter or change the skeleton variables for the generated JCL:                
                                                                             
Input data set  . . . . 'DFRMM1.DCOLLECT'                                    
                                                                             
Date format . . . . . . ISO                                                  
    (American, European, Iso, Julian, or free form)                          
    Required if you use variable dates (&TODAY) in your selection criteria.  
                                                                             
Create report data  . . N  (Y/N)                                             
    Choose Y if you want an extract step included into your generated JCL.   
                                                                             
Additional skeleton variables, if an extract step is included:               
Skeleton Variable_1 . .                                                      
Skeleton Variable_2 . .                                                      
Skeleton Variable_3 . .                                                      
    The skeleton selection depends on the reporting macro . . . : IDCDOUT    
                                          and macro keyword . . : TYPE=V
  Enter END command to start the report generation or CANCEL                 
```
See Running a Report Generator in Chapter 2. Using the DFSMSrmm Report Generator in z/OS DFSMSrmm Reporting for Figure 3. Select the Input Data Set in the Product Library Using the DFSMSrmm Report Definitions Search Panel and Figure 6. Running Your Report Using the DFSMSrmm Report Definitions Panel in Running a Report Generator Report. Also, see Figure 27. DFSMSrmm Report Types Panel in Working with Report Types in the same chapter.

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. 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 DFSMShsm files, you work with report types.
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 supports a list of up to five assembler macros to map the data in records to be used for reporting. For each macro you can specify one or more keywords with values to be used with the macro name at assembly time. The macros are assembled and the assembler listing is used to extract field information. The offset for each field, its characteristics and length are saved to be used for selection by the dialog user.
ARCUTILP provides keyword options so that only a single type of record can be mapped to simplify use under the report generator:
```
     ARCUTILP IDCDOUT=YES/NO,TYPE=ALL/M/B/C/T
```
ISPF skeletons generate extract steps for DCOLLECT and update SMF extracts for use with DFSMShsm FSR report types. You need to tailor the skeleton to perform processing based on the JCL and control statements required for your selected data and reporting utility.

The DFSMShsm supplied skeletons ARCGFSRC and ARCGWFSC are used by the generator to convert FSR and WWFSR records to FSR2 and WFSR2 records respectively. For details about reporting with DFSMShsm and DCOLLECT data, see the DFSMShsm section of z/OS DFSMSdfp Storage Administration.