z/OS JES3 Initialization and Tuning Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameters

z/OS JES3 Initialization and Tuning Reference
SA32-1005-00

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:
  1. 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.
  2. 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:
  1. 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.

  2. 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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014