S550-0433-05

Using JCL Parameters

Using JCL Parameters

Table 20 lists all of the JCL parameters that you might specify in the DD or OUTPUT JCL statements when you submit a data set for processing with AFP Download Plus. In the table, an "X" in a column indicates that the parameter can be:

  • Specified in the DD statement
  • Specified in the OUTPUT statement
  • Sent to the receiver system

The parameters that are required for submitting the data set to the receiver system are contained in -o attributes. The -o attributes are derived from parameters that are specified in z/OS®, including the DD and OUTPUT JCL statements.

Note:
In JES3, many JCL parameters, such as CHARS, FCB, and FORMS, do not override the JES defaults unless the parameter is included as a writer-selection criteria for the device (see JES3 WS parameter in the Device statement).

AFP Download Plus sends -o attributes to the receiver system during processing. See Table 21 for the JCL parameters that are sent as -o attributes.

Table 20. JCL parameters for AFP Download Plus
JCL parameter DD OUTPUT Recvr Description
ADDRESS=('address1'[,'address2'] [,'address3'][,'address4']) X X Indicates one to four address lines to be put on output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
AFPPARMS='dsname[(membername)]' X Indicates the name of the AFPPARMS control statement that contains additional AFP Download Plus parameters. See Specifying the AFPPARMS control statement on the OUTPUT statement.
AFPSTATS={YES | NO} X Indicates whether an AFPSTATS report is generated. See Appendix C. AFPSTATS report
BUILDING=building X X Indicates the building identifier to be put on output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
BURST={YES | NO} X X X Indicates whether continuous-forms paper is separated into single sheets at the receiver destination. This parameter is not always accepted by print servers at receiver destinations. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
CHARS=(fontname1[,fontname2] [,fontname3][,fontname4]) X X Indicates one to four coded fonts that AFP Download Plus integrates into the MO:DCA-P data set. AFP Download Plus puts this parameter in the inline resource group. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used.
Note:
When processing a MO:DCA IS/3 print file, AFP Download Plus does not add the specified coded fonts to the inline resource group because raster fonts cannot be used in a MO:DCA IS/3 file.
CKPTPAGE=pages X Indicates the number of pages between data-set checkpoints, which is the interval at which AFP Download Plus checkpoints the spool data set with JES.
CKPTSEC=seconds X Indicates the number of seconds between data-set checkpoints, which is the interval at which AFP Download Plus checkpoints the spool data set with JES.
CLASS=class X X Indicates the output class that is assigned to the output data set at the receiver destination. If the class is specified on the SYSOUT parameter in the DD statement, it overrides the CLASS parameter in the OUTPUT statement. AFP Download Plus forwards this parameter for use on the receiver system.
COLORMAP=membername X X Specifies the object container member name of the color mapping table resource at the receiver destination. AFP Download Plus puts the table in the inline resource group and forwards this parameter for use by the printer on the receiver system.
COMSETUP=membername X X Specifies the object container member name of the microfilm setup resource at the receiver destination. AFP Download Plus puts the object container in the inline resource group and forwards this parameter for use by the microfilm device on the receiver system.
CONTROL={PROGRAM | SINGLE | DOUBLE | TRIPLE} X Indicates the line spacing AFP Download Plus uses when transforming line data to MO:DCA-P.
COPIES=
(nnn,(groupvalue1,...groupvalue8))
X X X Indicates the number of copies that are printed at the receiver destination (when the receiver destination supports this parameter). If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
DATACK={BLOCK | UNBLOCK | BLKCHAR | BLKPOS} X X Specifies the character and position errors the printer reports at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
DCB=OPTCD=J X Indicates that the data set contains table reference characters (TRCs). You can also specify table reference characters in the TRC parameter on the OUTPUT statement; however, if DCB=OPTCD=J is specified, it overrides the TRC parameter on the OUTPUT statement.
DCB=RECFM={recordformat}[A | M] X Indicates whether ANSI or machine carriage-control characters exist in a data set with line data. See z/OS MVS JCL Reference for recordformat values you can use, such as FB, V, or VB. A for ANSI control characters or M for machine-code control characters can be specified with any record format, such as: RECFM=FBA.
DEPT=department X X Indicates the department identifier to be put on output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
DEST=
[node.]name | '[node.]IP:ipaddress'
X X X Specifies an IP address for the output data set. This IP address does not affect the transmission of the data set to a receiver system. AFP Download Plus always uses the IP address that is specified on the PRINTDEV statement for the FSA to transmit a data set to a receiving system. This parameter provides an extra value, which a shell script, destination control file, or exit routine on the receiving system can optionally use to route a file to a particular device attached to the receiving system. The administrator must modify the IBM-supplied shell script, destination control file, or exit routine to use this parameter. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used.
Note:
If you specify the DEST=IP parameter, you cannot also specify a destination name in the DEST JCL parameter. Therefore, if your system programmer configured the AFP Download Plus startup procedure to select jobs that are based on destination name (that is, WS=R is specified as JES work-selection criteria), you must specify a destination name and you cannot specify the DEST=IP parameter. Or, you can remove the destination name from the JES work-selection criteria for the FSA you are using.
DUPLEX={NO | NORMAL | TUMBLE} X X Indicates whether printing is done on both sides of each sheet at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
FCB=pdefname X X Indicates the name of the page definition AFP Download Plus uses to format line data to MO:DCA-P. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used.
FLASH=(flashname,[count]) X X X Indicates the name of the forms flash that is printed at the receiver destination and the number of copies. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
FORMDEF=fdefname X X Indicates the name of the form definition that is used for processing the data set. AFP Download Plus puts this parameter in the inline resource group.
FORMLEN=xx.yyyIN | xx.yyyCM X X Indicates the paper length in inches or centimeters that is used to print the data set at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
FORMS=formname X X Indicates the name of the form that the print operator is notified to load at the receiver destination. If you specify the form name on the SYSOUT parameter in the DD statement, it overrides the FORMS parameter in the OUTPUT statement. AFP Download Plus forwards this parameter for use on the receiver system.
INTRAY=nnn X X Indicates the tray number from which paper is selected at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
LINECT=nnn X Indicates the maximum number of lines that are processed on each output page.
NAME=name X X Indicates a name identifier to be put on output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
NOTIFY=(node.userid1[,node.userid2] [,node.userid3][,node.userid4]) X Indicates up to four users who are notified when AFP Download Plus has finished processing the data set. If users are not specified or if those specified cannot be contacted, AFP Download Plus sends a notification to the job submitter. Whenever AFP Download Plus creates a message file, even if you have not requested notification, AFP Download Plus sends a notification message. AFP Download Plus always puts a copy of the notification message in the system log. See Specifying message notification.
OFFSETXB=nnnn[.mmm]unit X X Indicates the offset in the x direction of the logical page origin from the media origin for the backside of each sheet. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
OFFSETXF=nnnn[.mmm]unit X X Indicates the offset in the x direction of the logical page origin from the media origin for the front side of each sheet. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
OFFSETYB=nnnn[.mmm]unit X X Indicates the offset in the y direction of the logical page origin from the media origin for the backside of each sheet. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
OFFSETYF=nnnn[.mmm]unit X X Indicates the offset in the y direction of the logical page origin from the media origin for the front side of each sheet. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
OUTBIN=nnnnn X X Indicates the number of the output bin into which the print job is placed at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
OVERLAYB=overlayname X X Indicates the member name of a medium overlay that is placed on the backside of each sheet. AFP Download Plus puts this parameter in the inline resource group.
OVERLAYF=overlayname X X Indicates the member name of a medium overlay that is placed on the front side of each sheet. AFP Download Plus puts this parameter in the inline resource group.
PAGEDEF=pdefname X Indicates the member name of the page definition AFP Download Plus uses to format line data to MO:DCA-P.
PIMSG={YES | NO | (YES,nnn) | (,nnn) X Indicates whether all message groups generated in the processing of a data set are written to a file.
PRMODE={SOSI1 | SOSI2 | SOSI3 | SOSI4 | aaaaaaaa} X Indicates the default processing mode AFP Download Plus uses to process data sets containing both single-byte and double-byte fonts.
PRTERROR=HOLD | QUIT | DEFAULT X Indicates whether AFP Download Plus accepts the error disposition that is specified when AFP Download Plus stops processing a data set because an error occurs during processing.
PRTQUEUE='printqueuename' X X Indicates the name of the target print queue at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
RESFMT={P240|P300} X Indicates the resolution at which the output is formatted.
ROOM=room X X Indicates the room identifier to be put on output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
SEGMENT=pagecount X X Indicates that part of the output for a job is spooled to print while the job is still running, or indicates that different segments of a job are printed simultaneously on different printers at the receiver destination. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
SYSOUT=(class,,formname) X X Indicates the output class and the form name that is assigned to the output data set at the receiver destination. You can also specify the output class and form name in the CLASS and FORMS parameters of the OUTPUT statement. However, if you specify the SYSOUT, it overrides the CLASS and FORMS parameters in the OUTPUT statement. AFP Download Plus forwards this parameter for use on the receiver system.
TITLE=title X X Indicates the description to be put on the output separator pages. AFP Download Plus does not use this parameter but forwards it for use on the receiver system.
TRC={YES|NO} X Indicates that the data set contains table reference characters. If you also specify table reference characters with the DCB=OPTCD=J parameter in the DD statement, it overrides the TRC parameter.
UCS=fontname X X Indicates the name of the coded font that AFP Download Plus integrates into the MO:DCA-P data set. If you specify the parameter in both a DD statement and an OUTPUT statement, the parameter value on the DD statement is used.
USERLIB=
('libname1','libname2'...,'libname8')
X Indicates the name of the user libraries containing AFP resources for processing the data set.
USERPATH=
('libpath1','libpath2'...,'libpath8')
X Indicates the name of the UNIX file resource path libraries that contain TrueType and OpenType fonts.