Defining output data sets

RMF™ dynamically allocates all Postprocessor message and report data sets to SYSOUT. You can route output data to permanent data sets rather than to SYSOUT by allocating the data sets in the JCL of the Postprocessor job. The report data sets for Monitor I, OMVS, and XCF interval reports and duration reports use the ddnames MFRnnnnn and MFEnnnnn. The ddnames of these and the other report data sets and the message data set that the Postprocessor uses are:

Table 1. Postprocessor ddnames - text output
ddname Contents Allocations Notes
MFEnnnnn Report output after a recoverable abnormal end One ddname for one data set to be allocated for each of the intervals contained in the input data. RMF uses this data set to re-allocate report data sets after a recoverable ABEND.

nnnnn is a decimal number from 00001 to 99999; successively generated. For example, if a session has 15 intervals, ddnames are MFE00001 through MFE00015.
MFPMSGDS Message output One MFPMSGDS data set is allocated each time the Postprocessor is executed. To change the SYSOUT class parameter for this data set, you must preallocate the data set. You cannot change it in the RMF options.
MFRnnnnn Report output One ddname for one data set to be allocated for each of the intervals contained in the input data. nnnnn is a decimal number from 00001 to 99999; successively generated. For example, if a session has 15 intervals, ddnames are MFR00001 through MFR00015.

For creating one output data set, use ddname PPRPTS.
MFXnnnnn Exception interval report data One ddname for one data set to be allocated for each of the intervals included in the exception report. nnnnn is a decimal number from 00001 to 99999. The first interval is assigned the ddname MFX00001. The second MFX00002, and each subsequent interval is assigned a ddname in ascending numerical order. If no exception interval reports are produced in a given interval, the data set for that interval is empty.

For creating one output data set, use ddname PPXRPTS.
PPEXTnnn Exception report output One ddname for one data set to be allocated for each system included in the input data. nnn is a decimal number from 001 to 999. The first system encountered is assigned to ddname PPEXT001, and each subsequent system is assigned a ddname in ascending numerical order.
PPORPnnn Overview report output One ddname for one data set to be allocated for each of the systems included in the input data. nnn is a decimal number from 001 to 999. The first system encountered is assigned to ddname PPORP001, and each subsequent system is assigned a ddname in ascending numerical order.
PPRPTS Combined interval report One ddname for one data set to be allocated to contain all reports of all intervals included in the input data. There is no dynamic allocation of this ddname. You must define it explicitly if you want to get all interval reports into one data set or output class. You should not use the subparameter DEFER for this ddname.

If you define this ddname, no MFRnnnnn files will be created.
PPSUMnnn Summary report output One ddname for one data set to be allocated for each of the systems included in the input data. nnn is a decimal number from 001 to 999. The first system encountered is assigned the ddname PPSUM001, and each subsequent system is assigned a ddname in ascending numerical order.
PPXRPTS Combined exception report One ddname for one data set to contain all exception reports for all intervals contained in the input data. There is no dynamic allocation of this ddname. You must define it explicitly if you want to get all exception reports into one data set or output class. You should not use the subparameter DEFER for this ddname.

If you define this ddname, no MFXnnnnn files will be created.
PPXSRPTS Sysplex report output One ddname for one data set to be allocated to contain all sysplex reports included in the input data. All sysplex reports are written to this data set.
RMFPnnnn Monitor II session interval report output One ddname is generated and one data set is created for each report for each session-identifier included in the reporting. nnnn is a decimal number from 0001 to 9999. When the Postprocessor is to generate reports for more than one system, a separate data set is allocated for each report for each system. When operands for a Monitor II session are not specified on the REPORTS 1 statement, the Postprocessor uses the operands in the SMF record, and a separate data set is allocated each time the operands change.
Note:
  1. If you omit the DCB characteristics for the mentioned message and report data sets, the characteristics used are: 
    DCB=(RECFM=VBA,LRECL=137,BLKSIZE=1693)
    If you omit the data set control block (DCB) characteristics for a data set allocated to the PPXRPTS ddname of the Postprocessor job, the following characteristics are used: 
    RECFM=VBA, LRECL=1028
    For BLKSIZE, the optimal block size as determined by the system is used.

    If you change the DCB characteristics, you cannot change the record format; you must specify RECFM=VBA.

  2. Please consider that the number of dynamically allocated data sets is limited to 1635.
Table 2. Postprocessor ddname - Overview record output
ddname Contents Allocations Note
PPOVWREC Overview record output One ddname for one data set to be allocated. Not created automatically. The records in this data set can be used for other applications, for example, for conversion to spreadsheet.
Note: Define this data set explicitly in the JCL for the Postprocessor. Use these data set characteristics: 
DCB=(RECFM=VB,LRECL=32756,BLKSIZE=32760)

Besides text reports, the Postprocessor can generate certain reports in XML format. The XML format is generated by specifying the following Postprocessor ddnames for the output data.

Table 3. Postprocessor ddnames - XML output
ddname Contents Allocations Notes
XPOVWRPT Combined Overview report in XML format One ddname for one data set to contain all overview reports for each system included in the input data. There is no dynamic allocation of this ddname. You must define it explicitly if you want to get all overview reports in XML format into one data set or output class. If you define this ddname, no PPORPnnn files are created.
XPRPTS Combined single system report in XML format One ddname for one data set to contain all single system reports for each interval included in the input data. There is no dynamic allocation of this ddname. You must define it explicitly if you want to get all reports in XML format into one data set or output class. If you define this ddname, no MFRnnnnn files are created. If you define this ddname and PPRPTS, no XML output in file XPRPTS is created.
XPXSRPTS Combined sysplex-wide report in XML format One ddname for one data set to contain all sysplex reports for each interval included in the input data. There is no dynamic allocation of this ddname. You must define it explicitly if you want to get all reports in XML format into one data set or output class. If you define this ddname, no MFRnnnnn files are created. If you define this ddname and PPXSRPTS, no XML output in file XPXSRPTS is created.
Note:
  1. If the XML output is to be routed to permanent data sets rather than to SYSOUT, define the data set with RECFM=VB and LRECL between 256 and 8192.
  2. For a complete list of Postprocessor reports which you can obtain as XML output in addition to the Overview report, refer to information unit Long-term overview reporting with the Postprocessor in the z/OS RMF Report Analysis.

    Any others than the listed reports requested on the REPORTS and/or SYSRPTS control statement are ignored.

Parent topic: Starting the Postprocessor