CHANGE-TASK-CPU-LIMIT

Change maximum CPU time for task

Component:	BS2000
Functional area:	Job processing
Domain:	JOB
Privileges:	OPERATING TSOS
Routing code:	P

Function

The CHANGE-TASK-CPU-LIMIT command allows systems support to increase a task’s maximum CPU time (task time limit, see also section "Time limits in BS2000"). This is a way of preventing important batch jobs being terminated prematurely because they have exceeded their CPU time limit.

Systems support can use the SHOW-JOB-STATUS command to check up on the elapsed time and the CPU time limit of a batch job which must not be terminated prematurely and can then run CHANGE-TASK-CPU-LIMIT to raise its CPU limit in good time.
When a batch job reaches its CPU time limit, message EXC0070 is displayed on the operator terminal. Systems support now has a maximum of 20 minutes in which to raise the job’s CPU time limit using the CHANGE-TASK-CPU-LIMIT command. If the limit is not raised within this period, the batch job terminates.
If the CPU time limit is passed while a program is running, any STXIT routine defined for the program will not be processed unless the CPU limit is raised within 20 minutes.

Format

CHANGE-TASK-CPU-LIMIT                                                                                                                         

JOB-IDENTIFICATION = *TSN(...) / *MONJV(...)
	*TSN(...)
		|	TSN = <alphanum-name 1..4>
	*MONJV(...)
		|	MONJV = <filename 1..54 without-gen-vers>
,ADD = *SECONDS(...) / *PERCENT(...)
	*SECONDS(...)
		|	SECONDS = <integer 1..32767 seconds>
	*PERCENT(...)
		|	PERCENT = <integer 1..100>

Operands

JOB-IDENTIFICATION =
Type of job identification.
Jobs may be identified by task sequence number (TSN) or by monitoring JV (MONJV).

JOB-IDENTIFICATION = *TSN(...)
The job is identified by its task sequence number (TSN).

TSN = <alphanum-name 1..4>
TSN of the job whose CPU time limit is to be raised.

JOB-IDENTIFICATION = *MONJV(...)
The job is identified by its monitoring JV.

MONJV = <filename 1..54 without-gen-vers>
Name of the JV monitoring the job whose CPU time limit is to be raised. The job must run on the local system.

ADD = *SECONDS(...) / *PERCENT(...) 
Specifies the amount by which the CPU time limit is to be raised. The increase can be given in seconds or as a percentage.

ADD = *SECONDS(...)
The increase is given in seconds.

SECONDS = <integer 1..32767 seconds > 
Number of seconds by which the CPU time limit is to be raised.

ADD = *PERCENT(...)
The increase is given as a percentage of the current CPU time limit.

PERCENT = <integer 1..100> 
Percentage by which the CPU time limit is to be raised.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
1	0	CMD0001	Maximum CPU limit reached
	32	CMD0221	Internal error
	64	CMD0216	No authorization
	64	NTIC001	Parameter error; TSN or. MONJV unknown