IBM i Task Properties

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

Valid values:

• As String = CL, As Value = 1
• As String = REXX, As Value = 2
• As String = PASE, As Value = 3

• As String = SBMJOB, As Value = 4

Default is CL (1).

endSeverity

End Severity

Specifies the message severity level that must be reached in order for the Initiator job to terminate.

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

jobName

Job Name

Specifies the name associated with the job when it is processed by the system.

N

jobDescription

Job Description

Specifies the job description used with the job.

N

jobQueue

Job Queue

Specifies the job queue in which this job is placed.

N

jobPriority

Job Priority(On JOBQ)

Specifies the job queue scheduling priority. The highest priority is 1 and the lowest priority is 9.

Valid Values:

• 1-9

• *JOBQ

N

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.

N

outputQueue

Output Queue

Specifies the qualified name of the output queue used for spooled files that specify OUTQ(*JOB). This parameter applies only to printer files that have *JOB specified on the OUTQ parameter.

N

outputPriority

Output Priority(On OUTQ)

Specifies the output priority for spooled output files produced by this job. The highest priority is 1 and the lowest priority is 9.

Valid Values:

• 1-9

• *JOBQ

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

printDevice

Print Device

Specifies the qualified name of the default printer device for this job. If the printer file being used to create the output specifies to spool the file, the spooled file is placed on the device's output queue, which is named the same as the device.

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

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