HCL Workload Automation, Version 9.4

cancel job

Windows Cancels a job.

You must have cancel access to the job.

Syntax

{cancel job | cj} jobselect
     [;pend]
     [;noask]

Arguments

jobselect
See Selecting jobs in commands.
pend
Cancels the job only after its dependencies are resolved.
noask
Specifies not to prompt for confirmation before taking action on each qualifying job.

Comments

If you cancel a job before it is launched, it does not launch. If you cancel a job after it is launched, it continues to run. If you cancel a job that is running and it completes in the ABEND state, no automatic job recovery steps are attempted.

If you do not use the ;pend option, jobs and job streams that are dependent on the cancelled job are released immediately from the dependency.

If you include the ;pend option, and the job has not been launched, cancellation is deferred until all of the dependencies, including an at time, are resolved. Once all the dependencies are resolved, the job is cancelled and any jobs or job streams that are dependent on the cancelled job are released from the dependency. During the period the cancel is deferred, the notation [Cancel Pend] is listed in the Dependencies column of the job in a showjobs display.

If you include the ;pend option and the job has already been launched, the option is ignored, and any jobs or job streams that are dependent on the cancelled job are immediately released from the dependency.

You can use the rerun command to rerun jobs that have been cancelled, or that are marked [Cancel Pend]. You can also add and delete dependencies on jobs that are marked [Cancel Pend].

To immediately cancel a job that is marked [Cancel Pend], you can either enter a release command for the job or enter another cancel command without the ;pend option.

For jobs with expired until times, the notation [Until] is listed in the Dependencies column in a showjobs display, and their dependencies are no longer evaluated. If such a job is also marked [Cancel Pend], it is not cancelled until you release or delete the until time, or enter another cancel command without the ;pend option.

To stop evaluating dependencies, set the priority of a job to zero with the altpri command. To resume dependency evaluation, set the priority to a value greater than zero.

Note: In the case of internetwork dependencies, cancelling a job in the EXTERNAL job stream releases all local jobs and job streams from the dependency. Jobs in the EXTERNAL job stream represent jobs and job streams that have been specified as internetwork dependencies. The status of an internetwork dependency is not checked after a cancel is performed. For more information see Managing internetwork dependencies in the plan.

Examples

To cancel job report in job stream apwkly(0900 02/19/06) on workstation site3, run the following command: 
cj=site3#apwkly(0900 02/19/06).report
To cancel job setup in job stream mis5(1100 02/10/06), if it is not in the ABEND state, run the following command: 
cj mis5(1100 02/10/06).setup~state=abend
To cancel job job3 in job stream sked3(0900 02/19/03) only after its dependencies are resolved, run the following command: 
cj sked3(0900 02/19/06).job3;pend

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the Welcome page, select Monitor your workload, or in the navigation bar at the top of the page, click System Status and Health > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Job.
  4. Click Run to run the monitoring task.
  5. From the table containing the list of jobs, select a job and click More Actions > Cancel.