...
- Activity Monitor
- Task Instances list (and the Task Instances list for a specific task)
- Workflow Monitor.
See Manually Running and Controlling Tasks#Commands 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 Manually Running and Controlling Tasks#Cancelling 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 Manually Running and Controlling Tasks#Clearing Clearing All Dependencies of a Task Instance). | ||||||
Clear Exclusive | Clears mutually exclusive dependencies of a task instance (see Manually Running and Controlling Tasks#Clearing Clearing Mutually Exclusive Dependencies of a Task Instance). | ||||||
Clear Predecessors | Workflow tasks only: Clears predecessor dependencies of a task instance (see Manually Running and Controlling Tasks#Clearing Clearing Predecessor Dependencies of a Task Instance). | ||||||
Clear Resources | Clears resource dependencies of a task instance (see Manually Running and Controlling Tasks#Clearing 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 Manually Running and Controlling Tasks#Clearing Clearing Time Wait/Delay Specifications of a Task Instance). | ||||||
Force Finish | Places a task instance into the Finished status (see Manually Running and Controlling Tasks#Force 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 Manually Running and Controlling Tasks#Force 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 Manually Running and Controlling Tasks#Force 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 Manually Running and Controlling Tasks#Force Force Finish/Cancelling (Halt) a Task Instance). | ||||||
Hold | Temporarily prevents a task instance from running (see Manually Running and Controlling Tasks#Putting Putting a Task Instance on Hold). | ||||||
Release | Removes a task instance from being on Hold (see Manually Running and Controlling Tasks#Releasing Releasing a Task Instance from Hold). | ||||||
Release Recursive | Workflow tasks only: Removes a workflow and its task instances from being on Hold (see Manually Running and Controlling Tasks#Releasing Releasing a Task Instance from Hold). | ||||||
Re-run | Not applicable for Workflow tasks: Re-runs a task instance (see Manually Running and Controlling Tasks#Re 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 Manually Running and Controlling Tasks#Re 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 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 Manually Running and Controlling Tasks#Changing Changing the Priority of a Task Instance). | ||||||
Set Started | Resets the Started Time of a Manual Task instance instance. | ||||||
Skip | Disregards a task instance (see Manually Running and Controlling Tasks#Skipping Skipping a Task Instance). | ||||||
Skip Path | Disregards a task instance and all of its dependent task instances (see Manually Running and Controlling Tasks#Skipping Skipping a Task Instance). | ||||||
Unskip | Removes the Skip status of a task instance (see Manually Running and Controlling Tasks#Unskipping Unskipping a Task Instance). |
Anchor | ||||
---|---|---|---|---|
|
Issue a Command Against a Single Task Instance
...
Anchor | ||||
---|---|---|---|---|
|
Issue a Command Against a Single Task Instance
...
If you want to receive a confirmation message after issuing a command but before the command is performed, set the System Default Confirm Task Instance Commands Universal Controller system property to Yes (the default is No).
For example:
Issue a Command Against a Task Instance within the Workflow
Step 1 | Right-click the task instance to display a pop-up menu of commands appropriate for the selected task instance. |
---|---|
Step 2 | Click Commands and then click the command that you want to issue against the selected task instance. |
For example:
Issue a Command Against the Workflow Task Instance
Step 1 | Right-click the Workflow Monitor canvas to display a pop-up menu of commands appropriate for the workflow task instance. |
---|---|
Step 2 | Click Commands and then click the command that you want to issue against the workflow task instance. |
For example:
Anchor | ||||
---|---|---|---|---|
|
...
For a description of each command, see Manually Running and Controlling Tasks#Issuing Issuing Commands Against Task Instances.
For details and instructions on issuing these commands, see the specific section (below) on this page.
...
- From a tasks list
- From task Details
Note |
---|
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 |
...
|
Anchor | ||||
---|---|---|---|---|
|
...
Step 1 | Display the task you want to launch. |
---|---|
Step 2 | Access the Action menu. |
Step 3 | Select Launch Task with Variables.... The Launch Task (with Variables) dialog displays. Any variables attached to this task automatically are displayed in alphabetic order (a-z). |
Step 4 | As needed, set the variable values or add new variables. |
Step 5 | If you want to put the task instance in held status when the task is started, select Hold on Start. A Hold Reason field then displays which allows you to enter information about why the task will be put on hold when it starts. |
Step 6 | If the task is a Workflow (as shown here), and: Time Zone lets you select a time zone for this specific launch of the Workflow so that it runs, and evaluates both
Time Zone lets you select a time zone for this specific launch of the Workflow so that it runs, and evaluates both Run Criteria and Execution Restrictions, according to that time zone. |
Step 7 | When you are finished, click Submit. The Controller populates the variables with the values you supplied and launches the task. |
...
When you select to launch a task, a dialog displays that ask you to confirm that task that you want to launch:
You also can launch a task that you have modified without saving the modifications.
When you select to launch a modified but unsaved task (single task only), the confirmation dialog specifies that you are about to launch a task with unsaved modifications:
Anchor | ||||
---|---|---|---|---|
|
...
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 whose dependencies you want to satisfy. |
---|---|
Step 2 | Locate and right-click on the task dependency (the connector line between two tasks). |
Step 3 | Select Commands. |
Step 4 | Select Mark as Satisfied. If all other dependencies are satisfied, the task instance is launched normally. |
...
Evaluating a Dependency
For task instances running inside of a Workflow, you can clear all predecessor dependencies to allow that task instance to run. Clearing a predecessor dependency evaluate a variable condition dependency.
When the Evaluate Edge command is executed, an Evaluate dialog pops up and display the First Value, First Value(resolved), Operator, Second Value, Second Value(resolved), and the Evaluation result.
One method is available for evaluating a dependency:
- From the Workflow Monitor
Evaluating a Variable Condition Dependency from the Workflow Monitor
Step 1 | View the Workflow that contains the task instance whose dependencies you want to evaluate. |
---|---|
Step 2 | Locate and right-click on the task dependency (the connector line between two tasks). |
Step 3 | Select Commands. |
Step 4 | Select Evaluate. |
Anchor | ||||
---|---|---|---|---|
|
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.
...
Note | ||
---|---|---|
| ||
Clearing predecessor dependencies does not include the clearing of resource and mutually exclusive dependencies. To clear these dependencies, see Manually Running and Controlling Tasks#Clearing Clearing Resource Dependencies of a Task Instance and Manually Running and Controlling Tasks#Clearing Clearing Mutually Exclusive Dependencies of a Task Instance, below. To clear all dependencies, see Manually Running and Controlling Tasks#Clearing Clearing All Dependencies of a Task Instance, below. |
One method is available for clearing predecessor dependencies of a task instance:
...