The Linux/Unix task allows you to run a platform-specific application on a Linux/Unix machine. To run a Linux/Unix task, you must first complete the following tasks:
The following built-in variables can be used in a Linux/Unix task to pass data where appropriate:
Step 1 | From the Automation Center navigation pane, select Tasks > Linux/Unix Tasks. The Linux/Unix Tasks list displays a list of all currently defined Linux/Unix tasks. |
|---|---|
Step 2 | Enter / select Details for a new Linux/Unix 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 the |
To open an existing record on the list, either:
|
The following Linux/Unix Task Details is for an existing Linux/Unix task.
Depending on the values that you enter / select for these fields, and whether or not the Linux/Unix 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 Linux/Unix Task Details.
The following table describes the fields, buttons, and tabs that display in the Linux/Unix 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 | ||
| ||
| Mutually Exclusive With Self | ||
Agent Details | This section contains assorted detailed information about the Agent / Agent Cluster selected for this task. | |
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Linux/Unix Details | This section contains assorted detailed information about the task. | |
| If the Windows/Linux Scripts Permitted Universal Controller system property is set to false:
| |
| ||
| ||
Parameters | ||
| ||
Environment Variables | ||
| Result Processing Details | This section contains assorted detailed information about result processing for this task. | |
| ||
| ||
| ||
Output File (for Exit Code Processing) | ||
| ||
| ||
| ||
| ||
Start Line | ||
Number of Lines | ||
Scan Text | ||
| ||
Retry Options | This section contains specifications for retrying the task. | |
| ||
| ||
Retry Indefinitely | ||
Retry Interval (Seconds) | ||
Suppress Intermediate Failures | ||
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. | |
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Time Options | This section contains time-related specifications for the task. | |
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Critical Path Options | This section contains Critical Path-related specifications for the task. | |
| ||
| ||
| ||
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. | |
| ||
| ||
| ||
| ||
| ||
| ||
| ||
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 Task | ||
View Parents | ||
Copy | Creates a copy of this task, which you are prompted to rename. | |
Delete |
| |
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 | ||
| Lists all instances of the task. | |
Triggers | ||
Notes | ||
|
When a Linux/Unix 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:
The following Linux/Unix Task Instance Details contains information on the execution of the task shown in the Linux/Unix Task Details.
The following table describes the fields, buttons, and tabs that display in Linux/Unix Task Instance Details.
Field Name | Description |
|---|---|
General | This section contains general information about the task instance. |
| Name of this task instance. |
Instance Number | |
Description | |
Member of Business Services | |
Task | |
| Source Version | |
Launch Source | |
Source Instance | |
Invoked by | |
| |
Calendar | |
Time Zone Preference | |
Virtual Resource Priority | |
| |
| Mutually Exclusive With Self | |
Status | This section contains information about the current status of the task instance. |
Status | |
Exit Code | |
Status Description | |
Operational Memo | |
Evaluation Time | |
Critical | |
| Critical Endpoint | |
Wait Until Time | |
Queued Time | |
| |
| |
| |
End Time | |
Duration | |
CPU Time | |
Process ID | |
Agent Details | This section contains assorted detailed information about the Agent / Agent Cluster selected for this task. |
| |
| |
| |
| |
| |
| |
| |
| |
Linux/Unix Details | This section contains assorted detailed information about the task instance. |
| If the Windows/Linux Scripts Permitted Universal Controller system property is set to false:
|
| |
| |
Parameters | |
| |
Environment Variables | |
| Result Processing Details | This section contains assorted detailed information about result processing for this task. |
| |
Output Type | |
| |
| |
Output File (for Exit Code Processing) | |
| |
| |
| |
Start Line | |
Number of Lines | |
Scan Text | |
| |
Retry Options | This section contains specifications for retrying the task. |
|
|
| |
Retry Indefinitely | |
Retry Interval (Seconds) | |
Current Retry Count | |
Suppress Intermediate Failures | |
Next Retry Time | |
Wait / Delay Options | This section contains specifications for waiting to start and/or delaying on start the task. |
| |
| |
| |
| |
| |
| |
| |
| |
Time Options | This section contains time-related specifications for the task instance. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
Critical Path Options | This section contains Critical Path-related specifications for the task. |
| |
| |
| |
Workflow Execution Options | This section contains Execution Restriction specifications for the task if it is within a Workflow. |
| |
| |
| |
| |
| |
| |
| |
Statistics | This section contains time-related statistics for the the task instance. |
| |
Lowest Estimated End Time | |
Average Estimated End Time | |
Highest Estimated End Time | |
| Projected Start Time | |
Projected End Time | System-supplied; projected end time of the task instance, calculated by the Controller based on the projected end time of its predecessor (or the maximum projected end time of all its predecessors, if more than one path exists to that task instance) plus its estimated critical path duration. |
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. |
Status History | History of all statuses that the task instance has gone through. |
Buttons | This section identifies the buttons displayed above and below the Task Instance Details that let you perform various actions. |
Update | |
Force Finish | |
Hold | |
Skip | |
Re-run | |
View Parent | |
| |
Delete | |
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this task instance. |
Tabs | This section identifies the tabs across the top of the Task Instance Details that provide access to additional information about the task instance. |
Virtual Resources | |
Exclusive Requests | |
Output | |
Notes |
You can run a Linux/Unix task:
You can monitor all system activity from the Activity Monitor and can view activity history from the History list.
button above the list to display a pop-up version of the Details.
button. The task is added to the database, and all buttons and tabs in the Task Details are enabled.