AOPBATCH examples

These examples show how to use the AOPBATCH procedure to transform data. For additional AOPBATCH examples, see z/OS Infoprint Server User’s Guide.

Transform an AFP MVS data set into a PDF file using AOPBATCH

This example shows how to use the AOPBATCH procedure to transform data.

The transform input is in an MVS™ data set and transform output is written to a UNIX file. The AFP to PDF transform reads the AFP input from data set HLQ.INPUT.AFP and writes PDF output to file /tmp/output.pdf.

//AOPBATCH JOB  ...
//TRANSFRM EXEC PGM=AOPBATCH,PARM='/afpxpdf -o /tmp/output.pdf -j "form
//             -definition=F1CP0110" "//''HLQ.INPUT.AFP''"'
//STDOUT   DD   SYSOUT=*
//STDERR   DD   SYSOUT=*
AOP_MVS_RETURN_CODES=YES

Transform and print data sets only if the transform is successful

This example shows how to transform data and print the output from the transform in a subsequent step only if no warnings or errors occur during the transform.

In the first step, the AFP to PostScript transform reads AFP input from data set HLQ.INPUT.AFP and writes PostScript output to data set HLQ.OUTPUT.PS, where HLQ represents the high-level qualifier.

The STDENV data set specifies the AOP_MVS_RETURN_CODES environment variable. Because this variable is set to YES, the transform returns MVS return codes: 0 (successful), 4 (warning), 8 (failure).

In the second step, the AOPPRINT JCL procedure prints the PostScript output to the printer named mypsfprinter, which is defined in the Printer Inventory. This step runs only if the return code from the transform step is less than 4.

For information about AOPPRINT, see z/OS Infoprint Server User’s Guide.

//AOPBATCH JOB  ...
//TRANSFRM EXEC PGM=AOPBATCH,PARM='/afpxps -o //DD:OUTPUT //DD:INPUT'
//INPUT    DD   DSN=HLQ.INPUT.AFP,DISP=SHR
//OUTPUT   DD   DSN=HLQ.OUTPUT.PS,DISP=(NEW,CATLG,DELETE),
// DCB=(RECFM=VBM,LRECL=32756,BLKSIZE=32760),SPACE=(CYL,(1,1))
//STDOUT   DD   SYSOUT=*
//STDERR   DD   SYSOUT=*
//STDENV   DD   *
AOP_MVS_RETURN_CODES=YES
/*
//PRINT    EXEC AOPPRINT,PRINTER='mypsfprinter',
//  COND=(4,LT,TRANSFRM)
//SYSIN    DD   DSN=HLQ.OUTPUT.PS,DISP=SHR
 

Continuing parameter fields in JCL

To continue a parameter field:

1. Interrupt the field after a complete parameter or subparameter, including the comma that follows it, at or before column 71.
2. Code // in columns 1 and 2 of the following statement.
3. Code a blank character in column 3 of the following statement.
4. Continue the interrupted parameter or field beginning in any column from 4 through 16.

To continue a parameter that is enclosed in apostrophes:

1. Extend the parameter to column 71. Do not code an apostrophe in column 71.
2. Code // in columns 1 and 2 of the following statement.
3. Continue the parameter in column 16 of the following statement even if this splits the parameter.