cancel job
You can use the cancel command to cancel a job.
Overview
Syntax and command line options
Before you run the command, you can specify the different options to customize the result. The command line parameters pend and noask are optional. This allows you to complete a command using the single parameter jobselect. You can create the command as described below.
ocli plan cancel job | cj = <jobselect><pend><noask>
You can add the option pend
to resolve the dependencies associated
with the job, before the job is cancelled. The details that are required with each
parameters are as follows:
jobselect
Specify the job to update, by means of attributes and qualifiers.
For example,
WA_AGT_0#JOB_STREAM.JOB
.
pend
Action | Job status | Result |
---|---|---|
pend added | Not started | The job is not cancelled until all the associated
dependencies are resolved. After the job is cancelled, the jobs
and job streams that are related to the cancelled job are
removed from the dependency. Note: While
the cancel action is postponed, the
notation Cancel Pend is listed in the
Dependencies column of the job in
a showjobs display. |
pend added | started | The option is ignored and any job or job streams that are related to the cancelled job are removed from the dependency. |
- You can use the rerun command to rerun jobs that are cancelled, or that are marked Cancel Pend. You can also add and delete dependencies on jobs that are marked Cancel Pend.
- You can immediately cancel a job that is marked Cancel Pend, either enter a release command for the job or enter another cancel command without the pend option.
- For the jobs with expired until parameter, 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 the options added along with the job, 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.
noask
When you add the option as an argument the agent will not ask for confirmation before taking action on each qualifying job.
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 workstationsite3
, run the following command:ocli plan 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:ocli plan cj mis5(1100 02/10/06).setup~state=abend
- To cancel job
job3
in job streamsked3(0900 02/19/03)
only after its dependencies are resolved, run the following command:ocli plan cj sked3(0900 02/19/06).job3;pend