cancel sched

Overview

If you cancel a workflow before it starts, the workflow does not run. If you attempt to cancel a workflow after it starts, the tasks in the stream that are started will complete. The remaining tasks from the workflow are canceled. To run the cancel command, you must have the cancel access to the task.

Syntax and command line options

Before you run the cancel sched command, you must give the details of the command line options. The pend and noask parameters are optional. This allows you to complete a command by using only the jstreamselect parameter. You can enter the command as follows:

ocli plan cancel sched | cs jstreamselect [;pend] [;noask]

You can add the pend option to resolve dependencies associated with the task before you cancel the task. The details that are required with each parameters are as follows:

jstreamselect: Specify the workflow to update, by means of attributes and qualifiers.

pend

You can use the pend option to remove the dependencies that are associated with the workflow that you plan to cancel. If you do not use the pend option, tasks and workflows that are dependent on the canceled task are released immediately from the dependency. The different scenarios that are related to the pend option are described in the following table.


Action	Workflow status	Result
pend added	Not launched	The workflow is not canceled until all associated dependencies are resolved. After the workflow is cancelled, the tasks and workflows that are related to the cancelled workflow are removed from the dependencies. Note: While the cancel action is postponed, a `Cancel Pend` notice is listed in the Dependencies column of the related task in a showsched display.
pend added	Launched	The tasks that are not started are canceled and related tasks or workflows that are related are removed from the dependencies.

Notes:

You can immediately cancel a workflow that is marked as [Cancel Pend] by either entering a release command for the workflow or entering another cancel command without the pend option.
If the canceled workflow contains tasks defined with the every option, only the last instance of such tasks is listed as canceled in a showjobs display.

noask: When you add the noask option as an argument, the agent does not ask for confirmation before it acts on each qualifying item.

Examples

To cancel the sched2(1100 04/12/07) workflow on stat2 workstation, run the following command:
```
ocli plan cs=stat2#sched2(1100 04/12/07)
```
To cancel the mas3(0700 08/11/10) workflow when it is in the STUCK state, run the following command:
```
ocli plan cs mas3(0700 08/11/10)+state=stuck
```