...
You can issue commands against task instances from:
- Activity Monitor
- Task Instances list (and the Task Instances list for a specific task)
- Workflow Monitor.
See 13205678 Commands Supported for Task Instance Statuses for a list of task instances (and their statuses) for which these commands can be issued.
...
Command | Description | ||||||
|---|---|---|---|---|---|---|---|
| Cancels a running task instance (see 13205678 Cancelling a Task Instance), including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Clear All Dependencies | Workflow tasks only: Clears all dependencies (predecessors, resources, and exclusive) of a task instance (see 13205678 Clearing All Dependencies of a Task Instance). | ||||||
Clear Exclusive | Clears mutually exclusive dependencies of a task instance (see 13205678 Clearing Mutually Exclusive Dependencies of a Task Instance). | ||||||
Clear Predecessors | Workflow tasks only: Clears predecessor dependencies of a task instance (see 13205678 Clearing Predecessor Dependencies of a Task Instance). | ||||||
Clear Resources | Clears resource dependencies of a task instance (see 13205678 Clearing Resource Dependencies of a Task Instance). | ||||||
Clear Time/Wait Delay | Clears all Wait To Start and Delay On Start specifications for this task instance (see 13205678 Clearing Time Wait/Delay Specifications of a Task Instance). | ||||||
Force Finish | Places a task instance into the Finished status (see 13205678 Force Finishing a Task Instance), including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Force Finish (Halt) | Places a task instance into the Finished status (see 13205678 Force Finishing (Halt) a Task Instance), including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Force Finish/Cancel | Cancels a task and places it into the Finished status (see 13205678 Force Finish/Cancelling a Task Instance); including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Force Finish/Cancel (Halt) | Cancels a task and places it into the Finished status (see 13205678 Force Finish/Cancelling (Halt) a Task Instance). | ||||||
Hold | Temporarily prevents a task instance from running (see 13205678 Putting a Task Instance on Hold). | ||||||
Release | Removes a task instance from being on Hold (see 13205678 Releasing a Task Instance from Hold). | ||||||
Release Recursive | Workflow tasks only: Removes a workflow and its task instances from being on Hold (see 13205678 Releasing a Task Instance from Hold). | ||||||
Re-run | Not applicable for Workflow tasks: Re-runs a task instance (see 13205678 Re-running a Task Instance), including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Re-run (Suppress Intermediate Failures) | Not applicable for Workflow tasks: Re-runs a task instance (see 13205678 Re-running a Task Instance) specifying that intermediate failures be suppressed, including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Retrieve Output | Retrieves output (Standard Output and/or Standard Error, or in the case of z/OS, the Job Log) for any running or completed task instance, limited to the following supported task types:
| ||||||
Set Completed | Sets a Manual Task instance to the Success status. | ||||||
Set Priority | Sets the priority of a task instance in Started, Running, or Queued status to High, Medium, or Low (see 13205678 Changing the Priority of a Task Instance). | ||||||
Set Started | Resets the Started Time of a Manual Task instance. | ||||||
Skip | Disregards a task instance (see 13205678 Skipping a Task Instance). | ||||||
Skip Path | Disregards a task instance and all of its dependent task instances (see 13205678 Skipping a Task Instance). | ||||||
Unskip | Removes the Skip status of a task instance (see 13205678 Unskipping a Task Instance). |
| Anchor | ||||
|---|---|---|---|---|
|
...
For a description of each command, see 13205678 Issuing Commands Against Task Instances.
For details and instructions on issuing these commands, see the specific section (below) on this page.
Status | Task Type | Supported Commands |
|---|---|---|
Action Required (60) | Manual |
|
Cancel Pending (99) |
| |
Cancelled (130) | All |
|
Confirmation Required (125) | z/OS |
|
Defined (0) | All |
|
Exclusive Requested (22) | All |
|
Exclusive Wait (23) | All |
|
Execution Wait (33) |
| |
Failed (140) | All (except Workflows) |
|
Finished (190) | All |
|
Held (20) | All |
|
In Doubt (110) |
| |
Queued (40) |
| |
Resource Requested (25) | All tasks using Virtual Resources |
|
Resource Wait (30) | All tasks using Virtual Resources |
|
Running (80) | All |
|
Running Problems (81) | Workflow |
|
Skipped (180) | All |
|
Start Failure (120) | All |
|
Started (70) | Agent-based and Manual |
|
Submitted (43) | z/OS |
|
Success (200) | All |
|
Time Wait (15) | All (except Timer) |
|
Undeliverable (35) |
| |
Waiting (10) | All |
|
...
- From a tasks list
- From task Details
| Note |
|---|
Use Set the Task Launch Reason Required system property to true to add a required launch reason field to the manual launch command of a task or trigger. These details will be added to the Notes section of the task instance details.
|
| Anchor | ||||
|---|---|---|---|---|
|
Step 1 | From the Automation Center navigation pane, select Tasks > <type of task>. The Tasks list for that task type displays. | |||||
|---|---|---|---|---|---|---|
Step 2 | Either:
An Action menu displays. | |||||
Step 3 | Select either:
| |||||
Step 4 | To view Details about running task instances, select Task Instances > Activity from the Automation Center navigation pane and click on the task instance. |
...
Step 1 | Select the task you want to launch. |
|---|---|
Step 2 | Either:
|
| Anchor | ||||
|---|---|---|---|---|
|
...
Set Priority on a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance for which you want to set the priority. |
|---|---|
Step 2 | Right-click the task instance and, on the Action menu, select the priority level. |
Step 3 | When the Set Priority command has been executed, the Controller displays the following message at the bottom of the list: |
...
Step 1 | View the Workflow that contains the task instance for which you want to set the priority. |
|---|---|
Step 2 | Select the task instance for which you want to set priority. |
Step 3 | Select Commands. |
Step 4 | Select a priority for the task instance. |
...
Additionally, you can re-run a task instance in the In Doubt status if the Allow In Doubt Re-run Universal Controller system property is set to true.
To suppress intermediate failures during a manual re-run, use Re-run (Suppress Intermediate Failures) instead of Re-run.
...
Re-run a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to re-run. |
|---|---|
Step 2 | Click Re-run. The task status changes to the next appropriate status as though it had just been launched. |
...
Step 1 | View the Workflow that contains the task instance you want to re-run. |
|---|---|
Step 2 | Select the task instance you want to re-run. |
Step 3 | Select Commands. |
Step 4 | Select Re-run. The task status changes to the next appropriate status as though it had just been launched, and the Workflow Console opens to display information about the re-run. |
...
Cancel a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to cancel. |
|---|---|
Step 2 | Click Cancel. The task status changes to Cancelled. |
...
Step 1 | Open the Workflow Monitor for the workflow that contains the task instance you want to cancel. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Cancel. The task status changes to Cancelled and the Workflow Console opens to display information about the cancellation. |
...
Force Finish a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to Force Finish. |
|---|---|
Step 2 | Click Force Finish. The task status changes to Finished. |
...
Step 1 | View the workflow that contains the task instance you want to Force Finish. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Force Finish. The task status changes to Finished and the Workflow Console opens to display information about the Force Finish. |
| Anchor | ||||
|---|---|---|---|---|
|
Just as with the Force Finish command, the Force Finish (Halt) command puts a task instance into the Finished status, regardless of what the task instance is doing.
...
Force Finish (Halt) a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to Force Finish (Halt). |
|---|---|
Step 2 | Click Force Finish (Halt). The task status changes to Finished. |
...
Step 1 | View the workflow that contains the task instance you want to Force Finish (Halt). |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Force Finish (Halt). The task status changes to Finished and the Workflow Console opens to display information about the Force Finish (Halt). |
...
Force Finish/Cancel a Task Instance from the Activity Monitor
Step 1 | Select the task instance you want to Force Finish/Cancel. |
|---|---|
Step 2 | Click Force Finish/Cancel. The task status changes to Finished. |
...
Step 1 | View the workflow that contains the task instance you want to Force Finish/Cancel. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Force Finish/Cancel. The task status changes to Finished and the Console opens to display information about the Force Finish/Cancel. |
| Anchor | ||||
|---|---|---|---|---|
|
Just as with the Force Finish/Cancel command, the Force Finish/Cancel (Halt) command cancels a task instance and puts it into Finished status, regardless of what the task instance is doing.
...
Force Finish/Cancel (Halt) a Task Instance from the Activity Monitor
Step 1 | Select the task instance you want to Force Finish/Cancel (Halt). |
|---|---|
Step 2 | Click Force Finish/Cancel (Halt). The task status changes to Finished. |
...
Step 1 | View the workflow that contains the task instance you want to Force Finish/Cancel (Halt). |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Force Finish/Cancel (Halt). The task status changes to Finished and the Console opens to display information about the Force Finish/Cancel (Halt). |
...
Hold a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to put on hold. |
|---|---|
Step 2 | Click Hold. The task status changes to Held. |
...
Step 1 | View the workflow that contains the task instance you want to put on hold. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Hold. The task status changes to Held and the Workflow Console opens to display information about the hold. |
...
Release a Held Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to release from hold. |
|---|---|
Step 2 | Click Release or Release Recursive. The task status changes to the next appropriate status according to where it was in processing at the time it was put on hold. |
...
Step 1 | View the Workflow that contains the task instance you want to release. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Release. The task status changes to the next appropriate status according to where it was in processing, and the Workflow Console opens to display information about the release. |
...
Once a task instance has been skipped, the only command you can run against it is Unskip.
Skip a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to skip. |
|---|---|
Step 2 | Click Skip. The task status changes to Skipped. |
Step 3 | To skip the task instance and all of its dependent task instances, click Skip Path. The task status of the task instance and all of its dependent task instances changes to Skipped. |
...
Step 1 | View the Workflow that contains the task instance you want to skip. |
|---|---|
Step 2 | |
Step 3 | Select Commands. |
Step 4 | Select Skip. The task status changes to Skipped, and the Console opens to display information about the skip. |
Step 5 | To skip the task instance and all of its dependent task instances, click Skip Path. The task status of the task instance and all of its dependent task instances changes to Skipped, and the Console opens to display information about the skip. |
...
Unskip a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance you want to unskip. |
|---|---|
Step 2 | Click Unskip. The task instance will run when all of its dependencies have been satisfied. |
...
Step 1 | View the Workflow that contains the task instance(s) you want to unskip. |
|---|---|
Step 2 | Select a task instance. (You can issue commands only against one task at a time within the Workflow Monitor.) |
Step 3 | Select Commands. |
Step 4 | Select Unskip. A confirmation message will appear in the Console, and the task instance will run when all of its dependencies have been satisfied. |
...
Marking a dependency as satisfied has the same result as clearing a dependency.
You can mark a dependency as satisfied on task instances in the following status: Defined, Waiting, Held.
...
For a task instance running inside of a Workflow, you can clear all predecessor dependencies to allow that task instance to run. Clearing a predecessor dependency has the same result as satisfying a predecessor dependency.
You can clear predecessor dependencies of a task instance while it is in any of the following statuses: Defined, Waiting, Held.
| Note | ||
|---|---|---|
| ||
Clearing predecessor dependencies does not include the clearing of resource and mutually exclusive dependencies. To clear these dependencies, see 13205678 and 13205678 Clearing Resource Dependencies of a Task Instance and Clearing Mutually Exclusive Dependencies of a Task Instance, below. To clear all dependencies, see 13205678 Clearing All Dependencies of a Task Instance, below. |
One method is available for clearing predecessor dependencies of a task instance:
...
Step 1 | View the Workflow that contains the task instance whose predecessor dependencies you want to satisfy. |
|---|---|
Step 2 | Select the task instance for which you want to clear predecessor dependencies. |
Step 3 | Select Commands. |
Step 4 | Select Clear Predecessors. The task instance is launched normally. |
...
Clear Resource Dependencies of a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance whose resources you want to clear. |
|---|---|
Step 2 | Click Clear Resources. Resource dependencies are cleared from the task instance. |
...
Step 1 | View the Workflow that contains the task instance(s) you want to clear of resource dependencies. |
|---|---|
Step 2 | Select a task instance. (You can issue commands only against one task at a time within the Workflow Monitor.) |
Step 3 | Select Commands. |
Step 4 | Select Clear Resources. A confirmation message will appear in the Console, and the task instance will run without resources. |
...
Clear Mutually Exclusive Dependencies of a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance whose mutually exclusive dependencies you want to clear. |
|---|---|
Step 2 | Click Clear Exclusive. Mutually exclusive dependencies of the task instance are cleared, and the task instance is launched normally. |
...
Step 1 | View the Workflow that contains the task instance you want to clear of mutually exclusive dependencies. |
|---|---|
Step 2 | Select a task instance. (You can issue commands only against one task at a time within the Workflow Monitor.) |
Step 3 | Select Commands. |
Step 4 | Select Clear Exclusive. A confirmation message will appear in the Console, and the task instance will run normally. |
...
Clear All Dependencies of a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance whose dependencies you want to clear. |
|---|---|
Step 2 | Click Clear All Dependencies. All dependencies are cleared from the task instance and it is launched normally. |
...
Step 1 | View the Workflow that contains the task instance whose dependencies you want to clear. |
|---|---|
Step 2 | Select the task instance for which you want to clear predecessor dependencies. |
Step 3 | Select Commands > Clear All Dependencies. All dependencies are cleared from the task instance and it is launched normally. |
...
Clear All Time Wait/Delay Specifications of a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance whose Time Wait/Delay specifications you want to clear. |
|---|---|
Step 2 | Click Clear Time Wait/Delay. The task instance is launched normally. |
...
Step 1 | View the Workflow that contains the task instance whose Time Wait/Delay specifications you want to clear. |
|---|---|
Step 2 | Select the task instance for which you want to clear Time Wait/Delay specifications. |
Step 3 | Select Commands. |
Step 4 | Select Clear Time Wait/Delay. The task instance is launched normally. |
...