Parameter field
A JOB statement has two kinds of parameters: positional and keyword. Symbolic parameters are not supported on the JOB statement. All parameters are optional, however, your installation might require the accounting information parameter and the programmer’s name parameter.
- CLASS *
- GROUP
- PASSWORD
- RD *
- RESTART
- SCHENV
- SYSTEM
- SYSAFF
- SECLABEL
- TYPRUN
- USER
An asterisk indicates that the parameter is ignored. The other parameters listed result in a JCL error and job failure.
If JES detects an error in any parameter on the JOB statement, the error causes a JCL error and a job failure; the system flushes all subsequent JCL statements, including any SYSOUT-specific DD statements directing output to any other class or destination.
Positional Parameters: A JOB statement can contain two positional parameters. They must precede all keyword parameters. You must code the accounting parameter first, followed by the programmer’s name parameter.
| POSITIONAL PARAMETERS | VALUES | PURPOSE |
|---|---|---|
See section Accounting information parameter |
account-number ,accounting-information: up to 143 characters |
Specifies an account number and other accounting information, formatted as required by the installation. This parameter might be required by the installation. |
See section Programmer's name parameter |
programmer’s-name: 1 - 20 characters | Identifies the owner of the job. This parameter might be required by the installation. |
Keyword Parameters: A JOB statement can contain the following keyword parameters. You can code any of the keyword parameters in any order in the parameter field after the positional parameters.
| KEYWORD PARAMETERS | VALUES | PURPOSE |
|---|---|---|
See section ADDRSPC parameter |
VIRT: virtual (pageable) storage REAL: central (nonpageable) storage |
Indicates the type of storage required for the job. |
See section BYTES parameter |
nnnnnn: 0 - 999999 | Indicates the maximum amount of output to be printed for the job's sysout data sets, in thousands of bytes, and the action the system is to take if the maximum is exceeded. |
See section CARDS parameter |
nnnnnnnn: 0 - 99999999 | Indicates the maximum amount of output, in cards, to be punched for the job's sysout data sets, and the action the system is to take if the maximum is exceeded. |
|
nnnnn: 1 - 65535 | Specifies the coded character set identifier indicating the character code conversion performed on reads from and writes to tapes accessed in ISO/ANSI Version 4 format. |
See section CLASS parameter |
jobclass: 1-8 characters: A - Z, 0 - 9, and some special characters: See Subparameter definition. |
In a non-APPC scheduling environment, assigns the job to a job class. |
See section COND parameter |
code: 0 - 4095 |
Specifies the return code tests used to determine whether a job continues processing or be terminated. |
See section DSENQSHR parameter |
DISALLOW: The system is not allowed to change the serialization on the data set to shared
control. USEJC: The system might change the serialization on the data set to shared control when the DSENQSHR parameter value for the JES jobclass is AUTO. When the DSENQSHR JES jobclass parameter value is ALLOW or DISALLOW, the system is not allowed to change the serialization of the data set. ALLOW: The system might change the serialization on the data set to shared control when the DSENQSHR parameter value for the JES jobclass is AUTO or ALLOW. When the DSENQSHR JES jobclass parameter value is DISALLOW, the system is not allowed to change the serialization of the data set. |
Indicates how the system treats changes in data set disposition between job steps. |
See section EMAIL parameter |
Email address: between 3 and 246 characters | In a non-APPC scheduling environment, identifies the job’s owner to RACF®, SRM, and other system components. |
See section GDGBIAS parameter |
JOB: Relative references to a generation data set are resolved on a job basis. The system
establishes the relationship between the relative generation number and the absolute generation
number when the generation data set is first referenced in the job. This relationship is consistent
throughout the job. STEP: Relative references to a generation data set are resolved on a job step basis. The system establishes the relationship between the relative generation number and the absolute generation number when the generation data set is first referenced in each job step. Each job step that references the generation data set establishes a new relationship. |
Specifies how relative references to a generation data set in a DD JCL statement are resolved. |
See section GROUP parameter |
group-name: 1 - 8 alphanumeric or national characters ($, #, @) | In a non-APPC scheduling environment, identifies a group that a RACF-defined user is to be connected. |
See section JESLOG parameter |
SPIN: JESLOG is spin-eligible. There is an optional second
operand that specifies the time or the time interval. NOSPIN: JESLOG is not spun. SUPPRESS: JESLOG is suppressed. |
Specifies whether the JESLOG data set should be spin-eligible and if it should be automatically spun at a particular time or time interval. |
See section JOBRC parameter |
MAXRC: The job completion code is set to the highest return
code of any step in the job, or if the completion of the job fails
because of an ABEND, the job completion code is set to the last ABEND
code; this is the default parameter. LASTRC: The job completion code is set to the return code or ABEND code of the last step that is executed in the job. (STEP,stepname[.procstepname]): The job completion code is set to the return code or ABEND code of the step that is indicated by the stepname.[.procstepname] parameter. If this step does not exist, a JCL error is generated. If this step does not run, the processing is the same as if MAXRC is specified. stepname: the name of the job step. procstepname]: the name of the job step within the procedure. |
Use the JOBRC parameter to control how the job completion code (presented by JES2 or JES3) is set. By default (when JOBRC is not specified), the job completion code is set to the highest return code of any step, or if the job's execution fails because of an ABEND, the job completion code is set to the last ABEND code; however, this parameter can be used to request that the job completion code be set to the return code of the last executed step or a particular step that more accurately reflects the success or failure of the job. |
See section LINES parameter |
nnnnnn: 0 - 999999 | Indicates the maximum amount of output to be printed for the job's sysout data sets, in thousands of lines, and the action the system is to take if the maximum is exceeded. |
See section MEMLIMIT parameter |
nnnnn: 0 - 99999 | Specifies the limit on the total number of usable virtual pages above the bar for a single address space. |
See section MSGCLASS parameter |
class: A - Z, 0 - 9 | In a non-APPC scheduling environment, assigns the job log to an output class. |
See section MSGLEVEL parameter |
statements:
messages:
|
Indicates the job control information to be printed in the job log. |
See section NOTIFY parameter |
nodename: 1 - 8 alphanumeric or national characters ($, #,
@) userid: 1 - 8 alphanumeric or national characters ($, #, @), 1 - 7 alphanumeric or national characters ($, #, @) when userid specified without nodename |
In a non-APPC scheduling environment, requests that the system send a message to a userid when this background job completes. |
See section PAGES parameter |
nnnnnnnn: 0 - 99999999 | Indicates the maximum amount of output, in pages, to print for the job's sysout data sets, and the action the system is to take if the maximum is exceeded. |
See section PASSWORD parameter |
password or new-password: 1 - 8 alphanumeric or national characters ($, #, @) | In a non-APPC scheduling environment, identifies the current RACF password or specifies a new RACF password. |
See section PERFORM parameter |
n: 1 - 999 | In WLM compatibility mode (not available on z/OS® V1R3 or later systems), specifies the job’s
performance group. In WLM goal mode, can be used for classification of the job to a service class or report class. |
See section PRTY parameter |
priority (JES2): 0 - 15 priority (JES3): 0 - 14 | In a non-APPC scheduling environment, JES2: Assigns the job’s queue selection priority. JES3: Assigns the job’s initiation or selection priority in its job class. |
See section RD parameter |
R: restart, checkpoints allowed
RNC: restart, no checkpoints NR: no restart, checkpoints allowed NC: no restart, no checkpoints |
In a non-APPC scheduling environment, indicates whether the operator should perform automatic step restart, if the job fails, and controls whether checkpoints are written for CHKPT macros or DD statement CHKPT parameters. |
See section REGION parameter |
valueK: 1 - 7 digits
from 1 - 2096128 valueM: 1 - 4 digits from 1 - 2047 |
Specifies the amount of space in kilobytes or megabytes required by the job. |
See section REGIONX parameter |
value1: Specifies the amount of memory to be assigned below the 16 MB line. value2: Specifies the amount of memory to be assigned above the 16 MB line, but below 2 GB (that is, “below the bar”.) |
Specifies the amount of central or virtual storage that the step requires below and above the 16 MB line. |
See section RESTART parameter |
*: at first step
stepname: at named step procstepname: step is in named procedure checkid: at checkpoint in first or named step |
In a non-APPC scheduling environment, specifies restart of a job at the beginning of a step or from a checkpoint within a step. |
See section SECLABEL parameter |
seclabel-name: 1 - 8 alphanumeric or $, #, @, characters | In a non-APPC scheduling environment, identifies the security label of the job to RACF. |
See section SCHENV parameter |
schenv-name: 1 - 16 alphanumeric or $, #, @, _ characters | In a non-APPC scheduling environment, identifies the name of the WLM scheduling environment associated with this job. |
|
Specifies 1-33 JES2 member and JES3 system names. Each is a 1-4 character name. A value of * (asterisk character) indicates the submitting system. A value of IND indicates that the job must run on a member in independent mode. | Specifies 1-33 JES2 members and JES3 systems that are eligible to process the job. |
|
Specifies 1-32 system names. Each is a 1-8 character valid system name. A value of * (asterisk character) indicates the submitting system. | Specifies 1-32 systems that are eligible to process the job. |
See section TIME parameter |
minutes: 1 - 357912 seconds: 1 - 59 1440: Specifies that the job can use the processor for an unlimited amount of time. NOLIMIT: Specifies that the job can use the processor for an unlimited amount of time. MAXIMUM: Specifies that the job can use the processor for the maximum amount of time, 357912 minutes. |
Specifies the maximum time the job is to use the processor and requests messages giving the time used. |
See section TYPRUN parameter |
COPY: copies job stream to sysout
data set (JES2 only) HOLD: holds job JCLHOLD: holds job before JCL processing (JES2 only) SCAN: scans JCL for syntax errors |
In a non-APPC scheduling environment, requests special job processing. |
See section UJOBCORR parameter |
user-correlator: 1 - 32 characters in length |
Specifies the user portion of the job correlator that is associated with the current job. The job correlator (JOBCORR parameter) is a 64-byte token that uniquely identifies a job to JES. The JOBCORR value is composed of a 32-byte system portion, which ensures a unique value, and a 32-byte user portion which helps identify the job to the system. The UJOBCORR parameter specifies this 32-byte user portion of the job correlator. |
See section USER parameter |
userid: 1 - 7 alphanumeric or $, #, @ characters | In a non-APPC scheduling environment, identifies the job’s owner to RACF, SRM, and other system components. |