Versions Compared

Key

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

...

Step 1

Display the Task Details of the task for which you are creating the System Operation.

Step 2

Click the Actions tab. A list of any defined Actions for that task displays. For example, the following Actions list shows that one Abort Actions have been created for this task.
 

Step 3

Click the Image Removed Image Added button that displays on the System Operations row. The System Operation Details pop-up displays.
 

Step 4

Using the field descriptions, below, as a guide, complete the fields as needed.

Step 5

Click the Image Removed Image Added  button to save the record in the Controller database.

Step 6

If appropriate, repeat these steps for any additional System Operations you want to create.

...

Field Name

Description

Action Criteria

This section contains criteria for performing the action.

Anchor
Action Inheritance
Action Inheritance
Action Inheritance

Include Page
IL:Action Inheritance - 6.4.1
IL:Action Inheritance - 6.4.1

Anchor
Status
Status
Status

The status of this task, by itself or together with an exit code, that will trigger this System Operation action. You can specify as many statuses as needed.

Anchor
Exit Codes
Exit Codes
Exit Codes

Include Page
IL:Exit Codes Trigger Actions
IL:Exit Codes Trigger Actions

Anchor
On Late Start
On Late Start
On Late Start

Include Page
IL:On Late Start
IL:On Late Start

Anchor
On Late Finish
On Late Finish
On Late Finish

Include Page
IL:On Late Finish
IL:On Late Finish

Anchor
On Early Finish
On Early Finish
On Early Finish

Include Page
IL:On Early Finish
IL:On Early Finish

Anchor
On Projected Late
On Projected Late
On Projected Late

Include Page
IL:On Projected Late
IL:On Projected Late

Anchor
Description
Description
Description

Description of this action.

Action Details

This section contains additional details about the action.

Anchor
System Operation
System Operation
System Operation

Specific system operation to perform.
 
Options:

  • Suspend Agent
  • Resume Agent
  • Suspend Agent Cluster
  • Resume Agent Cluster
  • Suspend Cluster Membership
  • Resume Cluster Membership
  • Set Agent Task Execution Limit
  • Set Cluster Task Execution Limit
  • Set Virtual Resource Limit
  • Run Task Instance Command
  • Launch Task
  • Trigger Now
  • Enable Trigger
  • Disable Trigger
Note
titleNote

For the Suspend Agent and Resume Agent operations, the user must have the following Agent permissions:

For the Suspend Agent Cluster, Resume Agent Cluster, Suspend Agent Cluster Membership, and Resume Agent Cluster Membership operations, the user must have the following Agent Cluster permissions:


Anchor
System Notification
System Notification
System Notification

Status of the specified system operation (see above) that will trigger a system notification.
 
Options:

  • None
  • Operation Failure (default)
  • Operation Success/Failure
  • Operation Success
Note
titleNote

The Controller must be configured for system notifications in order for system notifications to be triggered.


Anchor
Agent
Agent
Agent

If 63565460 System Operation is Suspend Agent, Resume Agent, Suspend Cluster Membership, Resume Cluster Membership, or Set Agent Task Execution Limit; Agent for which the system operation is to be performed.

Anchor
Agent Variable
Agent Variable
Agent Variable

If 63565460 System Operation is Suspend Agent, Resume Agent, Suspend Cluster Membership, Resume Cluster Membership, or Set Agent Task Execution Limit:
 
If enabled, the 63565460 Agent field converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format: ${variable name}. The variable must be a supported type as described in Variables and Functions.

Anchor
Agent Cluster
Agent Cluster
Agent Cluster

If 63565460 System Operation is Suspend Agent Cluster, Resume Agent Cluster, Suspend Cluster Membership, Resume Cluster Membership, or Set Cluster Task Execution Limit; Agent Cluster for which the system operation is to be performed.

Anchor
Agent Cluster Variable
Agent Cluster Variable
Agent Cluster Variable

If 63565460 System Operation is Suspend Agent Cluster, Resume Agent Cluster, Suspend Cluster Membership, Resume Cluster Membership, or Set Cluster Task Execution Limit;
 
If enabled, the 63565460 Agent Cluster field converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format:

${variable name}

The variable must be a supported type as described in Variables and Functions.

Anchor
Task Execution Limit
Task Execution Limit
Task Execution Limit

If 63565460 System Operation is Set Agent Task Execution Limit or Set Cluster Task Execution Limit; Specification for whether a Limited or Unlimited number of task instances can be run concurrently on the specified Agent / Agent Cluster. (Default is Unlimited.)

Anchor
Virtual Resource
Virtual Resource
Virtual Resource

If 63565460 System Operation is Set Virtual Resource Limit; Virtual resource for which a virtual resource limit is to be set.
 

Note
titleNote

If the Strict Business Service Membership Read Constraints Universal Controller system property is true, the drop-down list displays only Virtual Resources for which the user has explicit Read permission.


Anchor
Virtual Resource Variable
Virtual Resource Variable
Virtual Resource Variable

If 63565460 System Operation is Set Virtual Resource Limit; the 63565460 Virtual Resource field (if enabled) converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format:

${variable name}

The variable must be a supported type as described in Variables and Functions.

Anchor
Limit
Limit
Limit

If 63565460 System Operation is Set Agent Task Execution Limit or Set Cluster Task Execution Limit, and Task Execution Limit is Limited; Number of tasks that can be run concurrently by the specified Agent / Agent Cluster.
 
If 63565460 System Operation is Set Virtual Resource Limit; Virtual resource limit to be set for the specified virtual resource.

Anchor
Command
Command
Command

If 63565460 System Operation is Run Task Instance Command; Type of task instance command to run.
 
Options:

  • Cancel
  • Force Finish
  • Force Finish (Halt)
  • Force Finish/Cancel
  • Force Finish/Cancel (Halt)
  • Skip
  • Skip Path
  • Unskip
  • Hold
  • Release
  • Release Recursive
  • Clear All Dependencies
  • Clear Exclusive
  • Clear Predecessors
  • Clear Resources
  • Clear Timewait
  • Re-run
     

    Warning
    titleCaution

    If you choose to re-run a task instance, care must be taken to not create unintended loop situations. For example, if a task contains a System Operation that specifies the re-run of that same task if the task instance ends in the Failed status, this will cause an endless loop of re-runs. If the task also contains a System Notification / Email Notification that sends an email if the task instance ends in Failed status, the emails could flood the recipient's mail server.


Anchor
Workflow Instance Name Condition
Workflow Instance Name Condition
Workflow Instance Name Condition

If 63565460 System Operation is Run Task Instance Command; Optional. Type of condition for the name of the parent workflow task instance that contains the task on which to perform the specified action.
 
The action will be performed only on a task instance in a parent workflow task instance meeting the specified condition value.
 
Options:

  • Equals
  • Starts With
  • Contains
  • Ends With

For the selected condition (the default is Equals), a corresponding field displays (see below) that allows you to enter a value for that condition.

Anchor
Workflow Instance Name Equals
Workflow Instance Name Equals
Workflow Instance Name Equals

If 63565460 Workflow Instance Name Condition = Equals; Exact name of a parent workflow task instance containing the task. Variables are supported.

Anchor
Workflow Instance Name Starts With
Workflow Instance Name Starts With
Workflow Instance Name Starts With

If 63565460 Workflow Instance Name Condition = Starts With; Character string at the start of the name of a parent workflow task instance containing the task. Variables are supported.

Anchor
Workflow Instance Name Contains
Workflow Instance Name Contains
Workflow Instance Name Contains

If 63565460 Workflow Instance Name Condition = Contains; Character string in the name of a parent workflow task instance containing the task. Variables are supported.

Anchor
Workflow Instance Name Ends With
Workflow Instance Name Ends With
Workflow Instance Name Ends With

If 63565460 Workflow Instance Name Condition = Ends With; Character string at the end of the name of a parent workflow task instance containing the task. Variables are supported.

Anchor
Instance Lookup Option
Instance Lookup Option
Instance Lookup Option

If 63565460 System Operation is Run Task Instance Command; Specification for how to search for the task instance to run a command against.
 
Options:

  • Instance Name
  • Instance Name/Task
  • Instance Id
  • Task

Anchor
Instance Name
Instance Name
Instance Name

If 63565460 Instance Lookup Option is Instance Name or Instance Name/Task; Required. Name of the task instance to run the command against. Variables supported.

Anchor
Instance Criteria
Instance Criteria
Instance Criteria

If 63565460 Instance Lookup Option is Instance Name, Instance Name/Task, or Task; Additional criteria for selecting a specific task instance if multiple task instances have matching names.

  • Oldest Active Instance (default)
  • Newest Active Instance
  • Newest Instance (Re-run and Unskip commands only)
  • Oldest Instance (Re-run and Unskip commands only)

(An Active task instance is an instance that is not in any of these statuses: Skipped, Finished, Success.)

Anchor
Task Reference
Task Reference
Task Reference

Anchor
Task Reference Variable
Task Reference Variable
Task Reference Variable

If 63565460 Instance Lookup Option is Instance Name/Task or Task, or if 63565460 System Operation is Launch Task; the Task field (above) converts from a reference field (where you browse and select a record) into a text field that allows you to enter a variable. Use the format: ${variable name}. The variable must be a supported type as described in Variables and Functions.

Anchor
Instance Id
Instance Id
Instance Id

If 63565460 Instance Lookup Option is Instance Id; ID of task instance to run the command against. The instance Id (sysid) is a 32-character universally unique identifier. You can use the ${ops_task_id} variable or ${_siblingid('mytask')} function to get the instance Id.

Anchor
Trigger
Trigger
Trigger Reference

If 63565460 System Operation is Trigger Now, Enable Trigger, or Disable Trigger; Name of the trigger.

Trigger Reference Variable

If 63565460 System Operation is Trigger Now, Enable Trigger, or Disable Trigger; Indication of whether the Trigger Reference field is a reference field for selecting a specific Trigger (unchecked) or is a text field for specifying the trigger as a variable (checked). For a variable, use the format: ${variable name}. The variable must be a supported type as described in Variables and Functions.

Override Variables

If 63565460 System Operation is Launch Task or Trigger Now; Variables to override.

Override Variables Resolution Disabled

If 63565460 System Operation is Launch Task or Trigger Now; Indication of whether or not Override Variables resolution should be disabled to allow for passing unresolved variable values.

  • If enabled (checked), Override Variables will be left unresolved. Any unresolved variables will be resolved in the context of the launched or triggered task instance.
  • If disabled (unchecked), Override Variables will be resolved prior to the execution of the Launch Task or Trigger Now System Operation.

Anchor
Override Trigger Date Time
Override Trigger Date Time
Override Trigger Date/Time

If 63565460 System Operation is Trigger Now, Indication of whether or not to override the date/time of the trigger.
Override Date OffsetIf 63565460 Override Trigger Date Time is selected; Override date offset.
Override TimeIf 63565460 Override Trigger Date Time is selected; Override time.

Buttons

This section identifies the buttons displayed above and below the Action Details that let you perform various actions.

Save

Saves a new Action record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new record.

Update

Include Page
IL:Update button
IL:Update button

Delete

Include Page
IL:Delete button
IL:Delete button

Refresh

Refreshes any dynamic data displayed in the Details.

Close

Closes the Details pop-up of this action.

...