Parameter definition

PR

Indicates that this statement is associated with a sysout data set that is printed.

DDNAME=

DDNAME=ddname

DDNAME=stepname.ddname

DDNAME=stepname.procstepname.ddname

DDNAME=procstepname.ddname

DDNAME=JESYSMSG

DDNAME=JESJCL

DDNAME=JESMSGLG

(null): Specifies that the parameters on this //*FORMAT PR statement are the defaults for the job. These parameters then apply to all of the job’s sysout data sets that are printed, except those covered by a //*FORMAT PR statement with a value other than (null) for DDNAME.
Overrides: Parameters coded on a nonspecific //*FORMAT PR statement are overridden by parameters coded on sysout DD statements or by parameters in the JES3 SYSOUT initialization statement.
ddname
stepname.ddname
stepname.procstepname.ddname
procstepname.ddname: Identifies the DD statement that defines the sysout data set to be printed; for example, ddname indicates all DD statements with the name, ddname, in this job. Stepname.ddname indicates DD statement, ddname, in step, stepname, in this job. Stepname.procstepname.ddname indicates DD statement, ddname, in procedure step, procstepname, of a procedure that is called by a step, stepname, in this job. The ddname must match exactly the ddname on the DD statement. (See the example for the //*DATASET statement.) If the identified DD statement does not contain a SYSOUT parameter, JES3 ignores the //*FORMAT PR statement.
Note: If a ddname matches more than one //*FORMAT PR statement, the //*FORMAT PR statement that has more qualifiers for the ddname will override the others. See Examples of the //*FORMAT PR statement.
JESYSMSG: Requests printing of system messages for this job.
JESJCL: Requests printing of JCL statements and messages for this job.
JESMSGLG: Requests printing of JES3 and operator messages for this job.

CARRIAGE=carriage-tape-name

CARRIAGE=6

Specifies the carriage tape for the 3211, 3203 Model 5, or 1403 Printer for printing this output class.

carriage-tape-name: Identifies the name of the carriage tape. The name is 1 through 8 characters. For the 3211 and 3203-5, SYS1.IMAGELIB must contain a module for each carriage tape name.
6: Indicates the installation standard carriage tape.

Note: You cannot code both the CARRIAGE and FCB parameters on the same //*FORMAT PR statement.

CHARS=STANDARD

CHARS=table-name

CHARS=(table-name[,table-name]...)

Requests one or more fonts for printing the sysout data set on an AFP printer.

STANDARD: Indicates the standard character-arrangement table, which was specified at JES3 initialization.
table-name: Identifies a character-arrangement table. Each table-name is 1 through 4 alphanumeric or national ($, #, @) characters. When coding more than one table-name, parentheses are required around the list and null positions are invalid in the list.

CHNSIZE=DS

CHNSIZE=(nnn[,mmm])

Gives the number of logical records to be transmitted to a work station as a systems network architecture (SNA) chain and indicates whether normal output checkpoints are to be taken for this sysout data set.

Note: This parameter is valid only when transmitting to a SNA work station.

Be careful in selecting subparameters, because each affects performance differently. Sending the data set as a SNA chain provides the best performance, but can cause duplicate data to be written to the output device if operator intervention is required. The remote operator can eliminate duplicate data by issuing commands to reposition and restart the output writers.

When an end-of-chain indicator is sent in the data set, JES3 takes an output checkpoint. You can provide additional checkpoints for critical data by sending an end-of-chain indicator. For example, when printing bank checks, you can have an output checkpoint taken for each check by specifying each check as a SNA chain.

DS

Indicates that the sysout data set is to be sent as a single SNA chain and that JES3 is not to take normal output checkpoints. DS is the default if the CHNSIZE parameter is omitted.

nnn

Specifies the SNA chain size in pages. nnn is a decimal number from 1 through 255. The size of a page is determined by:

The value of mmm.
The carriage control characters in the data that skip to channel 1.

mmm

Specifies the number of logical records in a page, when the data contains no carriage control characters. mmm is a decimal number from 1 through 255.

COMPACT=compaction-table-name

Specifies the compaction table for JES3 to use when sending a systems network architecture (SNA) data set to a SNA remote terminal. The compaction-table-name is a symbolic name defined by the installation during JES3 initialization. The name is 1 through 8 alphanumeric characters.

In the following cases, JES3 performs compaction using an installation default table, if defined, or sends the data without compacting it, if no table was defined. In all cases, JES3 writes a message to the console.

No compaction table is specified.
The specified compaction table is invalid.
JES3 cannot find the specified compaction table.

If the remote printer does not support compaction, JES3 ignores the COMPACT parameter and sends the data without compacting it.

CONTROL=PROGRAM

CONTROL=SINGLE

CONTROL=DOUBLE

CONTROL=TRIPLE

Indicates either that the data records control printing or that the output is to be printed with single, double, or triple spacing.

PROGRAM: Indicates that each logical record in the data set begins with a carriage control character. You can specify in the DD statement, the DCB macro, or the data set label that an optional control character is part of each record in the data set. The carriage control characters can be in either the extended USASCII code or can be the actual channel command code. The carriage control characters are given in z/OS DFSMS Using Data Sets.
SINGLE: Requests single spacing.
DOUBLE: Requests double spacing.
TRIPLE: Requests triple spacing.

COPIES=nnn

COPIES=(nnn,(group-value[,group-value]...))

COPIES=(group-value[,group-value]...)

Indicates how many copies of the sysout data set to print. If you do not specify a COPIES parameter, the default is 1.

You can omit the parentheses if you code only nnn.

nnn

A number from 1 through 254 that specifies how many copies of the data set to print. Each copy will be in page sequence order.

If you code COPIES=0 on the DD statement, the system uses a default of 1, which is the default for the DD COPIES parameter.

JES3 ignores nnn if any group-values are specified.

group-value

Specifies how many copies of each page are to be printed before the next page is printed. Each group-value is a number from 1 through 255. You can code a maximum of eight group-values. Their sum must not exceed 255. The total copies of each page equals the sum of the group-values.

This subparameter is valid only for output on a 3800 Printing Subsystem. Group values override an nnn subparameter.

DEST=destination

Routes the output from the sysout data set to a printer. This parameter overrides the //*MAIN statement ORG parameter.

If you omit DEST, JES3 assigns the first available printer that is in the origin group and that fulfills all processing requirements. The origin group is the group of printers defined for the local or remote submitting location. If the job originated at a remote job processing (RJP) terminal, JES3 returns the output to the originating terminal group.

If the job was submitted through TSO/E to the NJE network for execution, the default is the node from which the job was submitted, and the destination ANYLOCAL.

ANYLOCAL: Indicates any local printer that is being used for the output class specified in the SYSOUT parameter on the DD statement and that is attached to the global processor.
device-name: Requests a local device by a symbolic name defined by the installation during JES3 initialization. device-name is 1 through 8 alphanumeric or national ($, #, @) characters.
device-number: Identifies a specific device by a 3-digit or 4-digit hexadecimal number. Precede a 4-digit number with a slash (/). A 3-digit number can be specified with or without a slash.
group-name: Identifies a group of local devices, an individual remote station, or a group of remote stations by a symbolic name defined by the installation during JES3 initialization. group-name is 1 through 8 alphanumeric or national ($, #, @) characters.
nodename: Identifies a node by a symbolic name defined by the installation during JES3 initialization. nodename is 1 through 8 alphanumeric or national ($, #, @) characters.
remote: Identifies a remote work station or VM userid to which the receiving node directs output. remote is 1 through 8 characters.
(type): Indicates a device classification. type is in the form (gggssss) where ggg is the general device classification and ssss is the specific device classification. The type must be enclosed in parentheses. The type must be defined by the installation during JES3 initialization. For example, type for a 3800 is (PRT3800).

EXTWTR=name

Identifies the external writer that is to process the sysout data set at the destination node. name is 1 through 8 alphanumeric characters and must identify a module defined to the remote JES3 node that is to execute the job. (Do not code NJERDR, it is reserved for JES3.)

FCB=image-name

FCB=6

Specifies the forms control buffer (FCB) image JES3 is to use to guide printing of the sysout data set by a 1403 Printer, 3211 Printer, 3203 Printer Model 5, 4245 Printer, 4248 Printer, or 3800 Printing Subsystem, or by a printer supported by systems network architecture (SNA) remote job processing (RJP).

If the data set is to be produced on some other device, JES3 ignores the FCB parameter.

image-name

Identifies the FCB image. The name is 1 through 4 alphanumeric or national ($, #, @) characters and is the last characters of a SYS1.IMAGELIB member name:

FCB2xxxx member for a 3211, 3203 model 5, or printer supported by SNA.
FCB3xxxx member for a 3800.
FCB4xxxx member for a 4248.

6

Indicates the standard FCB. JES3 uses the standard FCB specified at JES3 initialization.

Note: You cannot code both the CARRIAGE and FCB parameters on the same //*FORMAT PR statement.

FLASH=STANDARD

FLASH=overlay-name

FLASH=(overlay-name[,count])

Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing Subsystem and, optionally, to specify the number of copies on which the forms overlay is to be printed.

You can omit the parentheses if you code only an overlay-name. If you omit the count subparameter or specify a count of 0, JES3 flashes all copies with the specified overlay.

STANDARD: Indicates the standard forms flash overlay. JES3 uses the standard forms overlay specified at JES3 initialization.
overlay-name: Identifies the forms overlay frame that the operator is to insert into the printer before printing begins. The name is 1 through 4 alphanumeric or national ($, #, @) characters.
count: Specifies the number, 0 through 255, of copies that JES3 is to flash with the overlay, beginning with the first copy printed. Code a count of 0 to flash all copies.

Note: See the Forms Design Reference Guide for the 3800 for information on designing and making forms overlays.

FORMS=STANDARD

FORMS=form-name

Indicates the forms on which the sysout data set is to be printed.

STANDARD: Indicates the standard form. JES3 uses the standard form specified at JES3 initialization.
form-name: Names the print forms. form-name is 1 through 8 alphanumeric characters.

MODIFY=module-name

MODIFY=(module-name[,trc])

Specifies a copy modification module that tells JES3 how to print the sysout data set on a 3800 Printing Subsystem. The module can specify how to replace blanks or data in the data set. You can omit the parentheses if you code only a module-name.

The module is defined and stored in SYS1.IMAGELIB using the IEBIMAGE utility program. See z/OS DFSMSdfp Utilities for more information.

If you omit the trc subparameter, JES3 prints the data set with the first character-arrangement table coded in the CHARS parameter.

module-name: Identifies a copy modification module in SYS1.IMAGELIB. module-name is 1 through 4 alphanumeric or national ($, #, @) characters.
trc: Identifies which table-name in the CHARS parameter is to be used. This table reference character is 0 for the first table-name specified, 1 for the second, 2 for the third, or 3 for the fourth.

OVFL=ON

OVFL=OFF

Indicates whether or not the printer program should test for forms overflow.

Because the overflow test is a responsibility of the terminal package for the remote RJP terminal, JES3 ignores OVFL for remote job processing.

ON: Indicates that the printer program should eject whenever the end-of-forms indicator (channel 12) is sensed. ON is the default if the OVFL parameter is omitted.
OFF: Indicates that forms overflow control is not to be used.

PRTY=nnn

Specifies the priority at which the sysout data set enters the output queue. nnn is a decimal number from 0 through 255; 0 is the lowest priority while 255 is the highest.

STACKER=STANDARD

STACKER=S

STACKER=C

Requests a stacker for output processed by PSF on any continuous forms AFP printer.

STANDARD: Indicates the standard installation default. This default is specified at JES3 initialization.
S: Indicates the burster-trimmer-stacker, in which the output is burst into separate sheets.
C: Indicates the continuous forms stacker, in which the output is left in continuous fanfold.

THRESHLD=limit

Specifies the maximum size for the sysout data set. JES3 calculates the sysout data set size as the number of records multiplied by the number of copies requested. When this size exceeds the THRESHLD value, JES3 creates a new unit of work, on a data set boundary, and queues it for printing. Consequently, copies of the sysout data set may be printed simultaneously by different printers.

Use the THRESHLD parameter for jobs that generate many large sysout data sets. Grouping data sets as a single unit of work for an output service writer may decrease the time required for the output service writer to process the data sets.

The value specified in this parameter overrides the value specified during JES3 initialization.

limit: Specifies the maximum records for a single sysout data set. limit is a decimal number from 1 through 99999999. The default is 99999999.

TRAIN=STANDARD

TRAIN=train-name

Indicates the printer train to be used in printing the sysout data set. See Table 1 for the IBM-supplied trains. Because these trains are not standard machine features, verify that the installation has the required printer train before specifying it.

Do not code the TRAIN parameter for output destined for a remote job processing (RJP) terminal.

STANDARD: Indicates the standard installation default. This default is specified at JES3 initialization.
train-name: Specifies an installation-supplied printer train. Check with your installation for the names of trains.