|
- AUTH=
- Specifies which commands will be accepted through COMMAND JCL
statements in the job stream. The groups includes:
- SYS
- system commands
- IO
- input/output commands
- CONS
- console commands
- INFO
- information commands (such as display)
- ALL
- all operator command types
For an explanation of operator command groups and
the relationship of JES3 to MVS™ command groups, see z/OS JES3 Commands and
z/OS MVS System Commands,
respectively.
- COMMAND=
- Specifies the disposition of commands entered through COMMAND
JCL statements in the job stream as follows.
- DISPLAY
- The command is displayed and scheduled for execution.
- EXECUTE
- The command is scheduled for execution.
- IGNORE
- The command is ignored (that is, interpreted as a “no operation”.).
IGNORE is the default.
- 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.
- PARM=
- Specifies an option list of 21 EBCDIC characters. The option list
has 10 fields that you must code in the format shown. Two fields have
a fixed value always set by JES3: positions 13 and 15-18. Six fields
are set at initialization: positions 2-3, 4-9, 10-12, 19, 20, and
21. JES3 restricts one field (position 1) to certain values. If you
specify any value incorrectly, the default value for that field is
used. You can substitute values only for the underscored items in
the following format: bppmmmmsscccrlaaaaefh
- b
- Specifies whether an account number or programmer name is required
for this job, and whether the scheduler work area is to be located
above 16-megabytes when the job executes. The following table lists
the combination of options.
b |
SWA Above 16 Mg |
Acct. Num. Required |
Prog. Name Required |
---|
0 |
No |
No |
No |
1 |
No |
No |
Yes |
2 |
No |
Yes |
No |
3 |
No |
Yes |
Yes |
4 |
Yes |
No |
No |
5 |
Yes |
No |
Yes |
6 |
Yes |
Yes |
No |
7 |
Yes |
Yes |
Yes |
No values other than 0 to 7 are valid. Default value is
0.
- pp
- Specifies the default job priority. This field is ignored by JES3
because the default priority comes from the job specified by the PRTY
parameter on the STANDARDS statement. The range of values is from
00 to 14; the default value is 00.
- mmmmss
- Specifies the maximum length of time each job step may execute.
When a step exceeds this limit, the step is canceled. JES3 assigns
the time limit defined in the initialization stream when a job's JOB
or EXEC JCL statement does not specify a time limit.
The first
4 characters indicate minutes; the last 2 characters indicate seconds.
The maximum time limit that can be specified on the CIPARM statement
is 999959 (approximately 1 week); the default time limit is 30 minutes
(003000). If you want to allow job steps to run for an unlimited
duration, specify 144000.
Users can specify a time limit greater
or less than the initialization stream default by explicitly coding
a time limit on a job's JOB or EXEC JCL statement. The maximum time
limit that can be specified in a job's JCL is 357912 minutes, 59 seconds
(approximately 249 days).
- ccc
- Specifies the job-step region default. Specify 3 numeric characters
as the number of 1024-byte blocks assigned to each job step. (Do not
specify 000.) JES3 assigns this region size to a step when the JOB
or EXEC statement does not specify the region size and does specify
ADDRSPC=VIRT for the step. The default value is 256.
Note: - You must specify this value or the REGION parameter if you are
defining a C/I FSS. The default does not provide adequate region
size.
- This is ignored if the REGION parameter is specified.
- l
- Specifies how the BLP parameter of the DD statements is to be
processed:
- 0
- Specifies that the BLP parameter is to be ignored; the LABEL parameter
is processed as if NL was specified.
- 1
- Specifies that the BLP parameter is to be processed as intended.
The default is 1.
- e
- Specifies the job MSGLEVEL default.
- 0
- indicates that only the JOB statement is to be written as output.
- 1
- indicates that all input JCL statements (including in-stream procedures)
are to be recorded in the system message data set. The default is
1.
- 2
- indicates that only input JCL statements are to be written.
- f
- Specifies the allocation MSGLEVEL default.
- 0
- indicates that no allocation/termination messages are recorded
in the system message data set unless the job terminates abnormally.
- 1
- indicates that all allocation/termination messages are recorded
in the system message data set. The default is 1.
- h
- Specifies the MSGCLASS default. The default class is A.
The option list must be 21 characters long in
the fixed format described above. The installation may specify only
those values defined by b, mmmmss, ccc, l, e, f, and h. JES3 values
are assumed for the other fields.
- PARMID=
- Specifies a 2-byte identifier associated with this option list.
This parameter provides the facility to have a variety of C/I option
lists. The operator may select the option list to be used by specifying
the identifier on the *CALL, CR, DR, or TR command.
The
CIPARM statement with a PARMID of 01 is always used to supply default
values to jobs submitted to a node through NJE. If no CIPARM PARMID=01
statement is coded, JES3 provides a statement containing the values
identified by the Statement Default entry shown in the Statement Summary
section.
- REGION=
- Specifies the job-step region default size.
- nnnn
- Specifies the 1 to 4-digit number of units used for the default
region size for a job step. This value overrides the region size in
the PARM option list, and is otherwise processed the same way. If
you do not specify this parameter, JES3 obtains the region size from
the PARM option list.
- x
- Indicates the unit of measure as kilobytes (K) or megabytes (M)
- For nnnnK, the maximum allowable value is 9999K
- For nnnnM, the maximum allowable value is 2047M
Note: - The CIPARM values for the two MSGLEVEL subparameters are defaults
and are applied on a subparameter basis. Each CIPARM MSGLEVEL default
value is used if its corresponding MSGLEVEL subparameter is not specified
on the JOB card in the JESJCLIN data set. For example, if CIPARM CIPARM,PARM=(00000003006030E00021B),PARMID=10
is used with JOB card _//MYJOB JOB MSGLEVEL=(,0),... the MSGLEVEL
would be (2,0). The first MSGLEVEL subparameter is not specified on
the JOB card, so the CIPARM default value (2) is used. The second
subparameter is specified on the JOB card, so that is the value used.
If
no MSGLEVEL is specified on the JOB card, then both CIPARM defaults
are used (MSGLEVEL=(2,1)). The MSGLEVEL specified on the JOB statement
in the JESJCLIN data set is not updated to reflect any changes made
when applying the CIPARM MSGLEVEL defaults.
- For started tasks with JCL obtained from a procedure in a JES3
managed procedure library, START command processing generates a JOB
card. If the START command did not request a MSGLEVEL, then MSGLEVEL=1
is appended to the generated JOB card. When that JCL is passed to
JES3, the rules described in the previous note are used. For additional
information on the START command, see z/OS MVS System Commands.
For additional information on MSGLEVEL and started tasks, see z/OS MVS JCL Reference
|