Versions Compared

Key

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

...

<ul> <li>
  • As
  • String
  • =
  • NONE,
  • As
  • Value
  • =
  • 1
<li>
  • As
  • String
  • =
  • STDOUT,
  • As
  • Value
  • =
  • 2
<li>
  • As
  • String
  • =
  • STDERR,
  • As
  • Value
  • =
  • 3
<li>
  • As
  • String
  • =
  • FILE,
  • As
  • Value
  • =
  • 4
<li>
  • As
  • String
  • =
  • OUTERR,
  • As
  • Value
  • =
  • 6
</ul>

Default is OUTERR (6).
 


Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Anchor
broker - UC
broker - UC
broker

UCMD Agent

If brokerChoice is Agent Hostname or Agent Variable; Either:

  • Variable that will be resolved when the task is launched.
  • Host name of a machine where the UCMD Agent is running.

 


N

 


Anchor
brokerChoice - UC
brokerChoice - UC
brokerChoice

UCMD Agent Option

Specification for how the name of the UCMD Agent is being specified in broker or brokerRef.

Valid values:html-bobswift<ul> <li>

  • As
  • String
  • =
  • Agent,
  • As
  • Value
  • =
  • 1
<li>
  • As
  • String
  • =
  • Agent
  • Variable,
  • As
  • Value
  • =
  • 2
<li>
  • As
  • String
  • =
  • Agent
  • Hostname,
  • As
  • Value
  • =
  • 3
</ul>

Default is Agent (1).

N 


Anchor
brokerCred - UC
brokerCred - UC
brokerCred

UCMD Credentials

Login credentials that Controller will use to access the remote machine where the UCMD Agent is running. 


N

brokerCredVar

Anchor
brokerCredVar - UC
brokerCredVar - UC
brokerCredVar

UCMD Credentials Variable

Name of a variable that will be resolved at run time to the name of the UCMD Credentials to use.

 


N

brokerCred

Anchor
brokerRef - UC
brokerRef - UC
brokerRef

UCMD Agent

If brokerChoice is Agent; UCMD Agent record selected from the UCMD Agent table. 


N

 


Anchor
command - UC
command - UC
command

Command

If commandOrScript is Command; Command being executed on the remote machine.

Variables are supported.

Y 


Anchor
commandOptions - UC
commandOptions - UC
commandOptions

UCMD Options

Any UCMD options needed by the program to execute properly.

Variables are supported.

N 


Anchor
commandOrScript - UC
commandOrScript - UC
commandOrScript

Command or Script

Specification for whether a single command or a script is being executed.

Valid values:html-bobswift<ul> <li>

  • As
  • String
  • =
  • Command,
  • As
  • Value
  • =
  • 1
<li>
  • As
  • String
  • =
  • Script,
  • As
  • Value
  • =
  • 2
</ul>

Default is Command (1).

N 


Anchor
exitCodeOutput - UC
exitCodeOutput - UC
exitCodeOutput

Output File

Path and file name of the output file that should be scanned for the text in exitCodeText. 


N

 


Anchor
exitCodeProcessing - UC
exitCodeProcessing - UC
exitCodeProcessing

Exit Code Processing

Specification for how the Controller should determine whether the executed command failed or completed successfully.

Valid values:html-bobswift<ul> <li>

  • As
  • String
  • =
  • Success
  • Exitcode
  • Range,
  • As
  • Value
  • =
  • 1
<li>
  • As
  • String
  • =
  • Failure
  • Exitcode
  • Range,
  • As
  • Value
  • =
  • 2
<li>
  • As
  • String
  • =
  • Success
  • Output
  • Contains,
  • As
  • Value
  • =
  • 3
<li>
  • As
  • String
  • =
  • Failure
  • Output
  • Contains,
  • As
  • Value
  • =
  • 4
<li>
  • As
  • String
  • =
  • Step
  • Conditions,
  • As
  • Value
  • =
  • 5
</ul>

Default is Success Exitcode (1).

N 


Anchor
exitCodes - UC
exitCodes - UC
exitCodes

Exit Codes

If exitCodeProcessing is Success Exitcode Range or Failure Exitcode Range; 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

 


Anchor
exitCodeText - UC
exitCodeText - UC
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 


Anchor
outputFailureOnly - UC
outputFailureOnly - UC
outputFailureOnly

Failure Only

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR, and waitForOutput is false; Indication for whether output should be retrieved on task failure only.

Boolean; Valid values: true/false. Default is false.

N

Anchor
outputReturnFile - UC
outputReturnFile - UC
outputReturnFile

Output File

If outputReturnType is FILE; Path and file name containing the output that you want automatically retrieved and attached to the task instance. 


N

 


Anchor
outputReturnNline - UC
outputReturnNline - UC
outputReturnNline

Number of Lines

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; Limit the retrieved data to this number of lines.

Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property.

N 


Anchor
outputReturnSline - UC
outputReturnSline - UC
outputReturnSline

Start Line

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; Instructs the Controller to retrieve data beginning at the line indicated.

Default is 1.

N

 


Anchor
outputReturnText - UC
outputReturnText - UC
outputReturnText

Scan Text

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; 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 


Anchor
outputReturnType - UC
outputReturnType - UC
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:

Html bobswift
Note
titleNote

If outputReturnType is not NONE (1), the web service will fail with Start Failure if outputProhibited is true for the specified agent.


N 


Anchor
outputType - UC
outputType - UC
outputType

Output Type

If exitCodeProcessing is Success Output or Failure Output; Type of output.

Valid values:html-bobswift<ul> <li>

  • As
  • String
  • =
  • STDOUT,
  • As
  • Value
  • =
  • 1
<li>
  • As
  • String
  • =
  • STDERR,
  • As
  • Value
  • =
  • 2
<li>
  • As
  • String
  • =
  • FILE,
  • As
  • Value
  • =
  • 3
</ul>

Default is STDOUT (1).

N

 


Anchor
retryExitCodes - UC
retryExitCodes - UC
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

 


Anchor
retryInterval - UC
retryInterval - UC
retryInterval

Retry Interval (Seconds)

Number of seconds between each retry.

Integer; Default is 60.

N 


Anchor
retryMaximum - UC
retryMaximum - UC
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 


Anchor
retrySuppressFailure - UC
retrySuppressFailure - UC
retrySuppressFailure

Suppress Intermediate Failures

If the task instance is in the Failed status; Specification for whether or not the following will be suppressed until all scheduled retry attempts (a Maximum Retries value has been entered or Retry Indefinitely has been enabled) 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

 


Anchor
runtimeDir - UC
runtimeDir - UC
runtimeDir

Runtime Directory

Directory from which the application should be executed.

Variables are supported.

N

 


Anchor
script - UC
script - UC
script

Script File

If commandOrScript is Script; Path and filename of a script file that will be executed on the remote machine.

 


Y

 


Anchor
scriptOptions - UC
scriptOptions - UC
scriptOptions

Script Options

If commandOrScript is Script; One or more command line options to pass to the script file.

 


N 


Anchor
waitForOutput - UC
waitForOutput - UC
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

...