Application Control Tasks
Overview
Application Control tasks allow you to execute a Start, Stop, or Query command against an application in the Universal Controller network.
Three Application Control tasks are created automatically when you create an Application record – one each for starting, stopping, and querying the application. (The Application Control tasks list below shows automatically created tasks for five different Application records.)
Each of these automatically created tasks is stored as a separate record in the Controller database and can be executed independently or added to a workflow, as with any other task. These tasks cannot be deleted.
Built-In Variables
The following built-in variables can be used in an Application Control task to pass data where appropriate. However, variable resolution does not extend to the Application record itself; therefore, built-in variables cannot be used within the Application record Start Command, Stop Command, or Query Command, for example.
Creating an Application Control Task
Step 1 | From the Automation Center navigation pane, select Tasks > Application Control Tasks. The Application Control Tasks list displays a list of all currently defined Application Control tasks. |
|---|---|
Step 2 | Enter/select Details for a new Application Control task, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a button. The task is added to the database, and all buttons and tabs in the Task Details are enabled. |
Note
To open an existing record on the list, either:
Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).
Application Control Task Details
The following Application Control Task Details is for an automatically generated Application Control task.
Some of the fields are protected and the Generated field is pre-selected, indicating that this task was generated automatically.
Depending on the values that you enter / select for these fields, and whether or not the Application Control task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the Application Control Task Details.
For information on how to access additional details - such as Metadata and complete database Details - for Application Control Tasks (or any type of record), see Records.
Application Control Task Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the Application Control Task Details.
Field Name | Description |
|---|---|
General | This section contains general information about the task. |
Name | |
Version | |
Description | |
Member of Business Services | |
Resolve Name Immediately | |
Time Zone Preference | |
Hold on Start | |
Hold Reason | |
Virtual Resource Priority | |
Hold Resources on Failure | |
Mutually Exclusive With Self | |
Simulate | |
Override Previous Instance Wait | |
Application Control Details | This section contains assorted detailed information about the task. |
Application | |
Command | |
Generated | |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
Wait To Start | |
Wait Time | |
Wait Day Constraint | |
Wait Duration | |
Wait Duration In Seconds | |
Delay On Start | |
Delay Duration | |
Delay Duration In Seconds | |
Workflow Only | |
Time Options | This section contains time-related specifications for the task. |
Late Start | |
Late Start Type | |
Late Start Time | |
Late Start Day Constraint | |
Late Start Nth Amount | |
Late Start Duration | |
Late Finish | |
Late Finish Type | |
Late Finish Offset Type | |
Late Finish Percentage Offset ( + ) | |
Late Finish Duration Offset ( + ) | |
Late Finish Duration Offset Unit | |
Late Finish Time | |
Late Finish Day Constraint | |
Late Finish Nth Amount | |
Late Finish Duration | |
Early Finish | |
Early Finish Type | |
Early Finish Offset Type | |
Early Finish Percentage Offset ( - ) | |
Early Finish Duration Offset ( - ) | |
Early Finish Duration Offset Unit | |
Early Finish Time | |
Early Finish Day Constraint | |
Early Finish Nth Amount | |
Early Finish Duration | |
User Estimated Duration | |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
CP Duration | |
CP Duration (Resolved) | |
CP Duration Unit | |
Workflow Execution Options | This section contains Critical Path-related specifications for the task. |
Execution Restriction | |
Restriction Period | |
Before Date | |
Before Time | |
After Date | |
After Time | |
Date List | |
Self-Service Options | This section contains Self-Service specifications for the task. |
Enforce Variables | |
Lock Variables | |
Statistics | This section contains time-related statistics for task instances of the task. |
First Execution | |
Last Execution | |
Last Instance Duration | |
Lowest Instance Time | |
Average Instance Time | |
Highest Instance Time | |
Number of Instances | |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Buttons | This section identifies the buttons displayed above and below the Task Details that let you perform various actions. |
Save | Saves a new task 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 task. |
Update | |
Launch | |
View Parents | |
Copy | Creates a copy of this task, which you are prompted to rename. |
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task. |
Tabs | This section identifies the tabs across the top of the Task Details that provide access to additional information about the task. |
Variables | |
Actions | |
Virtual Resources | |
Mutually Exclusive | |
Instances | Lists all instances of the task. |
Triggers | |
Notes | |
Versions |
Viewing an Application Control Task Instance
When an Application Control task is launched, the Controller creates a task instance record of that task.
A task instance contains detailed information about a single execution of that task.
You can access a task instance from:
Instances tab on the Application Control Task Details for that task
Application Control Task Instance Details
The following Application Control Task Instance Details contains information on the execution of the task shown in the Application Control Task Details.
Application Control Task Instance Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in Application Control Task Instance Details.
Field Name | Description |
|---|---|
General | This section contains general information about the task instance. |
Instance Name | Name of this task instance. |
Instance Number | |
Description | |
Member of Business Services | |
Task | |
Source Version | |
Launch Source | |
Source Instance | |
Invoked by | |
Execution User | |
Calendar | |
Time Zone Preference | |
Virtual Resource Priority |