Preparing JCL to print reports or create XML documents

You have the option of manually preparing and submitting your own report JCL. The ISPF report request facility will meet most requirements, but by preparing your own JCL and control statements you can use the full formatting flexibility of the CAZPRINT program.

The following CAZPRINT capabilities that are not available directly by using the ISPF report request facility are available if you prepare your own JCL and control statements:
  • Include multiple instances of the same report section in a single report. For example, you can include two instances of C01: CPU Usage by Category in your report. Having multiple instances allows you to sort reports using more than one category. For example, one can be sorted by VALUE (most intense CPU activity at the top) and another sorted by program NAME.
  • Include report sections from different measurement files in a single report.
  • Customize the sequence in which report sections appear in the report.

The following illustrates an example of JCL and control statements to produce a performance analysis report:

//CAZRPT01 JOB (job parameters)
//*
//STEP1    EXEC PGM=CAZPRINT
//STEPLIB  DD   DISP=SHR,DSN=hlq.SCAZAUTH
//SFILE01  DD   DISP=SHR,DSN=measurement.file.name
//CAZLOG   DD   SYSOUT=*
//PRINT1   DD   SYSOUT=*
//PDFFILE  DD   DISP=SHR,DSN=any.file
//*
//*  Instream control statements.
//*
//CAZCTL   DD   *
*
 PROFILE 01 Input=SFILE01
*
   SECTION S01 Profile=01
   SECTION S02 Profile=01
   SECTION S03 Profile=01
   SECTION S04 Profile=01
   SECTION S05 Profile=01
   SECTION S06 Profile=01
   SECTION S07 Profile=01
*
   SECTION C01 Profile=01
   SECTION C02 Profile=01
   SECTION C03 Profile=01
   SECTION C04 Profile=01
   SECTION C05 Profile=01
*
   SECTION W01 Profile=01
*
   SECTION D01 Profile=01
   SECTION D02 Profile=01
   SECTION D03 Profile=01
   SECTION D04 Profile=01
*
 CONVERT Format=PDF DDNAME=PDFFILE
 PRINT DDNAME=PRINT1
*
/*                                      

The above illustrates JCL and control statements that produce output in both line printer format and in PDF format. A brief explanation of the JCL statements is presented below. Detailed descriptions of each of the DD statements are then presented later in this section. For detailed descriptions of the control statements (ddname CAZCTL) see, Specifying control statements.

STEPLIB
The load library containing Application Performance Analyzer components. This can be omitted if Application Performance Analyzer is installed in a linklist library.
SFILE01
The measurement file.
CAZLOG
Output file for error and informational message.
PRINT1
Output file for the line printer report.
PDFFILE
Output file for the PDF report.
CAZCTL
Control statements.