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.