Parameter field

The OUTPUT JCL statement contains only keyword parameters. All parameters are optional; however, do not leave the parameter field blank. You can code any of the keyword parameters in any order in the parameter field.

Table 1. Keyword parameters
KEYWORD PARAMETERS VALUES PURPOSE
ADDRESS={('delivery address'
        [,'delivery address']...)}
        {delivery-address}

See section ADDRESS parameter

delivery address: 1 - 4 delivery-address subparameters; a delivery-address is 1 - 60 valid EBCDIC text values Specifies an address to be printed on output separator pages.
AFPPARMS=datasetname

See section AFPPARMS parameter

datasetname must be a sequential data set.

datasetname must be cataloged.

See the DSNAME parameter on the DD statement for additional syntax rules.

Use the AFPPARMS keyword to reference the data set name which specifies the parameter file that contains the parameters and values for the AFP print distributor feature of PSF. The parameters specified in this parameter file augment parameters specified on the output JCL statement.
AFPSTATS= {YES}
       	  {Y  }
          {NO }
       	  {N  }

See section AFPSTATS parameter

YES or Y: Requests that PSF produce an AFPSTATS report for the printing of this sysout data set.

NO or N: Specifies that PSF should not produce an AFPSTATS report for the printing of this sysout data set.

Specifies to Print Services Facility™ (PSF) that an AFP Statistics About the Printfile (AFPSTATS) report is to be generated while printing this sysout data set.
BUILDING= {'building identification'}
          {building-identification  }

See section BUILDING parameter

building identification: 1 - 60 valid EBCDIC text values Specifies a building location to be printed on output separator pages.
BURST= {YES}
       {Y  }
       {NO }
       {N  }

See section BURST parameter

YES or Y: burster-trimmer-stacker
NO or N: continuous forms stacker

Directs output to a stacker on a 3800 Printing Subsystem.
CHARS= {font-name                  }
       {(font-name[,font-name]...)}
       {STD                         }
       {DUMP                        }
       {(DUMP[,font-name]...)      }

See section CHARS parameter

1 - 4 font-name subparameters:
1 - 4 alphanumeric or
national ($, #, @) characters
STD: character-arrangement
table (JES3 only)
DUMP: 204-character print
lines on 3800 dump

Names character-arrangement tables for printing on an AFP printer. Can request a high-density dump on a SYSABEND or SYSUDUMP DD statement.
CKPTLINE=nnnnn

See section CKPTLINE parameter

nnnnn: 0 - 32,767 Specifies the maximum lines in a logical page. (JES3 supports this parameter only when PSF prints the sysout data set on an AFP printer.)
CKPTPAGE=nnnnn

See section CKPTPAGE parameter

nnnnn: 1 - 32,767 Specifies the number of logical pages to be printed or transmitted before JES takes a checkpoint. (JES3 supports this parameter only when PSF prints the sysout data set on an AFP printer.)
CKPTSEC=nnnnn

See section CKPTSEC parameter

nnnnn: 1 - 32,767 Specifies how many seconds of printing are to elapse between each checkpoint of this sysout data set. (JES3 supports this parameter only when PSF prints the sysout data set on an AFP printer.)
CLASS= {class}
       {*    }

See section CLASS parameter

class: A - Z, 0 - 9 *: same output class as MSGCLASS parameter on JOB statement Assigns the sysout data set to an output class.
COLORMAP=resource

See section COLORMAP parameter

resource: 1 - 8 alphanumeric or national ($, #, @) characters Specifies the AFP resource (object) for the data set that contains color translation information.
COMPACT=compaction-font-name

See section COMPACT parameter

compaction-font-name: 1 - 8 alphanumeric characters Specifies a compaction table for sending this sysout data set to a SNA remote terminal.
COMSETUP=resource

See section COMSETUP parameter

resource: 1 - 8 alphanumeric or national ($, #, @) characters Specifies the name of a macrofile setup resource that contains the SETUP information.
CONTROL= {PROGRAM}
         {SINGLE }
         {DOUBLE }
         {TRIPLE }

See section CONTROL parameter

PROGRAM: each logical record begins with a carriage control character

SINGLE: single spacing
DOUBLE: double spacing
TRIPLE: triple spacing

Specifies that the data set records begin with carriage control characters or specifies line spacing.
COPIES= {nnn                              }
        {(,(group-value[,group-value]...))}

See section COPIES parameter

nnn (JES2): 1 - 255
nnn (JES3): 0 - 255
1 - 8 group-values (JES2): 1 - 255
1 - 8 group values (JES3): 1 - 254

Specifies number of copies printed. For an AFP printer, can instead specify number of copies of each page printed before the next page is printed.
COPYCNT= {xxx}

See section COPYCNT parameter

xxx: 0 - 2147483647

Specifies number of copies printed where the limit is 2G in size.
DATACK= {BLOCK  }
        {UNBLOCK}
        {BLKCHAR}
        {BLKPOS }

See section DATACK parameter

BLOCK: indicates errors are
not reported
UNBLOCK: indicates errors
are reported
BLKCHAR: indicates print errors
are blocked
BLKPOS: indicates data errors
are blocked

Indicates whether or not print-positioning errors and invalid character data-check errors are to be blocked or not blocked.
DDNAME= {ddname}
        Start of change{procstepname.ddname}End of change
        {stepname.ddname}
        {stepname.procstepname.ddname}

See section DDNAME parameter

ddname: DD to apply OUTPUT
Start of changespecificationsEnd of change to.

Start of changeprocstepname.ddname: DD to apply
OUTPUT specifications to, with preceding
PROCSTEP name.End of change


stepname.ddname: DD to apply OUTPUT
Start of changespecificationsEnd of change to, with preceding
STEP name.

stepname.procstepname.ddname: DD to apply
OUTPUT Start of changespecificationsEnd of change to, with preceding
STEP and PROCSTEP names.

Specifies the DDs to apply the specifications on the OUTPUT statement.

DEFAULT= {YES}
         {Y  }
         {NO }
         {N  }

See section DEFAULT parameter

YES or Y: this statement can be implicitly referenced by sysout DD statements

NO or N: this statement cannot be implicitly referenced by sysout DD statements.

Specifies that this is a default OUTPUT JCL statement.
DEPT= {'department identification'}
      {department-identification  }

See section DEPT parameter

department identification: 1 - 60 valid EBCDIC text values Specifies a department identification to be printed on output separator pages.
DEST=destination

  destination (JES2):
    LOCAL
    'IP:ipaddr'
    name
    Nnnnnn
    NnRmmmmm to NnnnnnRm
    (node,remote)
    nodename.userid
    'nodename.IP:ipaddr'
    Rnnnnn or RMnnnnn or RMTnnnnn
    Unnnnn

  destination (JES3):
    ANYLOCAL
    'IP:ipaddr'
    device-name
    group-name
    nodename
    'nodename.IP:ipaddr'
     nodename.remote
See section DEST parameter

LOCAL: local device
ipaddr identifies a TCP/IP routing
designation.
name: named local or remote device
Nnnnnn: node (1 - 32,767)
NnRmm: node (1 - 32,767) and
remote work station (1 - 32,767)
;
6 digits
maximum for n and m combined
nodename.userid: node (1 - 8
alphanumeric characters) and userid
(1 - 8 alphanumeric characters)
Rnnnnn or RMnnnnn or RMTnnnnn:
remote terminal (1 - 32,767)
Unnnnn: local terminal (1 - 32,767)
ANYLOCAL: any local device
device-name: local device (1 - 8
alphanumeric or national ($, #, @)
characters)
group-name: 1 or more local
devices or remote stations
(1 - 8 alphanumeric or national
($, #, @) characters)
nodename: node (1 - 8 alpha-
numeric or national ($, #, @)
characters)
remote: remote workstation (1 - 8
alphanumeric or national
($, #, @) characters)

Sends a sysout data set to the specified destination.
DPAGELBL= {YES}
          {Y  }
          {NO }
          {N  }

See section DPAGELBL parameter

YES or Y: requests that the system print a security label on each page.

NO or N: requests that the system not print a security label on each page.

Indicates whether the system should print a security label on each page of output.
DUPLEX= {NO    }
        {N     }
        {NORMAL}
        {TUMBLE}

See section DUPLEX parameter

X'80' for NO
X'40' for NORMAL
X'20' for TUMBLE

Specifies whether the job prints on one or both sides of the paper. Overrides comparable FORMDEF.
FCB= {fcb-name}
     {STD     }

See section FCB parameter

fcb-name: 1 - 4 alphanumeric or national ($, #, @)

STD: standard FCB (JES3 only)

Specifies FCB image, carriage control tape for 1403 Printer, or data-protection image for 3525 Card Punch.
FLASH= {overlay-name          }
       {(overlay-name[,count])}
       {(,count)              }
       {NONE                  }
       {STD                   }

See section FLASH parameter

overlay-name: forms overlay frame (1 - 4 alphanumeric or national ($, #, @) characters)

count: copies with overlay (0 - 255)

NONE: suppresses flashing

STD: standard forms flash overlay (JES3 only)

For printing on a 3800 Printing Subsystem, indicates that the data set is to be printed with forms overlay and can specify how many copies are to be flashed.
FORMDEF=membername

See section FORMDEF parameter

membername: 1 - 6 alphanumeric or national ($, #, @) characters Names a library member that PSF uses in printing the sysout data set on an AFP printer.
FORMLEN=nn[.mmm]{IN|CM}

See section FORMLEN parameter

nn= 0-99
mmm= 0-999
IN= inches
CM= centimeters

Allows PSF users to set the length of pages for print without reconfiguring the printer.
FORMS= {form-name}
       {STD      }

See section FORMS parameter

form-name: 1 - 8 alphanumeric or national ($, #, @) characters

STD: standard form (JES3 only)

Identifies forms on which the sysout data set is to be printed or punched.
FSSDATA=value

See section FSSDATA parameter

values: 1-127 EBCDIC characters Defined by a functional subsystem. Refer to that subsystem's documentation for the intent and use of this keyword.
GROUPID=output-group

See section GROUPID parameter

output-group: 1 - 8 alphanumeric characters Specifies that this sysout data set belongs to a user-named output group. (JES2 only)
INDEX=nn

See section INDEX parameter

nn: 1 - 31 Specifies how many print positions the left margin is to be indented for a sysout data set printed on a 3211 Printer with the indexing feature. (JES2 only)
INTRAY=nnn

See section INTRAY parameter

nnn: 1 - 255 Specifies the printer input tray from which to take paper for the print job. Overrides comparable FORMDEF specification.
JESDS= {ALL}
       {JCL}
       {LOG}
       {MSG}

See section JESDS parameter

ALL: all of the job’s JCL,
LOG, and MSG data sets

JCL: all JCL processing data sets
LOG: job’s hard-copy log
MSG: job’s system messages

Requests that the indicated data sets for the job be processed according to the parameters on this OUTPUT JCL statement.
LINDEX=nn

See section LINDEX parameter

nn: 1 - 31 Specifies how many print positions to move the right margin in from the full page width for a sysout data set printed on a 3211 Printer with the indexing feature. (JES2 only)
LINECT=nnn

See section LINECT parameter

nnn: 0 - 255 Specifies the maximum lines JES2 is to print on each page. (JES2 only)
MAILBCC= {('bcc address'[,'bcc address']...)}
         {bcc-address                       }

See section MAILBCC parameter

bcc address: 1-60 valid EBCDIC text values

bcc address: 1 - 32 addresses allowed

Specifies the e-mail addresses of the recipients on the blind copy list.
MAILCC= {('cc address'[,'cc address']...)}
        {cc-address                      }

See section MAILCC parameter

cc address: 1-60 valid EBCDIC text values

cc address: 1 - 32 addresses allowed

Specifies the e-mail addresses of the recipients on the copy list.
MAILFILE= {'file id'}
          {file-id  }

See section MAILFILE parameter

file id: 1- 60 valid EBCDIC text values Specifies the file name of the attachment to an e-mail.
MAILFROM= {'from address'}
          {from-address  }

See section MAILFROM parameter

from address: 1- 60 valid EBCDIC text values Specifies the descriptive name or identifier of the sender of an e-mail.
MAILTO= {('to address'[,'to address']...)}
        {to-address                      }

See section MAILTO parameter

to address: 1- 60 valid EBCDIC text values

to address: 1 - 32 addresses allowed

Specifies the e-mail addresses of the e-mail recipients.
MERGE= {YES}
       {Y  }
       {NO }
       {N  }

See section MERGE parameter

YES or Y: OUTPUT JCL parameters will be the job's default

NO or N: OUTPUT JCL parameters will not be the job's default

Indicates whether or not the parameters specified on the OUTPUT JCL statement will be the default OUTPUT parameters for the job.

MODIFY= {module-name          }
        {([module-name][,trc])}

See section MODIFY parameter

module-name: 1 - 4 alphanumeric or national ($, #, @) characters trc: font-name in CHARS parameter (0 for first, 1 for second, 2 for third, and 3 for fourth font-name) Specifies a copy-modification module in SYS1.IMAGELIB to be used by JES to print the data set on a 3800 Printing Subsystem.
NAME= {'preferred name'}
      {preferred-name  }

See section NAME parameter

preferred name: 1 - 60 valid EBCDIC text values Specifies the preferred name to be printed on output separator pages.
NOTIFY= {[node.]userid                     }
        {([node.]userid1,...[node.]userid4)}

See section NOTIFY parameter

{node.}userid: node and userid to receive print complete message. Specifies the node and userid to receive a print complete message when the sysout data set is printed.
OFFSETXB=mmmm[.nnn]{IN    }
                   {CM    }
                   {MM    }
                   {PELS  }
                   {POINTS}

See section OFFSETXB parameter

mmmm: 0 - 9999
nnn: 0 - 999
IN: inches
CM: centimeters
MM: millimeters

Specifies the offset in the X direction from the page origin (or partition origin for N_UP) for the back side of each output page.
OFFSETXF=mmmm[.nnn]{IN    }
                   {CM    }
                   {MM    }
                   {PELS  }
                   {POINTS}

See section OFFSETXF parameter

mmmm: 0 - 9999
nnn: 0 - 999
IN: inches
CM: centimeters
MM: millimeters

Specifies the offset in the X direction from the page origin (or partition origin for N_UP) for the front side of each output page.
OFFSETYB=mmmm[.nnn]{IN    }
                   {CM    }
                   {MM    }
                   {PELS  }
                   {POINTS}

See section OFFSETYB parameter

mmmm: 0 - 9999
nnn: 0 - 999
IN: inches
CM: centimeters
MM: millimeters

Specifies the offset in the Y direction from the page origin (or partition origin for N_UP) for the back side of each output page.
OFFSETYF=mmmm[.nnn]{IN    }
                   {CM    }
                   {MM    }
                   {PELS  }
                   {POINTS}

See section OFFSETYF parameter

mmmm: 0 - 9999
nnn: 0 - 999
IN: inches
CM: centimeters
MM: millimeters

Specifies the offset in the Y direction from the page origin (or partition origin for N_UP) for the front side of each output page.
OUTBIN=nnnnn

See section INDEX parameter

nnnnn: 1 - 65535 Specifies the ID of the printer output bin where the data set is to be sent.
OUTDISP=[normal-output-disposition,
  abnormal-output-disposition]

See section OUTDISP parameter

normal output disposition: WRITE, HOLD, KEEP, LEAVE, or PURGE.

abnormal output disposition: WRITE, HOLD, KEEP, LEAVE, or PURGE.

Specifies the disposition of the sysout process instance for normal or, in a non-APPC scheduling environment, abnormal termination of the job step.
OVERLAYB=name

See section OVERLAYB parameter

name: 1 - 8 alphanumeric or national ($, #, @) characters Specifies placing the named medium overlay on the back side of each printed sheet.
OVERLAYF=name

See section OVERLAYF parameter

name: 1 - 8 alphanumeric or national ($, #, @) characters Specifies placing the named medium overlay on the front side of each printed sheet.
OVFL= {ON }
      {OFF}

See section OVFL parameter

ON: JES3 should check for forms overflow on an output printer.

OFF: JES3 should not check for forms overflow on an output printer.

Specifies whether or not JES3 should check for forms overflow on an output printer. (JES3 only)
PAGEDEF=membername

See section PAGEDEF parameter

membername: 1 - 6 alphanumeric or national ($, #, @) characters Names a library member that PSF uses in printing the sysout data set on an AFP printer.
PIMSG= {(YES[,msg-count])}
       {(NO[,msg-count]) }

See section PIMSG parameter

YES: print messages from a functional subsystem

NO: not print messages from a functional subsystem

msg-count: number of errors to cause printing to be terminated (0-999)

Indicates that messages from a functional subsystem should or should not be printed in the listing following the sysout data set.
PORTNO=nnnnn

See section PORTNO parameter

nnnnn: 1 - 65535 Specifies the TCP port number at which Infoprint Server connects to the printer rather than connecting to LPD on the printer. Specify either PORTNO or PRTQUEUE, but not both. PRTQUEUE indicates the queue used when connecting to LPD on the printer.
PRMODE= {LINE        }
        {PAGE        }
        {process-mode}

See section PRMODE parameter

LINE: send data set to line-mode printer

PAGE: send data set to page-mode printer

process-mode: installation-defined mode (1 - 8 alphanumeric characters)

Identifies the process mode required to print the sysout data set.
PRMODE= {LINE        }
        {PAGE        }
        {process-mode}

See section PRMODE parameter

LINE: send data set to line-mode printer

PAGE: send data set to page-mode printer

process-mode: installation-defined mode (1 - 8 alphanumeric characters)

Identifies the process mode required to print the sysout data set.
PRTATTRS= {'attributename=value 
            attributename=value ...'} 

See section PRTATTRS parameter

The minimum length is one character.

The maximum length is 127 characters.

Enclose the parameter in apostrophes because attribute names contain lower case letters.

All EBCDIC text characters are valid.

Use the PRTATTRS keyword to specify one or more job attributes for Infoprint Server. See z/OS Infoprint Server User's Guide.

PRTERROR= {DEFAULT}
          {QUIT   }
          {HOLD   }

See section PRTERROR parameter

DEFAULT= Specifies that PSF will take the standard action if a terminating error occurs during printing. This is the default.

QUIT= Specifies that PSF will release the data set complete even if a terminating error occurs during printing.

HOLD= Specifies that if a terminating error occurs during printing, the data set will remain on the JES SPOOL until the system operator releases it.

On the OUTPUT statement or dynamic output descriptor, indicates the disposition of the SYSOUT data set to use if a terminating error occurs during printing of the SYSOUT data with the PSF functional subsystem.
PRTOPTNS= {options data set entry name  }
          {'options data set entry name'}

See section PRTOPTNS parameter

print options: 1-16 valid EBCDIC characters. Identifies the print options data.
PRTQUEUE= {print queue name  }
          {'print queue name'}

See section PRTQUEUE parameter

print queue: 1-127 valid EBCDIC characters. Identifies the target print queue name.
PRTY=nnn

See section PRTY parameter

nnn: 0 - 255 (0 is lowest, 255 is highest) Specifies initial priority at which the sysout data set enters the output queue.
REPLYTO= {'reply address' }
         {reply-address    }

See section REPLYTO parameter

reply address: 1- 60 valid EBCDIC text values Specifies the e-mail address to which recipients can respond.
RESFMT= {P240}
        {P300}

See section RESFMT parameter

P240: specifies 240 pels per inch resolution.

P300: specifies 300 pels per inch resolution.

Specifies the resolution used to format the print data set.
RETAINS= {'<hhhh>:<mm>:<ss>'}
         {FOREVER            }

See section RETAINS and RETAINF parameters

retain time: 1-10 numeric characters or FOREVER. The successful transmission retain time specification.
RETAINF= {'<hhhh>:<mm>:<ss>'}
         {FOREVER            }

See section RETAINS and RETAINF parameters

retain time: 1-10 numeric characters or FOREVER. The failed transmission retain time specification.
RETRYL= {nnn}

See section RETRYL and RETRYT parameters

nnnnn: one to five numeric characters. The maximum number of retries.
RETRYT= {'<hh>:<mm>:<ss>'}

See section RETRYL and RETRYT parameters

retry time: 1-10 numeric characters. Wait time between transmission retries.
ROOM= {'room identification'}
      {room-identification  }

See section ROOM parameter

room identification: 1-60 valid EBCDIC text values Specifies a room identification to be printed on output separator pages.
SYSAREA= {YES}
         {Y  }
         {NO }
         {N  }

See section SYSAREA parameter

YES or Y: requests that the system reserve a system area.

NO or N: requests that the system not reserve a system area.

Indicates whether the system should reserve a system area on each page of output.
THRESHLD=limit

See section THRESHLD parameter

limit: 1 - 99999999 Specifies the maximum size for a sysout data set. Use it to obtain simultaneous printing of large data sets or many data sets from one job. (JES3 only)
TITLE= {'description of output'}
       {description-of-output  }

See section TITLE parameter

description of output: 1 - 60 valid EBCDIC characters Identifies a report title to be printed on separator pages.
TRC= {YES}
     {Y  }
     {NO }
     {N  }

See section TRC parameter

YES or Y: data set contains TRC codes

NO or N: data set does not contain TRC codes

Specifies whether or not the sysout data set’s records contain table reference codes (TRC) as the second character.
UCS=character-set-code

See section UCS parameter

character-set-code: 1 - 4 alphanumeric or national ($, #, @) characters Specifies universal character set, print train, or character- arrangement table for an AFP printer.
USERDATA=value
         (value[,value]...)
See section USERDATA parameter
From 1 to 16 values; each value may be from 1 to 60 EBCDIC characters. Defined by the installation. Refer to your installation's definition on the intent and use of this keyword. If your installation does not define any use for this keyword, the information will be syntax checked, stored as part of the output descriptor's information, and then ignored.
USERLIB={data-set-name          }
        {(data-set-name1,data-set-name2,
        ...data-set-name8)}

See section USERLIB parameter

data-set-name: 1 - 8 library data set names containing AFP resources Identifies libraries containing AFP resources for PSF to use when processing sysout data sets.
USERPATH={path                  }
        {(path1,path2,
        ...path8)}
pathname: 1 - 8 z/OS® UNIX file paths. For more information on specifying paths, see PATH parameter. Specifies a private path for TrueType/OpenType fonts to PSF for the print application owner.
WRITER=name

See section WRITER parameter

name: 1 - 8 alphanumeric characters Names an external writer to process the sysout data set rather than JES.

Default OUTPUT JCL statement: An OUTPUT JCL statement that contains a DEFAULT=YES parameter is called a default OUTPUT JCL statement.