Parameter description for JOBCLASS(class...|STC|TSU)
- ACCT=Yes|No
- Specifies whether an account number is required (Yes) or not required
(No) on a JCL JOB statement. This parameter is not allowed on either
the JOBCLASS(STC) or JOBCLASS(TSU) initialization statements.
Modification: $T JOBCLASS operator command or cold start
- ACTIVE=[Yes|No]
- Specifies whether or not the specified job class is active. Active job classes can be used on new jobs that are submitted. The ACTIVE parameter has no effect on jobs once they have been submitted. This parameter does not apply to the STC and TSU job classes.
- AUTH=ALL|SYS|IO|CONS|INFO
- Specifies the MVS™ operator command groups that are to be executed.
The groups include:
- SYS
- system commands
- IO
- input/output commands
- CONS
- console commands
- INFO
- information commands (such as display)
- ALL
- all operator command types
This parameter affects JCL statements only. Use the AUTH= parameter of the INTRDR and RDR initialization statement to specify the authorization for JES2 job entry control (JECL) statements. (JES2 control statements begin with /* in columns 1 and 2. JCL statements begin with // in columns 1 and 2).
Modification: $T JOBCLASS operator command or cold start
- BLP=Yes|No
- Specifies that either the bypass label processing parameter in
the label field of a DD statement is to be ignored (No) and processed
as no label, or that bypass label processing is performed as requested
(Yes) and the label parameter is processed as it appears.
Modification: $T JOBCLASS operator command or cold start.
- COMMAND=DISPLAY|EXECUTE|IGNORE|VERIFY
- Specifies the disposition of MVS commands
read from the '// COMMAND' statement (or the '// command' statement)
of the JCL input stream as follows.
- DISPLAY
- The command is displayed and scheduled for execution.
- EXECUTE
- The command is scheduled for execution. This is the default for JOBCLASS(STC) and JOBCLASS(TSU).
- IGNORE
- The command is ignored (that is, interpreted as a “no operation”.)
- VERIFY
- Specifies that the system displays the command, asks the operator whether the command should be executed, and if the operator replies “YES”, schedules the command for execution. This is the default for JOBCLASS(A-Z, 0–9).
Modification: $T JOBCLASS operator command or cold start
- CONDPURG=Yes|No
- Specifies whether (YES) or not (NO) system data sets (such as
JESMSG and SYSMSG) in this job class are to be conditionally purged.
This parameter is not allowed on the JOBCLASS(class)
initialization statement.
Modification: $T JOBCLASS or cold start.
- COPY=Yes|No
- COPY=Yes specifies that jobs in this job class are to be queued
for output processing as though TYPRUN=COPY was specified on the JOB
statement for these jobs.
The default value of this parameter is No, which specifies that jobs in this job class are to be queued as usual. NO will be ignored if the TYPRUN=COPY parameter is specified on the JOB statement for a job.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS operator command or cold start.
- DSENQSHR{=ALLOW|AUTO|DISALLOW}
- Indicates how the system manages changes in data set disposition
between job steps. When a step includes a DD statement with OLD, NEW
or MOD on the DISP (disposition) keyword, and a later step requests
the same data set as SHR, this parameter controls whether the system
can change the serialization on the data set to shared control; permitting
this change allows other jobs to share that data set. The value specified
interacts with the value specified for DSENQSHR on the JOB card to
determine the behavior:
- ALLOW
- The system is allowed to change the serialization on the data set to shared control if the JOB card specifies ALLOW.
- AUTO
- The system is allowed to change the serialization on the data set to shared control if the JOB card specifies ALLOW or USEJC.
- DISALLOW
- The system is not allowed to change the serialization on the data set to shared control.
Note: Specifying DSENQSHR=AUTO restricts any job that is converted with the class to run only on the z/OS 2.1 version of MVS, or later. If earlier levels of MVS are active in the MAS (JESPLEX), then this additional system restriction could prevent some jobs from running.When yes is indicated, the system is allowed to change the data set serialization to shared control and other jobs may share that data set with this job.Table 1. JOBCLASS attribute for DSENQSHR LANGUAGE JOBCLASS attribute for DSENQSHR JCL AUTO ALLOW DISALLOW ALLOW yes yes no USEJC yes no no DISALLOW no no no - DUPL_JOB=NODELAY|DELAY
- Specifies whether or not JES2 is allowed to concurrently execute
batch jobs with the same name in the same MAS. If DUPL_JOB=DELAY is
specified, JES2 is not allowed to execute batch jobs with the same
name in the same MAS at the same time. Note: DUPL_JOB on a JOBCLASS specification is ignored if JOBDEF DUPL_JOB=NODELAY. If JOBDEF DUPL_JOB=DELAY, that specification can be overridden on a jobclass basis by specifying DUPL_JOB=NODELAY on the JOBCLASS statement.
Modification: $T JOBCLASS operator command or cold start.
- GROUP=name
- Specifies the 2-8 character name of the job class group that the specified job class will be associated with. The group name cannot match any existing job class name (including the default 1-character job class names). This parameter does not apply to the STC and TSU job classes.
- HOLD=Yes|No
- HOLD=Yes specifies that jobs in this job class are to be held
until a RELEASE command for the job is issued by the operator ($A
J).
This parameter defaults to No. No will be ignored if the TYPRUN=HOLD parameter is specified on the JOB statement for a job.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS operator command or cold start.
- IEFUJP=Yes|No
- IEFUJP=No specifies that the IEFUJP exit is not to be taken when
a job is purged. IEFUJP receives
control when a job is ready to be purged from the system; that is,
after the job has been ended and all the SYSOUT output that pertains
to the job has been processed.
This parameter defaults to YES, which specifies that the IEFUJP exit is to be taken when a job is purged.
Modification: $T JOBCLASS operator command or cold start.
- IEFUSO=Yes|No
- IEFUSO=NO specifies that the IEFUSO installation exit is not to
be taken when the SYSOUT limit is reached for a job in this job class. The SYSOUT limit, which is specified
by the OUTLIM parameter on the DD statement, defines the maximum number
of physical records to be written to the associated SYSOUT data set.
When the OUTLIM value is exceeded, JES2 normally calls the IEFUSO
SMF exit routine either to increase the SYSOUT limit or to end the
job. When NO is specified and OUTLIM is exceeded, JES2 abnormally
ends the job.
This parameter defaults to YES, which specifies that the IEFUSO installation exit is to be taken when the SYSOUT limit is reached for a job in this job class.
Modification: $T JOBCLASS operator command or cold start.
- JESLOG=
- Specifies for the indicated jobclass that each job's JESLOG data
(JESMSGLG and JESYSMSG data sets) is to be spun at a certain time
interval, suppressed from being recorded, or not spun at all. Note: Specifying JESLOG=SPIN will cause a job in this class to use at least 2 additional track groups of SPOOL space for the two JESLOG data sets (JESMSGLG or JESYSMSG ). If this job class normally has a large number of jobs that use a minimal amount of SPOOL space, then an increase of 2 track groups could significantly increase SPOOL utilization. Consider these additional SPOOL requirements when deciding whether to use JESLOG=SPIN.
- SPIN
- Jobs running in this job class are 'spinnable'. $TJnnnn,SPIN
can be used to immediately spin the JESMSGLG and JESYSMSG data sets.
- (SPIN,+hh:mm)
- Indicates to spin JESLOG every hh:mm time interval.
where:
- hh is hours and has a range of 0 through 23
- mm is minutes and has a range of 00 through 59
Note: You must specify a minimum of 10 minutes or JES2 issues an error message. Also, for time intervals of less than one hour, you must specify the following format: JESLOG=(SPIN,+00:mm). - (SPIN,hh:mm)
- Indicates to spin JESLOG at hh:mm every 24 hours.
- (SPIN,nnn)
- Indicates to spin JESLOG whenever either JESMSGLG or JESYSMSG
has nnn lines.'nnn is the number (1–999)
of lines in the data set. Note:You must specify a minimum of 500 lines or JES2 issues an error message.
- (SPIN,nnnK)
- Indicates to spin JESLOG whenever either JESMSGLG or JESYSMSG has "nnnK" lines, where "K" indicates thousands of lines.
- (SPIN,nnnM)
- Indicates to spin JESLOG whenever either JESMSGLG or JESYSMSG has "nnnM" lines, where "M" indicates millions of lines.
- SUPPRESS
- Indicates that JES2 will suppress writing to the JESLOG data sets during the execution of jobs defined for this job class. JES2 only writes data to the JESLOG data sets during each job's input service and post–execution processing phases.
- NOSPIN
- Indicates that JESLOG data will not be spun, but will not be suppressed. NOSPIN is the default.
Modification: $T JOBCLASS command or cold start.
- JOBRC=MAXRC|LASTRC
- Specifies the method JES2 uses to determine the return code for
jobs submitted in this class. Specify MAXRC to
use the highest return code of any executed step as the job return
code. Specify LASTRC to use the return code
of the last executed step as the job return code. The default value
is MAXRC.
Modification: $T JOBCLASS operator command or cold start
- JOURNAL=Yes|No
- Specifies whether
(Yes) or not (No) job-related information is to be saved in a job
journal. Job journaling limits the scope of RESTART=YES. If the JOURNAL=Yes parameter is specified:
- JES2 restarts interrupted jobs from the beginning only if the MVS system is unable to restart the job from a step or checkpoint.
- RESTART=NO has no effect; all jobs are requeued for execution.
(Specifying RD=R|RNC on the JCL JOB statement has the same effect.)
JOURNAL=No specifies that information for the job journal is not to be processed for a job in this job class unless RD=R or RD=RNC is specified on the JOB statement for a job or on the EXEC statements for the job.
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 the automatic restart manager, the job journal is not needed (the automatic restart manager does not use the job journal).The default of this parameter is Yes, which specifies that information for the job journal is to be processed for this job class.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS operator command or cold start.
- LOG=Yes|No
- LOG=NO specifies
that the JES2 job log is not to be printed for this job class. The
JES2 job log contains the user's console messages and replies to WTORs
issued during the processing of the job. When No is specified, JES2
statistics information (normally printed with the job) is also suppressed.
This parameter defaults to Yes, which specifies that the job log is to be printed for this job class. Even when LOG=Yes is specified, the job log may be suppressed on an individual job basis through a parameter in the accounting field of the JOB card or by a parameter on a /*JOBPARM control card.
Modification: $T JOBCLASS operator command or cold start
- MODE=JES|WLM
- Indicates whether jobs in this class are to be run under JES-mode
or WLM-mode initiators. See z/OS JES2 Initialization and Tuning Guide for
more information. Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.
Modification: $T JOBCLASS operator command or cold start
- MSGCLASS=msgclass
- Specifies a default message class for started tasks or time-sharing
users. Note: This parameter is only allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.
Modification: $T JOBCLASS operator command or cold start
- MSGLEVEL=(n,m)|(0,1)
- Specifies a message level value (n) for use when the MSGLEVEL
parameter is not specified on a JOB statement. If a MSGLEVEL parameter
is not specified, JCL and allocation/termination messages are recorded
in the system message data set according to the value specified in
this parameter. The character “n” specifies the kinds of JCL listed, as follows:
- 0
- JOB statement only
- 1
- Input statements, cataloged procedure statements, and symbolic parameter substitution values
- 2
- Input statements only, including in–stream procedures.
The character “m” specifies the kinds of allocation/termination messages listed, as follows:- 0
- No messages are to be listed, except in the case of an abnormal termination, in which case allocation/termination messages are listed.
- 1
- Allocation/termination messages are listed.
Modification: $T JOBCLASS operator command or cold start
- NAME=cccccccc
- Specifies the jobclass to be used for modification.
- OUTDisp=([normal] [,abnormal])
- Specifies the default output disposition for JES data sets created
for jobs in this class, depending on whether or not the job abended.
- normal
- Specifies the output disposition if the job does not abend.
- abnormal
- Specifies the output disposition if the job abends.
Valid output dispositions are:- Hold
- Hold the output. JES2 does not process the output until you either
change the disposition to WRITE or KEEP, or release the output. When
the output is released, the disposition changes to WRITE. Note: This specification is honored when the output reaches the destination node.
- Keep
- Process the output and then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.
- Leave
- JES2 does not process the output until you change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to KEEP.
- Purge
- Purge the output immediately.
- Write
- Process the output then purge it.
Only code OUTDISP= on JOBCLASS when you require that system data sets have a specific output disposition regardless of their message class (MSGCLASS=) specification. If you have no such requirement, either code OUTDISP=(), OUTDISP=(,) , or leave it off the JOBCLASS statement completely.
If you do not code OUTDisp=, JES2 assigns the value on the OUTCLASS statement for JES2 member data sets in this class. See z/OS JES2 Initialization and Tuning Guide for more information about specifying output disposition and how JES2 determines output disposition defaults.
Modification: $T JOBCLASS operator command or cold start
- OUTPUT=Yes|No
- OUTPUT=No specifies that no SYSOUT data is to be written for jobs
executed in this job class. Note: Specification of the No option prevents the TSO/E TRANSMIT command from functioning. For further discussion of the relationship between JES2 and the TSO/E interactive data transmission facility, see the description of Exit 13 in z/OS JES2 Installation Exits.
This parameter defaults to YES, which specifies that SYSOUT data is to be written for jobs executed in this job class.
Modification: $T JOBCLASS operator command or cold start
- PERFORM=nnn|000
- Specifies the default performance-group number (0-999) for this
job class. This number is used as the performance-group number on
the JCL EXEC statement when a performance-group number is not specified
on the JCL JOB or EXEC statement for a job of this job class. Note: The performance-group value specified on the EXEC card (step level) has no effect if running in WLM goal mode.
The parameter default is 000, which indicates that no performance-group processing will be performed by JES2. A default value of 1 will be assigned for all steps in a job.
Modification: $T JOBCLASS operator command or cold start
- PGMRNAME=Yes|No
- Specifies whether a programmer name is required (Yes) or not required
(No) on a JCL JOB statement. Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.
Modification: $T JOBCLASS operator command or cold start
- PROCLIB=nn|00
- Specifies the default procedure library number (00-99) which is
to be used for this job class. It allows you to specify procedure
libraries for different job classes. In the JES2 procedure, one DD
statement must be named PROC00. If you specify additional procedure
libraries (01-99) at that time, you may associate these libraries
to a job class by replacing the nn of this parameter with the appropriate
procedure library number. All cataloged procedure libraries to be
used by jobs, time-sharing users, or system tasks must be defined
in the JES2 procedure.
Modification: $T JOBCLASS operator command or cold start
- PROMO_RATE=0| nnn
- Specifies how many positions a job can be moved up the execution
queue in one STARTBY aging cycle (1 minute). The default value PROMO_RATE=0
means that the STARTBY function is disabled for the job class.
Modification: $T JOBCLASS operator command or cold start.
- QHELD=Yes|No
- Specifies whether (Yes) or not (No) jobs in this class are not
selected for execution (meaning they are held) until the class is
released from held status by operator command. Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.
Modification: $T JOBCLASS operator command
- REGION=nnnnx|1M
- Specifies the default for the region size assigned to each job
step. The “nnnn” indicates the number of units that make
up the default region size; the “x” indicates the unit
of measure (either 'K' for Kilobytes or 'M' for Megabytes).
- For nnnnK, the maximum allowable value is 9999K.
- For nnnnM, the maximum allowable value is 2047M.
Note: For STC and TSU the default is 0K.Modification: $T JOBCLASS operator command or cold start
- RESTART=Yes|No
- Specifies
whether (Yes) or not (No) JES2 is to requeue for execution any job
of this job class that had been executing before the IPL of the system
was repeated and a JES2 warm start was performed. The job is restarted
from the beginning, unless the scheduler can restart it from a step
or checkpoint. Job journaling limits the scope of RESTART=Yes. If the JOURNAL=Yes parameter is specified:
- JES2 restarts interrupted jobs from the beginning only if the MVS system is unable to restart the job from a step or checkpoint.
- RESTART=No has no effect; all jobs are requeued
for execution.
(Specifying RD=R|RNC on the JCL JOB statement has the same effect.)
If RESTART=Yes and the jobs are not journaled (JOURNAL=No), JES2 always attempts to restart interrupted jobs in this class from the beginning.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS operator command or cold startNote:- This parameter pertains to restarts that do not involve jobs registered with the MVS automatic restart manager. RESTART is ignored if the job is registered with the automatic restart manager.
- Specifying RESTART=Y or RESTART=N on the /*JOBPARM control statement for a particular job overrides this job class RESTART parameter.
- RESTART=No only applies to restarts after a system failure.
- SCAN=Yes|No
- SCAN=YES specifies that jobs in this job class are to be queued
for output processing immediately after JCL conversion, as though
TYPRUN=SCAN was specified on the JOB statement for these jobs.
This parameter defaults to NO, which specifies that jobs in this job class are to be queued as usual. SCAN=NO will be ignored if the TYPRUN=SCAN parameter is specified on the JOB statement for a job.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS operator command or cold start
- SCHENV=xxxxx
- Specifies
a 1 to 16 character default WLM scheduling environment name to be
used for jobs converted in this job class. SCHENV specified on a JOB
card takes precedence over the value specified here. See the z/OS MVS JCL Reference for
the rules regarding SCHENV names. The SCHENV will be rejected if it
is not defined to WLM.
Modification: $T JOBCLASS operator command or cold start
- SWA= Above|Below
- SWA=Above
specifies that all eligible schedule work area (SWA) control blocks
created for jobs in this job class will be placed above 16 megabytes
in virtual storage.
This parameter defaults to Below, which specifies that all SWA control blocks for jobs in this job class will reside below 16 megabytes in virtual storage.
Modification: $T JOBCLASS operator command or cold start
- SYSSYM[=ALLOW|DISALLOW]
- Specifies whether system symbols are substituted in batch jobs
that are submitted in this JOBCLASS. Symbols are substituted when
the job is processed by the z/OS converter using the system symbols
that are set on the system where the conversion occurs. Note: You can choose the system that converts a job using SYSAFF on the JOB or JOBPARM JCL/JECL card or SYSTEM on the JOB card. If CNVT_SCHENV= is set to HONOR on the JOBDEF statement, then you can also choose the system that converts a job by associating a system with the job scheduling environment.
Modification: $T JOBCLASS operator command or cold start
- TIME=(mmmmmm,ss)|(30,0)
- Specifies the default for the maximum processor time that each
job step may run. The “mmmmmm” indicates minutes (0-357912);
the “ss” indicates seconds (0-59). The value specified
is subject to the limits described for the TIME parameter in z/OS MVS JCL Reference.
This default TIME= specification is used when no TIME parameter is specified on the JCL EXEC statement. (See z/OS MVS JCL Reference for further details on specifying the TIME parameter on the EXEC statement. See notes for $T job C=class in z/OS JES2 Commands for further details concerning the results of changing the job class.)
Modification: $T JOBCLASS operator command or cold start
Note: This parameter only defaults the TIME for the EXEC statement; not for the JOB statement. - TYPE6=Yes|No
- TYPE6=No specifies that JES2 is not
to produce type 6 SMF records for jobs in this job class. Type 6 SMF
records are written for each group of job-related data sets and each
spin data set (available for printing) that is processed. Type 6 records
are described in z/OS MVS System Management Facilities (SMF).
This parameter defaults to Yes, which specifies that JES2 is to produce type 6 SMF records for this job class. When type 6 records are to be produced, the BUFNUM= parameter on the SMFDEF statement must specify two or more SMF buffers.
Modification: $T JOBCLASS operator command or cold start
Note: Suppressing SMF information may not be consistent with your installation's security policy. - TYPE26=Yes|No
- TYPE26=No specifies that JES2 is
not to produce type 26 (job summary) SMF records for jobs in this
job class. A full explanation of type 26 records is provided in z/OS MVS System Management Facilities (SMF).
This parameter defaults to Yes, which specifies that JES2 is to produce type 26 SMF records for jobs in this job class. When type 26 records are to be produced, the BUFNUM= parameter on the SMFDEF statement must specify two or more SMF buffers.
Modification: $T JOBCLASS operator command or cold start
Note: Suppressing SMF information may not be consistent with your installation's security policy. - XBM= procname
- Specifies the procedure name JES2 uses as the target of an EXEC
statement. The procedure names a program that processes the input
submitted to this job class. Specifying this parameter reserves this
job class for the Execution Batch Monitoring (XBM) facility. See z/OS JES2 Initialization and Tuning Guide for
details on using
this facility.
If you do not specify this parameter, or nullify the parameter, JES2 does not use the XBM facility and processes jobs in this class normally.
Note: This parameter is not allowed on JOBCLASS(STC) and JOBCLASS(TSU) initialization statements.Modification: $T JOBCLASS command or cold start
- XEQcount=MAXimum=4,294,967,295
- Specifies the maximum number of jobs that can execute concurrently
in the class. The limit is the total number of jobs executing in the
MAS. For example a limit of 5 means there can be 3 jobs running on
one member and 2 jobs running on another member.
Modification: $T JOBCLASS operator command or cold start