Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 1

...

You can issue commands against task instances from:

See 438095359 Commands Supported for Task Instance Statuses 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 438095359 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 438095359 Clearing All Dependencies of a Task Instance).

Clear Exclusive

Clears mutually exclusive dependencies of a task instance (see 438095359 Clearing Mutually Exclusive Dependencies of a Task Instance).

Clear Instance WaitClears Previous Instance Wait specifications for this task instance (see  438095359 Clearing Previous Instance Wait Specifications of a Task Instance).

Clear Predecessors

Workflow tasks only: Clears predecessor dependencies of a task instance (see 438095359 Clearing Predecessor Dependencies of a Task Instance).

Clear Resources

Clears resource dependencies of a task instance (see 438095359 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 438095359 Clearing Time Wait/Delay Specifications of a Task Instance).

Force Finish

Places a task instance into the Finished status (see 438095359 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 438095359 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 438095359 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 438095359 Force Finish/Cancelling (Halt) a Task Instance).

Hold

Temporarily prevents a task instance from running (see 438095359 Putting a Task Instance on Hold).

Release

Removes a task instance from being on Hold (see 438095359 Releasing a Task Instance from Hold).

Release Recursive

Workflow tasks only: Removes a workflow and its task instances from being on Hold (see 438095359 Releasing a Task Instance from Hold).

Re-run

Not applicable for Workflow tasks: Re-runs a task instance (see 438095359 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 438095359 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:

  • Application Control
  • Remote File Monitor
  • Linux/Unix
  • PeopleSoft
  • 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 438095359 Changing the Priority of a Task Instance).

Set Started

Resets the Started Time of a Manual Task instance.

Skip

Disregards a task instance (see 438095359 Skipping a Task Instance).

Skip Path

Disregards a task instance and all of its dependent task instances (see 438095359 Skipping a Task Instance).

Unskip

Removes the Skip status of a task instance (see 438095359 Unskipping a Task Instance).

Anchor
Issuing Commands from the Activity Monitor
Issuing Commands from the Activity Monitor

...

For a description of each command, see 438095359 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
  • 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

...

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 438095359 and 438095359 Clearing Resource Dependencies of a Task Instance and Clearing Mutually Exclusive Dependencies of a Task Instance, below. To clear all dependencies, see 438095359 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 > 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.

...