TIME parameter - IBM-JCL

Parameter Type

Keyword, optional

Purpose

Use the TIME parameter to specify the maximum amount of time that a job step may use the processor or to find out through messages how much processor time a step used.

You can use the TIME parameter on an EXEC statement to increase or decrease the amount of processor time available to a job step over the default value.

A step that exceeds its allotted time abnormally terminates and causes the job to terminate, unless an installation exit routine extends the time for the job. The exit routine IEFUTL is established through System Management Facilities (SMF).

1.Syntax

You can omit the parentheses if you code only 1440, 0, or the processor time in minutes.

2.Subparameter Definition

minutes
Specifies the maximum number of minutes the step can use the processor. Minutes must be a number from 0 through 357912 (248.55 days).

seconds
Specifies the maximum number of seconds that the step can use the processor, in addition to any minutes that are specified. Seconds must be a number from 0 through 59.

1440 or NOLIMIT
Indicates that the step can use the processor for an unlimited amount of time.(“1440” literally means “24 hours.”)

Also code TIME=1440 or TIME=NOLIMIT to specify that the system is to allow this step to remain in a continuous wait state for more than the installation time limit, which is established through SMF.

MAXIMUM
Indicates that the step can use the processor for the maximum amount of time. Coding TIME=MAXIMUM allows the step to run for 357912 minutes.

0 Indicates that the step is to use the time remaining from the previous step. If the step exceeds the remaining time available, the step abnormally terminates.

3.Defaults
Each job step has a time limit. If you do not specify a TIME parameter on the JOB statement, the time limit for any job step is:

  • The value you specify for the TIME parameter on its EXEC statement, or
  • The default time limit (that is, the JES default job step time limit), if you do not specify a TIME parameter on its EXEC statement.

4.Overrides
If you specify either MAXIMUM or a value in minutes or seconds other than 1440 for the JOB statement TIME parameter, the system can reduce the processor time available to a job step. In those two cases, the system sets the time limit for the step to the smaller of the two following values:

  • The job time remaining after all previous job steps have completed.
  • The time limit that was specified or the default time limit.

5.On an EXEC Statement that Calls a Procedure
If an EXEC statement calls a cataloged or in-stream procedure, the TIME parameter is added to or overrides the TIME parameter on:

  • The EXEC statement named in the procstepname qualifier. The information applies only to the named procedure step. The EXEC statement can have as many TIME.procstepname parameters as the procedure has steps; each TIME parameter must specify a unique procstepname.

If procstepname is not coded, the TIME parameter applies to the entire procedure and nullifies any TIME parameters on EXEC statements in the procedure. For example, suppose you specify TIME=5 on an EXEC statement that calls a procedure. The first step in the procedure is allowed 5 minutes, the second step is allowed 5 minutes minus the time used by the first step, the third step is allowed 5 minutes minus the time used by the first and second steps, and so forth, regardless of any TIME parameter values on EXEC statements in the procedure.

TIME=1440 and TIME=NOLIMIT also nullify any TIME parameters on EXEC statements in the procedure. Specifying TIME=1440 or TIME=NOLIMIT on the calling EXEC statement allows the procedure to have unlimited processor time.

6.Examples of the TIME Parameter

Example

//STEP1 EXEC PGM=GRYS,TIME=(12,10)

This statement specifies that the maximum amount of time the step can use the processor is 12 minutes, 10 seconds.

Example

//FOUR EXEC PGM=JPLUS,TIME=(,30)

This statement specifies that the maximum amount of time the step can use the processor is 30 seconds.

Example

//INT EXEC PGM=CALC,TIME=5

This statement specifies that the maximum amount of time the step can use the processor is 5 minutes.

Example

//LONG EXEC PGM=INVANL,TIME=NOLIMIT

This statement specifies that the step can have unlimited use of the processor. Therefore, the step can use the processor and can remain in a wait state for an unspecified period of time, if not restricted by the JOB statement TIME parameter.

Example

//STP4 EXEC PROC=BILLING,TIME.PAID=(45,30),TIME.BILL=(112,59)

This statement calls cataloged or in-stream procedure BILLING. The statement specifies different time limits for each of the procedure steps: PAID and BILL.

Example

//STP6 EXEC PGM=TIMECARD,TIME=MAXIMUM

This statement specifies that the step can use the processor for 357912 minutes, if not restricted by the JOB statement TIME parameter.

Example

STEP1 can use the processor for 50 seconds. If STEP1 actually uses the processor for only 40 seconds, STEP2 can use the processor for 10 seconds, because that is the time remaining from the previous step.

Example

STEP1 can use the processor for 25 seconds. If STEP1 actually uses the processor for only 15 seconds, the time limit for STEP2 is the smaller of the following values:

  • The job time remaining (35 seconds)
  • The time limit specified on the EXEC statement for STEP2 (40 seconds).

In this case, the job time remaining is the smaller value, so STEP2 can use the processor for 35 seconds. If STEP2, then, actually uses the processor for only 30 seconds, STEP3 can use the processor for 5 seconds, because that is the time remaining from the previous step.

Example

Assume that the default time limit for class 5 is 5 minutes. The time limit for STEP1 is 5 minutes (the default). If STEP1 actually uses the processor for 4 minutes, the time limit for STEP2 is the smaller of the following values:

  • The job time remaining (4 minutes)
  • The default time limit (5 minutes).

In this case, the job time remaining is the smaller value, so STEP2 can use the processor for 4 minutes.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM-JCL Topics