Application Performance Analyzer for z/OS, Version 11.1, User's Guide

The CONVERT statement

A CONVERT statement can be specified instead of or in addition to a PRINT statement. Like PRINT, CONVERT tells CAZPRINT to write the report and specifies the output destination. Instead of writing the report in conventional line printer format, the CONVERT statement creates a report file in an alternate format; either PDF or XML. When XML is specified, a PRINT statement cannot be included in the job step. You cannot include a CONVERT statement for PDF and a CONVERT statement for XML in the same job step.

Two examples of CONVERT statements are shown here.

CONVERT DDNAME=PDF1 FORMAT=PDF MLD=N
CONVERT DDNAME=XML1 FORMAT=XML LANG=ENU MLD=N

CONVERT statement parameters

DDNAME
This mandatory parameter specifies the DD name of a file to which the converted report is to be written. A corresponding DD statement must be included in the JCL. When requesting a PDF, the file must be sequential, in FB format with 80 byte records. When requesting an XML document, the file must be sequential, in FB format with 255 byte records.
FORMAT
This mandatory parameter specifies the format to which the report is to be converted. It must specify PDF or XML.
LANG
The LANG keyword parameter is optional. If omitted it defaults to ENU to indicate the reports are to be created in the English language. Other acceptable values for PDF files are JPN for Japanese and KOR for Korean. ENU is the only acceptable value for XML documents.
MLD
The MLD keyword parameter is optional, if omitted it defaults to Y. This specifies whether or not multi-line descriptions should be printed (Y=Yes, N=No). This is similar to the PREF option in Application Performance Analyzer ISPF: "Show long descriptions on multiple lines," and when generating JCL with Application Performance Analyzer ISPF, the PREF setting will be used to set MLD.



Rate this page

[ Top of Page | Previous Page | Next Page | Contents | Index ]