FORCE-JOB-CANCEL

Cancel user job

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

Function

The FORCE-JOB-CANCEL command forces a user job to terminate. The user job addressable by its TSN or a monitoring job variable is immediately canceled, without waiting for privileged system routines being used to run to completion. This procedure may in some circumstances lead to inconsistencies in some system tables. Hence, it is advisable to use the FORCE-JOB-CANCEL command only if the CANCEL-JOB command is unsuccessful and continuation of the session depends on cancellation of the job. Please note the following:

• Use FORCE-JOB-CANCEL only as a last resort (if there is the risk of a deadlock).

• Leave at least 10 minutes between CANCEL-JOB and FORCE-CANCEL-JOB.

• Run SHOW-JOB-STATUS beforehand to check the status of the job.

• Answer all unanswered messages at the console.

• FORCE-JOB-CANCEL may also be applied to jobs in a PASS-LOOP (Q13, Pendcode 04). However, this should be preceded by a thorough check that the correct job is being aborted: Waiting jobs usually do not cause but are affected by lock conflicts.

Execution of the command leads to termination of the task with the message

CAN0KIL: ABNORMAL TASK TERMINATION ENFORCED BY COMMAND

and, in the case of privileged applications, possibly to a system dump which is generated without any prior query to the operator.

Use of the command by the operator can be forbidden by means of the system parameter NRTKILL.

Format

FORCE-JOB-CANCEL                                                                                                                                

JOB-IDENTIFICATION = *TSN(...) / *MONJV(...)
	*TSN(...)
		|		TSN = <alphanum-name 1..4>
	*MONJV(...)
		|		MONJV = <filename 1..54 without-gen-vers>
,TEXT = *NO / <c-string 1..72>
,DUMP = *YES / *NO

Operands

JOB-IDENTIFICATION = *TSN(...) / *MONJV(...)
Selection of the job identification.

JOB-IDENTIFICATION = *TSN(...)
The job is addressed by its TSN.

TSN = <alphanum-name 1..4>
The TSN of the job in question.

JOB-IDENTIFICATION = *MONJV(...)
The job is not addressed by its TSN but via a monitoring job variable.

MONJV = <filename 1..54 without gen-vers>
Monitoring job variable of the job in question.

TEXT = *NO / <c-string 1..72>
Specifies whether a text should be output to SYSOUT, and if so which text, before the job is terminated. The specified string may be up to 72 characters in length. If the job which is to be terminated is monitored by a monitoring job variable, the first 51 characters are embedded in it (see the CANCEL-JOB command).

DUMP =
Defines whether a system dump is to be output for the job to be canceled.

DUMP = *YES 
A system dump is generated.

DUMP = *NO

No system dump. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	CMD0002	Command executed with a warning
	1	CMD0202	Syntax error
	64	JMS0630	Semantic error
	64	JMS0640	MONJV error, illegal access or invalid time of call
	130	JMS0660	Repeat command later