cancel 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.
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
report
in
job stream apwkly(0900 02/19/06)
on workstation site3
,
run the following command: cj=site3#apwkly(0900 02/19/06).report
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
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
- In the Welcome page, select Monitor your workload, or in the navigation bar at the top of the page, click .
- Select an engine.
- In Object Type, select Job.
- Click Run to run the monitoring task.
- From the table containing the list of jobs, select a job and click .