Parameters

NAME=

Specifies the 1-8 character name of the job class. This name corresponds to the CLASS parameter on the //*MAIN control statement. If you omit DEF=YES from all CLASS statements in the initialization stream, JES3 defines JS3BATCH as the default class.

CIBATCH=

Indicates whether batch jobs of this class must have CI processing limited to certain processors. If specified for a class, this will override the value specified on the CIBATCH parameter on the STANDARDS statement. If not specified, JES3 will use the value specified on or defaulted to on the STANDARDS statement.

JOB - indicates CI processing must be performed on a system on which the job is eligible to run.
Note: Either the SYSTEM or SYSAFF parameter on the JOB control statement, or the SYSTEM parameter on the //*MAIN control statement, are considered for CI scheduling purposes when determining where the job is eligible to run. The job's scheduling environment does not apply.
CLASS - indicates CI processing must be performed on a system on which the job's JOB CLASS is enabled.
ANY - indicates CI processing may be performed on any processor regardless of job or class eligibility.

CIDEMAND=

Indicates whether demand select jobs of this class must have CI processing limited to certain processors. If specified for a class, this will override the value specified on the CIDEMAND parameter on the STANDARDS statement. If not specified, JES3 will use the value specified on or defaulted to on the STANDARDS statement.

JOB - indicates CI processing must be performed on a system on which the job is eligible to run.
CLASS - indicates CI processing must be performed on a system on which the job's JOB CLASS is enabled.
ANY - indicates CI processing may be performed on any processor regardless of job or class eligibility.

DEF=

Identifies this class as the default job class. Specify DEF=YES on one CLASS statement only. If you specify DEF=YES on multiple statements, the last such statement in the initialization stream defines the default class. If you omit the CLASS parameter from a batch job's or started task's //*MAIN statement and you do not specify a job class on the //JOB statement, JES3 assigns the default job class to that job.

Note: A job class that is not defined to JES3 cannot be specified on the //*MAIN statement. If it is specified, JES3 cancels the job.

FAILURE=

Specifies the job recovery option that JES3 is to use when a system failure affects jobs in this class.

For information on what JES3 considers a "failure" from a job's point of view, and for detailed information on how JES3 treats a job in these failure situations, see the FAILURE= parameter on the STANDARDS statement.

Note: If a job has been registered as an element of automatic restart management, the FAILURE= keyword is ignored.

If automatic restart management decides to start the job, all non-spin sysout data sets created during the previous execution will be deleted.

CANCEL: Print any job output that is in a SYSOUT class that is specified as TYPE=PRINT. After printing the output, cancel the job.
Empty data sets destined for the INTRDR are automatically canceled.
HOLD: Place the job into the hold queue.
PRINT: Print any job output that is in a SYSOUT class that is specified as TYPE=PRINT. Then place the job into the hold queue.
RESTART: Restart the job from the first step. The job will be restarted on the processor on which it was active.

GROUP=

Specifies the name of a job class group to which this job class is to be assigned. This parameter must match the NAME parameter on a GROUP statement. If the GROUP parameter is omitted, JES3 assigns this class to the default group (JS3BATCH).

IORATE=

Specifies the default I/O rate for the jobs in this class. JES3 attempts to balance the mixture of jobs in execution based on the values that you have specified for the JOBMIX and CHOICE parameters on the appropriate SELECT statements. This parameter can be overridden for individual jobs by the IORATE parameter on the //*MAIN statement. For more information about how the IORATE parameter relates to job selection, see the description of the SELECT statement and in “Job Selection and Scheduling” in z/OS JES3 Initialization and Tuning Guide.

If you specify an invalid subparameter, JES3 uses the parameter default.

This parameter is ignored for job classes that are associated with WLM-managed groups. See GROUP (Job-Class Group Definition) for more information on defining a WLM-managed group.

JESMSG=

Specifies whether to allow (LOG) or suppress (NOLOG) writing WTOs and WTORs to the JESMSGLG data set for jobs in this job class.

Note: If this JESMSG= is not used, the JESMSG= keyword on the STANDARDS initialization statement is in effect. If JESMSG= is used, its use overrides the specification of the JESMSG= keyword on the STANDARDS initialization statement.

JOURNAL=

Specifies whether (YES) or not (NO) job-related information is to be saved in a job journal.

YES: Indicates that jobs in this class are to have a journal data set.
NO: Indicates that there is to be no journal data set. If a system failure occurs affecting a job in this class, JES3 takes the action specified in the FAILURE option on this statement.
This parameter may be overridden by individual jobs with the JOURNAL parameter on the //*MAIN JES3 control statement.

If you specify a subparameter that is not valid for the JOURNAL parameter, JES3 uses the default value NO.

Note: To restart a job automatically through checkpoint/restart or step restart, information about the job must be recorded in the job journal. To restart a job using automatic restart management, the job journal is not needed (automatic restart management does not use the job journal).

MDEPTH=

Determines the maximum number of jobs in this class that can be run on the indicated main at any one time. You may repeat the procname and depth subparameters in pairs as is necessary.

procname: Specifies the name of a processor. The main name must match the NAME parameter on a MAINPROC statement.
depth: Specifies a decimal number from 0 to 255. This parameter indicates the maximum number of jobs of this class that JES3 can schedule to run concurrently on the named main.

JES3 applies the limit to each service class separately where WLM is in use. More initiators than expected can be started where jobs and tasks in a given job class run under different service classes. To have limits applied correctly under WLM, all jobs, in the same job class, need to be in the same service class.

LSTRR

Specifies the logical storage reduction rate (0 to 99), if a job's logical region size is not specified in the LREGION parameter on the //*MAIN control statement. JES3 uses this parameter as a percentage of the region size to determine the job's logical region. If the LSTRR parameter is specified as 0, logical storage processing is effectively disabled for jobs not specifying LREGION.

If specified, the LREGION parameter overrides logical storage processing. If LSTOR=0 is specified on the SELECT statement logical storage scheduling is disabled.

For more information about defining logical storage, see "Defining Logical Storage for MVS™ Processors" in z/OS JES3 Initialization and Tuning Guide.

LSTRR is ignored for job classes that are associated with WLM managed groups. See GROUP (Job-Class Group Definition) for more information on defining a WLM-managed group.

MLIMIT=

Determines the maximum number of jobs of other job classes that can run on the indicated main and still let JES3 schedule jobs in this class on that main. When any of the limits are exceeded, JES3 does not schedule any more jobs in the class defined by this CLASS statement on that main. JES3 only schedules jobs of this class when the number of jobs running from the other named classes is equal to or less than the assigned limit.

This parameter may be repeated to describe job class limitations on each main. The classname and limit parameters should be repeated, in pairs, to indicate the job limits of each class by main.

procname: Specifies the name of a processor as specified in the NAME parameter of a MAINPROC statement.
classname: Specifies the name of another job class. This must match the NAME parameter on another CLASS statement.
limit: Specifies a number from 0 to 255. This value indicates the number of jobs of the class.

PRTY=

Specifies the JES3 job priority (0 to 14) be assigned to each job in this class. The PRTY parameter may be overridden on a job basis by the PRTY parameter on the JOB statement. If you omit this parameter, the value is taken from the PRTY parameter on the STANDARDS statement.

SDEPTH=

Specifies the maximum number of jobs in this class requiring MDS operator mounts that can be set up at one time. The value of nnn is a number from 0 to 255.

When JES3 counts the number of jobs that are set up, JES3 considers a job to be set up from the time the job enters allocation until the time the job's devices are deallocated.

Note: When deferred mounting is either specified in the JCL for any device (for example, UNIT=(TAPE,,DEFER)) or implicitly requested by using tape library dataserver devices, JES3 bypasses pre-execution mount processing and does not include the job in its CLASS setup depth (SDEPTH) count unless DEFERCT=YES has been specified on the SETPARAM initialization statement or the *F S operator command.

SPART=

Specifies the spool partition that JES3 is to use for jobs in this job class. The partition name must match the partition name specified on one of the SPART statements. To accept the default spool partition, omit this parameter.

A partition name specified on a //*MAIN JES3 control statement or on a SYSOUT initialization statement can override this parameter. For a discussion of the order of overrides, see “Determining the Order of Spool Partition Overrides” and “How the User Can Request a Spool Partition” in z/OS JES3 Initialization and Tuning Guide.

If you specify a partition name that has not been defined on an SPART statement, JES3 uses the default partition.

If you specify an invalid subparameter, JES3 uses the parameter default.

SPIN=

Specifies whether the installation wants to allow or suppress spin off of JESlog data sets during job execution.

YES

Specifies that a job running in this class, unless otherwise specified on the JOB statement or the START command, will have its JESlog data sets spun off through the use of a JES3 command.

+hh:mm

Note: The JESlog can be spun off at any time by using a JES3 command. This hh:mm value must be between 00:10 and 99:59. Hours and minutes must be two digits.

hh:mm

Specifies that a job running in this class, unless otherwise specified on the JOB statement or the START command, will have its JESlog data sets spun off automatically at the time of day specified by hh.mm.

Note: The log can be spun off at any time by using a JES3 command. The hh:mm value must be between 00:00 (midnight) and 23:59. Hours and minutes must be two digits.

nnn/nnnK/nnnM

Specifies that a job running in this class, unless otherwise specified on the JOB statement or the START command, will have its JESlog data sets spun off automatically each time the number of lines specified as nnn or nnnK or nnnM has been generated. If the interval is specified as nnnK, JESlog is spun off every nnn thousand lines; if the interval is specified as nnnM, the log is spun off every nnn million lines.

Note: The JESlog data sets can be spun off at any time using a JES3 command. This value must be at least nnn lines. nnn must have a value of 500 to 999 when K and M are not used. nnn must have a value of 1 to 999 when K or M is used.

NO

Specifies that the JESlog data sets for a job running in this class, unless otherwise specified on the JOB statement or the START command, cannot be spun off. This is the default.

If the same CLASS initialization statement is defined with JESMSG=NOLOG and SPIN= is specified with a value other than NO, then JES3 issues a warning message and assumes SPIN=NO. Also, consider the following scenario:

The CLASS initialization statement specifies SPIN=YES (or some similar form is specified).
JESMSG= is omitted on the CLASS initialization statement.
JESMSG=NOSTC is specified on the STANDARDS initialization statement.
The job in execution is a started task.

Writing to the JESMSGLG data set is suppressed. However, when the SPIN= interval for the JESYSMSG data set is reached or if an operator command is issued to spin the JESlog data sets, the JESlog data sets are spun off.

Note:

The automatic spinning off of the JESlog data sets does not occur until the current message buffer is filled; additional time can pass and additional lines can be generated before the JESlog data sets are spun off. For this reason, consider approximations for the values you specify for parameter SPIN=.
When spin off of the JESlog data sets is in effect, the spin off of the first JESMSGLG data set will not contain all messages written to it before the start of job execution. These "missing" messages will be processed when the job completes execution.

SYSSYM=

Indicates whether batch jobs of this class are allowed to use system symbols in JCL.

ALLOW: Batch JCL is allowed to use system symbols. System symbols in batch JCL are replaced with values from a system where the job is eligible to execute. This system is derived from the set of systems defined for this class, the system affinity of the job, and the scheduling environment of the job at the time of conversion. It is possible for symbols and their values to come from a system that is not the system where the batch job actually executes, which can occur when there are several systems on which the job is eligible to execute.
When a job executing in a class defined with SYSSYM=ALLOW undergoes converter processing, the job requires C/I to be available at a JES3 HJS7790 level (or later) to provide system symbol substitution. If C/I is not available at this level, the job waits for C/I to become available at this level.
DISALLOW: Batch JCL is not allowed to use system symbols. System symbols will not be replaced with values when the JCL is processed. This is the default.

SYSTEM=

Defines the main name(s) or type of system to be used for jobs in this class.

LOCAL: Indicates that jobs in this class are to run on a JES3 local main only.
JES3: Indicates that jobs in this class are to be run on the global or any local main that can satisfy the job requirement.
GLOBAL: Indicates that jobs in this class are to run on the JES3 global only.
ANY: Indicates that jobs in this class can run on any main (global or local) that will satisfy the job requirement.
procname: Indicates, when specified without a preceding slash (/), the only main(s) to be eligible for running jobs in this class. If the “/” precedes the procname(s), this parameter indicates the mains to be excluded from consideration for jobs in this class. The procname must match the NAME parameter on a MAINPROC statement.

Note: LOCATE processing takes place on any main where both the appropriate catalogs are available and the job is eligible to run by virtue of the SYSTEM parameter on the CLASS statement.

TDEPTH=

Specifies the maximum number of jobs of this class that can be scheduled into the total JES3 complex at one time. The value of nnn is a number from 0 to 255.

TLIMIT=

Specifies the maximum number of jobs of other classes that can be scheduled into the total JES3 complex and still allow jobs in this job class to be scheduled. If any of the limits are exceeded, more jobs in this class will not be scheduled. Jobs of this class are scheduled only when the number of jobs running from other classes is equal to or less than the assigned limit.

classname: Specifies the name of another job class.
limit: Specifies the number of jobs of the other class. The maximum value is 255.

The classname and limit parameters may be repeated, in pairs, to indicate the job limit for each class.

TRKGRPS=

Specifies the number of track groups (as defined by the GRPSZ parameter on the BUFFER or SPART statement) JES3 is to allocate to jobs within this class. For guidelines on how to determine the appropriate value for the TRKGRPS parameter for your installation, see “Determining Track Group Allocation Sizes” in z/OS JES3 Initialization and Tuning Guide.

prigrps: Specifies the number of track groups to be initially allocated to jobs in this class. The specified value may be 1 through 9.
secgrps: Specifies the number of track groups to be allocated to jobs in this class subsequent to their primary allocation. JES3 allocates the specified amount of spool space after the job uses up its initial allocation, and again (for an unlimited number of times) when the job uses up each secondary allocation and requests more spool space. The specified value may be 1 through 9.

If you specify an invalid subparameter, JES3 uses the parameter default.