GI11-9492-01

Modifying the application JCL and including conversion parameters

To modify an existing JCL procedure that submits Xerox data sets to the z/OS spool, you must change the JCL statements to submit the Xerox job to Infoprint Server through the Print Interface subsystem. This topic describes how to do this, and how to include conversion parameters in the JCL. This method is suitable for installations that only have a single printer, or that only use a small number of JCL jobs to process Xerox data.

The following example shows the JCL that routes a Xerox data set to a Xerox printer with the name PRT10. This represents the original Xerox environment, without Infoprint XT and InfoPrint printers.

⋮
//OUT1  OUTPUT DEST=PRT10,FORMS=STD
//OUTDD     DD SYSOUT=W,OUTPUT=(*.OUT1)
⋮

Now, you have replaced the Xerox printer PRT10 with an InfoPrint IPDS printer with the name PRT20. You defined PRT20 through the same interfaces on z/OS that you originally used to define the Xerox printer. You have also created a printer definition through the Infoprint Server Printer Inventory Manager, and customized it to process Xerox jobs with Infoprint XT. The name of the printer definition is IPS_PRT10, and Creating a PSF for z/OS printer definition with routing information describes this customization process. You then modify your JCL so that it specifies the InfoPrint printer and the printer definition. You also add the conversion parameters for the job, which Infoprint XT uses to produce the AFP output. You specify a starting JDL of ONLINE, and a starting JDE of STRT. Conversion parameters for converting Xerox jobs describes the set of conversion parameters that you can use. This example shows your modified JCL:

//OUT1  OUTPUT DEST=PRT20,FORMS=STD,CLASS=W
//OUTDD     DD OUTPUT(*.OUT1),SUBSYS=(AOP1,'IPS_PRT10',
//  'filter-options="-x xjdl=online -x xjde=strt"'),DCB=(RECFM=VBM)

Where:

  • The DEST value of the OUT1 OUTPUT statement changes from PRT10 to PRT20, which specifies the InfoPrint printer.
  • The OUT1 OUTPUT statement still includes the FORMS parameter. If your original JCL only used the FORMS value to select a specific starting environment (JDL and JDE combination) for the job, you can omit the FORMS parameter. You now specify the starting environment through the filter-options attribute. See Filter option usage guidelines: printer definitions and jobs for more information.
  • The OUT1 OUTPUT statement now includes the CLASS parameter, which replaces the class value that the SYSOUT parameter specified in the original JCL.
  • On the OUTDD DD statement, the SUBSYS parameter value, AOP1, is the default name of the Print Interface subsystem. You define this in the Infoprint Server default configuration file, which is aopd.conf. All customization for the subsystem is independent of Infoprint XT. You use the procedures in the Infoprint Server documentation for all Print Interface subsystem tasks and procedures. If your installation uses a name other than AOP1 for the subsystem, use that name in your modified JCL.
    Note: For detailed information about the SUBSYS parameter, see the appropriate User's Guide for your version of Infoprint Server.
  • You use the filter-options attribute to pass conversion parameters to Infoprint XT. There are usage guidelines, and a specific order of precedence that Infoprint Server uses to interpret the Infoprint XT filter options. See Filter option usage guidelines: printer definitions and jobs for further information.
  • The DCB parameter specifies the record format of the Xerox data set. You must specify this parameter, with the correct value, in order for Infoprint XT to derive the type of carriage controls, and to process the job correctly.
Note: In this example, the filter-options attribute did not include the -g option to specify a resource group. Therefore, Infoprint XT searched the default, common resource group for the resources that the job specified.