Parameter definition

BURST=Y

BURST=N

Specifies the default burst characteristic of all sysout data sets that JES2 produces for this job. BURST applies only when the data set is directed to a 3800 Printing Subsystem equipped with a burster-trimmer-stacker.

Y: Requests that the 3800 output is to be burst into separate sheets.
N: Requests that the 3800 output is to be in a continuous fanfold.

BYTES=nnnnnn

Specifies the maximum output, in thousands of bytes, the system is to produce from this job. The nnnnnn is 1 through 6 decimal numbers from 0 through 999999. When nnnnnn bytes are reached, JES2 gives control to an installation exit routine and the job might or might not be terminated.

CARDS=nnnnnnnn

Specifies the maximum number of output cards to be punched for this job’s sysout data sets. The value is 1 through 8 decimal numbers from 0 through 99999999. When the specified number of cards is reached, JES2 gives control to an installation exit routine and the job might or might not be terminated.

COPIES=nnn

Specifies how many copies of the spool lines or bytes for this job’s sysout data sets are to be printed or punched. The nnn is 1 through 3 decimal numbers from 1 through 255. An installation can reduce the upper limit of this value during JES2 initialization.

The COPIES parameter is ignored and only one copy is produced if any of the following is true:

FREE=CLOSE is coded on the DD statement for the output data set.
HOLD=YES is coded on any sysout DD statement in the job.
The output class of the sysout data set is a held class, and the message class is also a held class. The message class is specified in the JOB statement MSGCLASS parameter.

Note:

The use of '/*JOBPARM COPIES= ' creates output groups which are special in a sense that they are a clone of the original output group. When these output groups are transmitted in an NJE network, the count of copies transmitted will not behave as expected. Another side effect of these clone JOEs is that their attributes cannot be changed, and will remain the same as that of the original output group.

It is recommended to avoid using the /*JOBPARM JECL statement to produce multiple copies, especially when those outputs will go through NJE network. Instead, use COPIES keyword at the DD level. When you use COPIES keyword at the DD level, clone output groups will not be produced and the outputs will be manipulated appropriately.

FORMS=xxxxxxxx

FORMS=STD

Specifies the print and/or punch forms JES2 is to use for sysout data sets for which FORMS is not specified on the DD statement or on a JES2 /*OUTPUT statement.

xxxxxxxx: Identifies the print or punch forms. The xxxxxxxx is 1 through 8 alphanumeric or national ($, #, @) characters.
STD: Indicates that JES2 is to use the default specified at JES2 initialization.

LINECT=nnn

Specifies the maximum number of lines that JES2 is to print on each output page for this job’s sysout data sets. The nnn is 1 through 3 numbers from 0 through 254.

If you code LINECT=0, JES2 does not eject to a new page when the number of output lines exceeds the page limit that the installation specified during JES2 initialization.

The LINECT parameter on the /*OUTPUT statement overrides LINECT on the /*JOBPARM statement and the linect value in the accounting information parameter of the JOB statement.

LINES=nnnnnn

Specifies the maximum output, in thousands of lines, that JES2 is to place in the spool data sets for this job’s sysout data sets. The number is 1 through 6 decimal numbers from 0 through 999999. When the specified number of lines is reached, JES2 gives control to an installation exit routine and the job might or might not be terminated.

The LINES parameter applies only to line-mode data. (See also the PAGES parameter.) If the sysout data set contains both line-mode and page-mode data, the lines and pages are counted separately and checked separately against the limit.

NOLOG

Requests that JES2 not print the job’s hard-copy log. The job’s hard-copy log contains the JES2 and operator messages about the job’s processing.

PAGES=nnnnnnnn

Specifies the maximum number of output pages to be printed for this job’s sysout data sets. The number is 1 through 8 decimal numbers from 0 through 99999999. When the specified number of pages is reached, JES2 gives control to an installation exit routine and the job might or might not be terminated.

The PAGES parameter applies only to page-mode data. (See also the LINES parameter.) If the sysout data set contains both page-mode and line-mode data, the pages and lines are counted separately and checked separately against the limit.

PROCLIB=ddname

Requests a JES2 procedure library by its ddname, as defined in the JES2 procedure used to initialize JES2. Typically, JES2 procedure library ddnames are in the format PROCnn, where nn is either 00 or 1 or 2 decimal numbers from 1 through 99. You can, however, use any valid ddname as long as the name matches the ddname in the JES2 procedure. The system retrieves called cataloged procedures from the requested JES2 procedure library.

If you omit the PROCLIB parameter, or the ddname cannot be found in the procedure used to start JES2, JES2 uses the procedure library specified on the PROC=nn parameter on one of the following JES2 initialization statements:

JOBCLASS(v) for each job class
JOBCLASS(STC) for all started tasks
JOBCLASS(TSU) for all time-sharing tasks

If the PROC=nn parameter is not defined on the appropriate initialization statement, or if it is not valid, JES2 uses the default library, PROC00. See z/OS JES2 Initialization and Tuning Guide for information about creating the JES2 cataloged procedure and z/OS JES2 Initialization and Tuning Reference for information about defining JES2 initialization statements.

RESTART=Y

RESTART=N

Requests one of the following, if this job is executing before a re-IPL and JES2 warm start, and the job cannot restart from a step or checkpoint.

Y: Requests that JES2 queue the job for re-execution from the beginning of the job.
N: Requests that JES2 take no special action.

Note:

If you do not specify RESTART, JES2 assumes N. However, the installation may override this default in JES2 initialization parameters.

If the job is registered with the automatic restart manager (ARM) at the time of the IPL, ARM determines whether the job is restarted, regardless of whether RESTART=YES or NO is specified.

ROOM=xxxx

Indicates the programmer's room number. The xxxx is 1 through 4 alphanumeric characters. JES2 places the room number on the job’s separators so that the installation can deliver the job’s sysout data sets to the programmer.

SYSAFF=*

SYSAFF=(*[,IND])

SYSAFF=ANY

SYSAFF=(ANY[,IND])

SYSAFF=cccc

SYSAFF=(cccc[,IND])

SYSAFF=(cccc[,cccc]...)

SYSAFF=((cccc[,cccc]...)[,IND])

Indicates the systems that are eligible to process the job. The parameter indicates from 1 system affinity representing a JES2 member name, up to the number of entries that can be coded on a JOBPARM statement, limited by the number of JES2 members that can exist in a MAS.

Note:

Use the SYSAFF parameter to ensure the conversion and execution of the job will be done on a specific system. If you code SYSAFF, both processes are done on the specified system.

For TSO-submitted jobs that specify NOTIFY in the JOB statement: after a job has completed execution, JES2 may change the SYSAFF specification for the job if the job executed on a processor other than the processor that the user is logged on. This is done by JES2 during output processing to allow NOTIFY processing to take place on the user’s processor.

*: Indicates the system that read the job.
ANY: Indicates any system in the JES2 multi-access spool configuration.
cccc: Identifies a specific system, where cccc is the JES2 member name of the current system in the JES2 multi-access spool configuration. cccc is 1 through 4 alphanumeric characters. To specify more than one system, separate the member names with commas and enclose the member name list in parentheses; for example, SYSAFF=(cccc,cccc,cccc).
Note: If you specify SYSAFF=cccc on the /*JOBPARM statement and also have a /*ROUTE XEQ or /*XEQ statement, the latter statement must appear before the /*JOBPARM statement.
IND: After any of the other SYSAFF specifications, indicates that JES2 is to use system scheduling in independent mode. When IND is coded, the subparameters must be enclosed in parentheses. IND cannot be coded by itself. It must be included with at least one JES2 member name, or a JCL error will be reported.

TIME=nnnn

Estimates the job execution time, in minutes of real time. The nnnn is 1 through 4 decimal numbers from 0 through 9999. If you omit a TIME parameter and a time subparameter in the JOB statement accounting information parameter, JES2 uses an installation default specified at initialization. If job execution exceeds the time, JES2 sends a message to the operator.