Versions Compared

Key

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

...

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

Anchor
Cancel
Cancel
Cancel

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:

  • 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 Manually Running and Controlling Tasks#Changing Changing the Priority of a Task Instance).

Set Started

Resets the Started Time of a Manual Task instance.

Skip

Disregards a task instance (see Manually Running and Controlling Tasks#Skipping a 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
Issuing Commands from the Activity Monitor
Issuing Commands from the Activity Monitor
Issuing Commands from the Activity Monitor

...

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 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.

...

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
Launch a Task Manually with Temporary Variable Values

...

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:

Task Timezone Preference

Task Timezone Preference

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:

  • The Time Zone Preference field in the Workflow Details = Inherited, or the Time Zone Preference field in the Workflow Details = --System Default-- and the Task Timezone Preference Universal Controller system property = Inherited, the dialog shows the Time Zone field.
  • The Time Zone Preference field in the Workflow Details = Server, or the Time Zone Preference field in the Workflow Details = --System Default-- and the Task Timezone Preference Universal Controller system property = Server, the dialog does not show the Time Zone field.

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.
 
By default, the value of Time Zone is Server.

Step 7

When you are finished, click Submit. The Controller populates the variables with the values you supplied and launches the task.

Variable Resolution

If the Task Field Resolution Required Universal Controller system property is set to true, and there is a variable in a resolvable field - such as Command, Script, Parameters (including z/OS Parameters), and Environment Variables - that is unresolved at runtime, the task will transition to Start Failure.

...

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.

...

Note
titleNote

The confirmation for z/OS Re-run from an In Doubt status will happen regardless of the System Default Confirm Task Instance Commands Universal Controller system property value.

...

Note
titleNote

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:

...