Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can issue commands against task instances from:

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

Anchor
Cancel
Cancel
Cancel

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 WaitClears 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:

  • Application Control
  • Remote File MonitorIBM i
  • Linux/Unix
  • PeopleSoft
  • Remote File Monitor
  • SAP
  • Universal
  • Universal Command
  • Windows
  • z/OS

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
Issuing Commands from the Activity Monitor
Issuing Commands from the Activity Monitor

...

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
  • Force Finish
  • Force Finish (Halt)
  • Force Finish/Cancel
  • Force Finish/Cancel (Halt)
  • Set Started
  • Set Completed

Cancel Pending (99)

Agent-based

  • Force Finish
  • Force Finish (Halt)
  • Retrieve Output

Cancelled (130)

All

  • Force Finish
  • Force Finish (Halt)
  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Confirmation Required (125)

z/OS

  • Force Finish
  • Force Finish (Halt)
  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Defined (0)

All

  • Clear All Dependencies
  • Clear Predecessors
  • Clear Time Wait/Delay
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only.

Exclusive Requested (22)

All

  • Clear All Dependencies
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path

Exclusive Wait (23)

All

  • Clear All Dependencies
  • Clear Exclusive
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only.

Execution Wait (33)

Agent-based

  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path

Failed (140)

All (except Workflows)

  • Force Finish
  • Force Finish (Halt)
  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Finished (190)

All

  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Held (20)

All

  • Clear All Dependencies
  • Clear Time Wait/Delay
  • Clear Predecessors
  • Force Finish
  • Force Finish (Halt)
  • Release
  • Release Recursive - Workflow tasks only.
  • Skip
  • Skip Path

In Doubt (110)

Agent-based

  • Force Finish
  • Force Finish (Halt)
  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output
Instance Wait (17)All 
  • Clear All Dependencies
  • Clear Time Wait/Delay
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only.

Queued (40)

Agent-based

  • Cancel
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Set Priority

Resource Requested (25)

All tasks using Virtual Resources

  • Clear All Dependencies
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path

Resource Wait (30)

All tasks using Virtual Resources

  • Clear All Dependencies
  • Clear Resources
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only.

Running (80)

All

  • Cancel
  • Force Finish
  • Force Finish (Halt)
  • Force Finish/Cancel
  • Force Finish/Cancel (Halt)
  • Release Recursive - Workflow tasks only.
  • Retrieve Output
  • Set Priority

Running Problems (81)

Workflow

  • Cancel
  • Force Finish
  • Force Finish (Halt)
  • Force Finish/Cancel
  • Force Finish/Cancel (Halt)
  • Hold
  • Release Recursive - Workflow tasks only.

Skipped (180)

All

  • Unskip

Start Failure (120)

All

  • Force Finish
  • Force Finish (Halt)
  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Started (70)

Agent-based and Manual

  • Cancel
  • Force Finish
  • Force Finish (Halt)
  • Force Finish/Cancel
  • Force Finish/Cancel (Halt)
  • Retrieve Output
  • Set Completed - Manual tasks only.
  • Set Priority

Submitted (43)

z/OS

  • Force Finish
  • Force Finish (Halt)

Success (200)

All

  • Re-run - Not applicable for Workflow tasks.
  • Re-run (Suppress Intermediate Failures) - Not applicable for Workflow tasks.
  • Retrieve Output

Time Wait (15)

All (except Timer)

  • Clear All Dependencies
  • Clear Time Wait/Delay
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only

Undeliverable (35)

Agent-based

  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path

Waiting (10)

All

  • Clear All Dependencies
  • Clear Predecessors
  • Clear Time Wait/Delay
  • Force Finish
  • Force Finish (Halt)
  • Hold
  • Skip
  • Skip Path
  • Release Recursive - Workflow tasks only

...

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
Manually Launching a Task
Manually Launching a Task

...

Step 1

From the Automation Center navigation pane, select Tasks > <type of task>. The Tasks list for that task type displays.

Step 2

Either:

  • Right-click a single task.
  • Ctrl-click multiple tasks, release the Ctrl key, and right-click any of the selected tasks.

An Action menu displays.
 

Step 3

Select either:

Note
titleNote

If you selected multiple tasks, Launch with Variables is disabled.

 
Universal Controller creates an instance of each selected task and runs it.

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
launch with variables
launch with variables

...

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:
 
Command Set Priority <High/Medium/Low> successfully against task instance <name>.

...

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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

Select the task instance.

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
titleNote

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.

...