User-defined reports (CMRPRLN)

You can create custom reports by writing a program with the MainView for CICS Performance Reporter Language (PRL). With PRL, you select records from the CMRDETL, CTGDETL, and CMRSTATS data sets that hold CICS transaction, CTG transaction, and statistical data. Your program determines how these records are processed and formatted in a printed report.

You create PRL reports by executing a batch job that runs the CMRPRLN program and its associated control statements. CMRPRLN processes these user-written PRL control statements to select the input VSAM records and to define the format of the report.

The Performance Reporting Language supports

• CMRPRLN processing of the F7 format of the CMRDETL history record using the CMRDETLN dictionary format

• CMRPRLN processes the CTGDETL records using the CTGDETL dictionary format

• CMRPRLN processes the CMRSTATS records using the CMRSTATS dictionary format

The most efficient way to execute PRL programs is by running them against small volumes of data during CICS execution or at daily CICS shutdown. Long-term trends can be reported for analysis or debugging by archiving the MainView for CICS-collected data to tape (see Archiving data (CMRPURG)), and then specifying the tape as input to the PRL program (see Selecting archive data). Sample PRL programs for CMRDETL and CMRSTATS are located in your BBSAMP library. They are named CMRPRLnn, where nn is a two-digit suffix that identifies an individual report.

You should execute the sample programs to learn PRL and to obtain copies of the default reports. The JCL for submitting the programs is described in Generating PRL reports.