Using sysout2pdf to output batch reports as PDF

The sysout2pdf z/OS® UNIX utility converts "traditional" plain text z/OS batch reports, such as reports generated by CICS PA, into PDF files. You can write plug-in filters for sysout2pdf to manipulate the report contents, highlight text, or add PDF navigation features such as bookmarks. You can also use sysout2pdf to send the PDF using email.

Preparing to use sysout2pdf

This topic explains the prerequisites for using sysout2pdf.

  • sysout2pdf must be configured as part of the installation of CICS PA and according to the instructions in the Program Directory.
  • sysout2pdf and Apache Formatting Objects Processor (FOP) must be installed under z/OS UNIX. Read the technote "Start of changeInstalling FOP on z/OS UNIX for use with sysout2pdf to convert CICS PA reports into PDFsEnd of change", which is published on the IBM® support web site at the following address:

    Start of changehttp://www.ibm.com/support/docview.wss?uid=swg21449724End of change

    Note: sysout2pdf was developed and tested on z/OS V1.9 using FOP 0.85 and 1.0.
  • Your z/OS UNIX system must have a JAVA_HOME environment variable that refers to a Java™ Runtime Environment (JRE), 1.5.x or later.
  • Your TSO user ID (that is, the TSO user ID under whose authority your batch jobs run) must have an OMVS segment defined in RACF®, and must have permission to:
    • Execute the sysout2pdf z/OS UNIX shell script.
    • Read the specified z/OS UNIX input file (batch report).
    • Write files to the z/OS UNIX file path for the output PDF.
  • If you want to use sysout2pdf to send PDF attachments by email, then sendmail must be configured on your z/OS UNIX system.