...
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 Commands Supported for Task Instance Statuses for 794512803 for a list of task instances (and their statuses) for which these commands can be issued.
...
Command | Description | ||||||
---|---|---|---|---|---|---|---|
| Cancels a running task instance (see Cancelling a Task Instance 794512803), 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 Clearing All Dependencies of a Task Instance 794512803). | ||||||
Clear Exclusive | Clears mutually exclusive dependencies of a task instance (see Clearing Mutually Exclusive Dependencies of a Task Instance 794512803). | ||||||
Clear Instance Wait | Clears Previous Instance Wait specifications for this task instance (see Clearing Previous Instance Wait Specifications of a Task Instance 794512803). | ||||||
Clear Predecessors | Workflow tasks only: Clears predecessor dependencies of a task instance (see Clearing Predecessor Dependencies of a Task Instance 794512803). | ||||||
Clear Resources | Clears resource dependencies of a task instance (see Clearing Resource Dependencies of a Task Instance 794512803). | ||||||
Clear Time/Wait Delay | Clears all Wait To Start and Delay On Start specifications for this task instance (see Clearing Time Wait/Delay Specifications of a Task Instance 794512803). | ||||||
Force Finish | Places a task instance into the Finished status (see Force Finishing a Task Instance 794512803), including a task instance in a completed workflow (status = Success, Finished, Skipped). | ||||||
Force Finish (Halt) | Places a task instance into the Finished status (see Force Finishing (Halt) a Task Instance) 794512803), 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 Force Finish/Cancelling a Task Instance 794512803); 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 Force Finish/Cancelling (Halt) a Task Instance 794512803). | ||||||
Hold | Temporarily prevents a task instance from running (see Putting a Task Instance on Hold 794512803). | ||||||
Release | Removes a task instance from being on Hold (see Releasing a Task Instance from Hold 794512803). | ||||||
Release Recursive | Workflow tasks only: Removes a workflow and its task instances from being on Hold (see Releasing a Task Instance from Hold 794512803). | ||||||
Re-run | Not applicable for Workflow tasks: Re-runs a task instance (see Re-running a Task Instance 794512803), 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 Re-running a Task Instance 794512803) 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 Changing the Priority of a Task Instance 794512803). | ||||||
Set Started | Resets the Started Time of a Manual Task instance. | ||||||
Skip | Disregards a task instance (see Skipping a Task Instance 794512803). | ||||||
Skip Path | Disregards a task instance and all of its dependent task instances (see Skipping a Task Instance 794512803). | ||||||
Unskip | Removes the Skip status of a task instance (see Unskipping a Task Instance 794512803). |
Anchor | ||||
---|---|---|---|---|
|
...
For a description of each command, see Issuing Commands Against Task Instances 794512803.
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) |
| |
Instance Wait (17) | All |
|
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 |
|
...
The following task types are Agent-based task types:
- Linux/Unix
- Windows
- IBM i
- z/OS
- Universal Command
- SAP
- PeopleSoft
- File Transfer
- Agent File Monitor
- Remote File Monitor
- System Monitor
- z/OS Monitor
- Universal
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. |
...
Force Finishing (Halt) a Task Instance
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. |
...
Force Finish/Cancelling (Halt) a Task Instance
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 Clearing Resource Dependencies of a Task Instance and Clearing Mutually Exclusive Dependencies of a Task Instance 794512803 and 794512803, below. To clear all dependencies, see Clearing All Dependencies of a Task Instance 794512803, 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 > 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. |
...
Clear Previous Instance Wait Specifications of a Task Instance from the Activity Monitor or Task Instances List
Step 1 | Select the task instance whose Previous Instance Wait specifications you want to clear. |
---|---|
Step 2 | Click Clear > Clear Instance Wait. The task instance is launched normally. |
...
Step 1 | View the Workflow that contains the task instance whose Previous Instance Wait specifications you want to clear. |
---|---|
Step 2 | Select the task instance for which you want to clear Previous Instance Wait specifications. |
Step 3 | Select Commands. |
Step 4 | Select Clear Instance Wait. The task instance is launched normally. |
...