Task Properties: Linux/Unix Task

Property	UI Field Name	Description	Specifications	Required
`command`	Command	If `commandOrScript` = Command (1); Command being executed on the remote machine.	Variables supported.	N
`commandOrScript`	Command or Script	Specification for whether a single command or a script is being executed.	Valid values: As String = Command, As Value = 1 As String = Script, As Value = 2 Default is Command (0).	N
`environment`	Environment Variables	Environment variables needed by the program to run.	List of environment variables: <environment> <variable> <name>env1</name> <value>test1</value> </variable> <variable> <name>env2</name> <value>test2</value> </variable> </environment>	N
`exitCodeOutput`	Output File	If `outputType` = FILE (3); Path and file name of the output file that should be scanned for the text in `exitCodeText`.		N
`exitCodeProcessing`	Exit Code Processing	Specification for how the Controller should determine whether the executed command failed or completed successfully.	Valid values: As String = Success Exitcode Range, As Value = 1 As String = Failure Exitcode Range, As Value = 2 As String = Success Output Contains, As Value = 3 As String = Failure Output Contains, As Value = 4 Default is Success Exitcode Range (1).	N
`exitCodes`	Exit Codes	If `exitCodeProcessing` = Success Exitcode Range (1) or Failure Exitcode Range (2); Range of exit codes.	Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30.	Y
`exitCodeText`	Scan Output For	If `exitCodeProcessing` = Success Output Contains (3) or Failure Output Contains (4); text for which the Controller should scan the output file.	The Controller will process this field as a regular expression.	Y
`outputFailureOnly`	Failure Only	If `outputReturnType` = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6), and `waitForOutput` is false; Indication for whether output should be retrieved on task failure only.	Boolean; Valid values: true/false. Default is false.	N
`outputReturnFile`	Output File	If `outputReturnType` = FILE (4); Path and file name containing the output that you want automatically retrieved and attached to the task instance.		Y
`outputReturnNline`	Number of Lines	If `outputReturnType` = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); Allows you to limit the retrieved data to the number of lines specified.	Integer; Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property.	N
`outputReturnSline`	Starting Line	If `outputReturnType` = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); Allows you to instruct the Controller to retrieve data beginning at this line.	Integer; Default is 1.	N
`outputReturnText`	Scan Text	If `outputReturnType` = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); Instructs the Controller to scan the data for the text specified and retrieve only that.	The Controller will process this field as a regular expression.	N
`outputReturnType`	Automatic Output Retrieval	Specification for whether you want the Controller to automatically retrieve any output from the job and attach it to the task instance record.	Valid values: As String = NONE, As Value = 1 As String = STDOUT, As Value = 2 As String = STDERR, As Value = 3 As String = FILE, As Value = 4 As String = OUTERR, As Value = 6 Default is NONE (1). Note If `outputReturnType` is not NONE (1), the web service will fail with Start Failure if `outputProhibited` is true for the specified `agent`.	N
`outputType`	Output Type	If `exitCodeProcessing` = Success Output Contains (3) or Failure Output Contains (4); Type of output.	Valid values: As String = STDOUT, As Value = 1 As String = STDERR, As Value = 2 As String = FILE, As Value = 3 Default is STDOUT (1).	Y
`parameters`	Parameters	Any arguments needed by the program to execute properly.	Variables are supported.	N
`retryExitCodes`	Retry Exit Codes	Exit code range for which an auto-retry of the task in FAILED status will occur. Exit code ranges must be in the same format as ranges specified in `exitCodes`. Maximum Retries must be greater than 0. If an exit code range is not specified, any exit code potentially will cause a retry.	Format = 1,5,22-30	N
`retryIndefinitely`	Retry Indefinitely	Specification for whether or not the Controller should continue trying indefinitely to run this task. If `retryIndefinitely` = yes, it overrides any value placed in `retryMaximum`.	Boolean; Valid values: true/false. Default is false.	N
`retryInterval`	Retry Interval	Number of seconds between each retry.	Integer; Default is 60.	N
`retryMaximum`	Maximum Retries	Maximum number of times that the Controller should retry this task after it has started and gone to a failed state.	Integer; Default is 0.	N
`retrySuppressFailure`	Suppress Intermediate Failures	Specification for whether or not the following will be suppressed until all scheduled retry attempts have been made: All Actions (Abort, Email Notification, Set Variable, SNMP Notification, and System Operation) to be made against the task instance. Workflow conditional path processing; any Successors waiting on a failure path will not be released. Task Monitors will not be notified of the Failed status. Also, any Task Monitor task that has a Time Scope in the past will disqualify any matching task instance in the past with a Failed status if the task instance is scheduled for automatic retry and for which Suppress Intermediate Failures has been enabled. Any Workflow containing the Failed task instance will not transition to the Running/Problems status.	Boolean; Valid values: true/false. Default is false.	N
`runAsSudo`	Run as sudo	Specification for whether or not to run the command as Sudo (superuser do). runAsSudo prefixes the command with either: sudo (if a credential is not specified; that is, the command is run as root) sudo -u userid (if a credential is specified, where userid = the Runtime User from the supplied credential) When using runAsSudo, you must grant Universal Broker userid authority to sudo to the requested userid without specifying its password; you can do this via the `sudoers` file. Please refer to your local security policy and documentation for updating the `sudoers` file.	Boolean; Valid values: true/false. Default is false.	N
`runtimeDir`	Runtime Directory	Directory from which the application should be executed. Variables are supported.		N
`script`	Script	If `commandOrScript` is Script (2); Name of a script in the Controller database that will be executed by this task.		Y
`waitForOutput`	Wait For Output	If `outputReturnType` = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6), and `outputFailureOnly` is false; Specification for whether or not the task should wait for the requested output before completing.	Boolean; Valid values: true/false. Default is false.	N

Browser not supported