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.