Versions Compared

Key

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

...

Command

Description

Anchor
Cancel
Cancel
Cancel

Cancels a running task instance (see 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 Clearing All Dependencies of a Task Instance).

Clear Exclusive

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

Clear Predecessors

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

Clear Resources

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

Force Finish

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

Hold

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

Release

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

Release Recursive

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

Re-run

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

Set Started

Resets the Started Time of a Manual Task instance instance.

Skip

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

Skip Path

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

Unskip

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

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


Image RemovedImage Added

Issue a Command Against a Single Task Instance

...

Anchor
Issuing Commands from the Task Instances List
Issuing Commands from the Task Instances List
Issuing Commands from the Task Instances List


Image RemovedImage Added
 

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:

Image RemovedImage Added

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:
 

Image RemovedImage Added

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:
 

Image RemovedImage Added

Anchor
Commands Supported for Task Instance Statuses
Commands Supported for Task Instance Statuses
Commands Supported for Task Instance Statuses

...

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

Image Added


Anchor
Launch one or More Task from a Tasks List
Launch one or More Task from a Tasks List
Launch One or More Tasks from a Tasks List

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.
 
Image RemovedImage Added

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:

Image RemovedImage Added


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.
 
Image RemovedImage Added

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).
 
Image RemovedImage Added

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:

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

...

When you select to launch a task, a dialog displays that ask you to confirm that task that you want to launch:

Image RemovedImage Added

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:

Image RemovedImage Added

Anchor
Changing the Priority of a Task Instance
Changing the Priority of a Task Instance
Changing the Priority of a Task Instance

...

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.
 
Image RemovedImage Added

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

...