Page Comparison

Universal Controller start-up properties are the default properties contained in the uc.properties file when the Controller is installed. These properties are required for Controller start-up and operation.
 
The values for these properties are set during the installation process. Some of the values are based on information that you provide during the installation.
 
You can reset these properties by stopping the Controller, editing uc.properties, and restarting the Controller. The changes will take effect after the restart (see Starting and Stopping Universal Controller).

CLI provides a sample configuration file, cmdtools.props , that you can use to pass CLI Global parameters to a CLI command.

System administrator email address(es) specified as the recipient(s) for System Notifications. Addresses for multiple administrators should be specified in a comma-separated list.

(none)

Specification (true or false) for whether or not to hide the IP address of an Agent from non-Administrator (ops_admin) users.

If the property is set to true and the user is a non-Administrator, the IP Address field of Agents will display ***** instead of the actual value for that user.

Number of days that cache files (stdout, stderr) are retained by the system.

7

Amount of time (in minutes) that a resolved Network Alias will be used before attempting to resolve it again.

30

Amount of time (in minutes) before automatically retrying the Network Alias resolution upon failure.

5

Default port for an Agent Cluster with a Distribution method of Network Alias if no Agent Port is specified.

7887

Specification (true or false) for whether or not Credentials are required for agent-based tasks and Application Resources.

false

Specification (Windows, Linux/Unix, z/OS) for whether the agent has to use the credentials or not.

Grace period in seconds (minimum 30, maximum 600) that the Controller will allow for a delayed heartbeat message.

60

Agent Heartbeat Interval in Seconds
(uc.agent.heartbeat.interval.in.seconds)

Number of seconds between each heartbeat message sent by the agent to the Controller.

120

Agent Notification Disabled If Suspended
(uc.agent.notification.disable_if_suspended)

Specification (true or false) for whether or not Agent notifications will not be processed (true) when a suspended Agent goes active/offline.

Agent Prefix
(uc.agent.prefix)

Prefix appended to the Queue name for newly registered agents. A 4-digit number is appended to this prefix.

AGNT

Specification (true or false) for whether or not the Controller will allow the re-run of a task instance if it is in the In Doubt status.

true

Specification (true or false) for whether or not the Controller will retain copies of previous versions. Affects system behavior when you make updates to records in your Controller database, such as changing a task definition.

true

Automatically Skip Conflicting Multi-Origin Paths
(uc.workflow.skip_conflicting_multi_origin_paths)

Specification (true or false) for whether or not the Controller will automatically skip a task (within a workflow) that is connected to multiple predecessor tasks, where one or more of the predecessor tasks would cause the task to be run and one or more would cause the task to be skipped.

false

Hexadecimal color code for the color of the Universal Controller user interface page banner. Valid values are #[0-9, a-f, A-F] (six characters) or transparent.

transparent
For transparent, color will be based on Theme. 

(none)

URL of a web resource that you want the Banner Logo to link to. The URL must begin with http://, https://, or ftp:// and contain no spaces. (Banner Logo URL is not a valid URL.)

(none)

Broadcast On Hold If Cluster Suspended
(uc.cluster_broadcast.hold_on_suspended)

Specification (true or false) for whether or not cluster broadcast tasks will be run if the agent cluster selected for the broadcast has been suspended.

true

Broadcast On Hold If Cluster Unresolved
(uc.cluster_broadcast.hold_on_unresolved)

Specification (true or false), for a task instance defined within a worfklow, if a broadcast cluster is specified, and Universal Controller is unable to find the broadcast cluster by id, or unable to resolve the broadcast cluster variable, or the Execution User cannot read the cluster due to security constraints, that the task instance should be Held, with an appropriate Hold Reason, rather than the instance becoming Undeliverable only when eligible to run.

true

Specification (true or false) for whether or not to permit the Bulk Export Activity server operation to be run.

false

Default selection for the Exclude on Existence field in both the Bundle Details for a new Bundle and the Promote dialog when promoting one or more individual records, which identifies record types in the promotion payload that will not be updated if they exist on the target server.
 
Use the Shift and/or Ctrl keys to select multiple record types.

(none)

Specifies whether or not a bundleless promotion should be limited to users with the ops_promotion_admin role, or if users with promotion target Execute permission should be permitted to perform a bundleless promotion.

false

false

Number of years (starting from the end of the current year) to show all Custom Days defined for a calendar in a Calendar Preview.

2

Maximum number of records that can be retrieved (or matched) for the following:

• CLI List APIs excluding List Predecessors / Successors of a Task Instance in a Workflow CLI
• CLI APIs for limiting matches:
  • Launch a Task
  • Export Trigger
  • Disable a Trigger
  • Enable a Trigger
  • Launch Trigger Tasks Now
• Web Service List APIs:
  • List Task Instances
  • List Task Instances  - Advanced
  • List Tasks
  • List Tasks - Advanced
  • List Triggers
  • List Triggers - Advanced
  • List Virtual Resources
  • List Virtual Resources - Advanced
  • List Variables
  • List Variables - Advanced

1000

Client Export Fetch Limit
(uc.export.client.fetch_limit)

Number of records to pre-fetch before performing an export to CSV, PDF, XLS (Excel), or XLSX. Before performing an export, the client will attempt to pre-fetch all list grid data. If after the pre-fetch, the list grid does not contain all matching rows, a warning displays, before continuing with the export, indicating that the export doesn't contain everything.

1000

Compress Bundle Promotion Payload
(uc.bundle.payload_compression)

Specification (true or false) for whether or not the Controller will compress record bundles during a promotion.

false

Specification (yes or no) for whether or not a confirmation pop-up displays if a user selects to enable or disable a trigger.

yes

Specification (true or false) for whether or not a confirmation pop-up displays if a user navigates away from the Universal Controller user interface (or closes the browser without logging out).

true

Specification (true or false) for whether or not a user, when updating a task, is prompted with a Confirmation dialog listing all Workflows containing that task, since those Workflows could be impacted by the task update.

false

Continue Monitoring Completed Workflows in Workflow Monitor
(uc.workflow_monitor.monitor_completed)

Specification (true or false) for whether or not the Controller will continue monitoring completed Workflows in the Workflow Monitor.

false

Specification (true or false) for whether or not a record version will be created if the user changes a record associated with the current record. For example, if true, the Controller will create a version of the task when the user changes a task variable.

true

false

Hexadecimal color code for the color of the vertices and edges along the Critical Path displayed within the Workflow Monitor while in Critical Path view. Valid values are #[0-9, a-f, A-F] (six characters).

#FF0000 (red)

When a task instance completes, if the difference between its end time and its projected end time is greater than or equal to the threshold specified in seconds, a critical path recalculation event will be dispatched. Valid values are 0-600.

0

Interval (in seconds) in which that Universal Controller queries for task instances with a status greater than WAITING, and less than SKIPPED, and have elapsed their projected end time. Valid values are 60+.

300

Threshold (in seconds) that Universal Controller uses to determine if a task instance has elapsed its projected end time when polling. Valid values are 60+.

60

Number of times that a task instance can invoke Actions On Projected Late before being muted.

As a task instance Projected End Time changes, the Projected Late flag can be set and cleared multiple times. In such situations, this property limits the number of Actions being performed On Projected Late, such as Email Notifications, for a particular instance.

5

Threshold beyond the Late Start Time, Late Start Duration, or Late Finish Time that the projected time must exceed in order for the task instance to be flagged as Projected Late.

5

true

Specification (true or false) for whether to enable (true) or disable (false) the Local Custom Day indicator ({L}) for Trigger and Composite Trigger components, Task Run Criteria, and Calendar Preview.

true

Specification (true or false) for whether or not a Custom Day referenced in the Complex section of Task Run Criteria for a task in a workflow must belong to the Calendar in use at run time.

false

Export path to use instead of the default export path (uc_backups under the Tomcat directory) for Data Backup/Purge operations.

(none)

Specification (true or false) for whether or not to disable the tab icons that indicate if tabs contain (green icon) or do not contain (gray icon) records.

false

Default Begin Marker for Email Monitor Body Variables field.

- - BEGIN - -

Default End Marker for Email Monitor Body Variables field.

- - END - -

Specification (true or false) for whether or not to enable the use of Email Credentials.

true

Number of seconds between each poll of a Mailbox Folder by an Email Monitor task.

120

Specification (Success/Failed or Failed) for how to identify an Email Notification audit.

(none)

false

Specification (true or false) for whether or not the Controller will export referenced Agents when exporting definition XMLs with the Export References feature.

false

(none)

Expose UDM Script
(uc.infitran.expose_script)

For debugging use only. Specification (true or false) for whether or not the Controller prepares a script when it launches a file transfer on a UDM installation. If troubleshooting is necessary, enabling this property allows you to view the script in the Output tab on the task instance.

false

Expose Resolved Script
(uc.script_library.expose_resolved_script)

Specification (true or false) for whether or not to generate a SCRIPT output type capturing the resolved contents of the Scripts script for each task instance run attempt that utilizes a script from the Scripts. This property only applies to Scripts defined with the Resolve UAC Variables option checked. Any user with the task instance Read permission for a specific task instance will be able to view the SCRIPT output type content for that specific instance.
 
To avoid generating unnecessary output, we recommend enabling this property only for debugging purposes. The unresolved script content can always be viewed from Scripts.

false

Specification (true or false) for whether or not to flatten Business Services in Chart reports when grouping by Member of Business Services.

false

Number of days to be included in a trigger forecast. See Displaying Trigger Forecast Information.

31

Specification (true or false) for whether or not a task inserted into a Workflow, whose initial inserted status will be Defined, will perform inherited Workflow Actions for the Defined status.

false

Specification (true or false) for whether or not LDAP synchronization is enabled. This allows you to retain your LDAP Settings while using or not using LDAP authentication, as desired.

false

License Key
(uc.license)

License key for your installation; provided to you by your Universal Controller representative.

(none)

List Qualifying Times Format
(uc.trigger.date.format.display)

Format that you want the Controller to use when listing qualifying times for Time and Cron Triggers. See List Qualifying Times.

EEEEE, MMMMMMM dd, yyyy HH:mm:ss z Z

Number of days that the Controller retains its log files.

5

Level of logging for the Controller:

• ALL
• TRACE
• DEBUG
• INFO
• WARN
• ERROR

INFO

Allows for the specification of free-form text to be displayed at the bottom of the Universal Automation Center Login page.

(none)

Allows for the addition of a pop-up to be displayed on the Universal Automation Center Login page.

(none)

Maximum number of nested variables allowed.

25

Maximum number of nested variable characters allowed.

250000

Maximum number of processing threads used.

1000

Maximum number of timer threads used.

300

Navigation Auto Collapse
(uc.navigation.auto_collapse.default)

Specification (Yes or No) for whether or not the side Navigation Menu on the Home Dashboard collapses by default. 

Specification (Yes or No) for whether or not the User Task Bar will display the Cluster Node time by default.

Yes

Default color to use for the Cluster Node time field background in the User Task Bar.

White

Default color to use for the Cluster Node time field in the User Task Bar.

Black

Specification for whether to display the time zone of the Server or the User in the Cluster Node time field in the User Task Bar.

Server

INFO

Specification (true or false) for whether or not tasks within a workflow that is being skipped due to trigger-time run criteria should perform Actions on Defined status and evaluate their own run criteria.

false

Specification (true or false) for whether or not to allow a workflow, on Defined status, to process its own Actions prior to processing any Actions for its children task instances on Defined status.
 
This might be leveraged if, on Defined status, a workflow initializes a variable using the Set Variable Action, and a child task instance, also on Defined status, leverages that same variable in its own Set Variable Action.

false

Specification (true or false) for whether or not to allow the triggering of notifications for a task instance status change to Finished when issuing a Force Finish (Halt) or Force Finish/Cancel (Halt) command.

true

Level of logging for the user interface framework:

• ALL
• TRACE
• DEBUG
• INFO
• WARN
• ERROR
• OFF

WARN

Promotion Follow References Permitted 
(uc.promotion.follow_references.permitted)

Specification (true or false) for whether or not to permit utilizing follow reference option for Promotion.

Number of days that the Controller retains Promotion History.

60

Number of days that a Promotion Schedule will remain available after the promotion has completed successfully.

7

true

Number of task instances to purge per transaction while performing the Activity purge (by primary key).

500

Specification (true or false) for whether or not to allow the Purge All Non-Default Users And Groups Server Operation to be run.

false

Number of days old (1-999) that a date in a Custom Day List of Dates will cause it to be purged automatically.

(none)

Specification (true or false) for whether or not you can manually Re-run a task instance specifying that intermediate failures be suppressed.

true

Default value of the Task Launch Skip Condition field for a Recurring Task:

• None
• Active
• Active By Recurring Task Instance

Minimum duration, in seconds, that a Recurring Task can have for a Recurrence Interval.

The minimum value is 0.

10

Specification (true or false) for whether or not the use of Resolvable Credentials is enabled.

false

Specification (true or false) for whether or not a changed return code of a previously executed step in a z/OS task is retained when the task is re-run.

false

Specifies the default value for the Number of Lines field on the Retrieve Output dialog. Additionally, if the Number of Lines field is blank, it specifies the limit for the number of lines retrieved when Automatic Output Retrieval is enabled on a task.

100

Specifies the maximum number of lines that can be requested when retrieving output.

(none)

Specification (Yes or No) for whether Pie Chart reports are rendered in 2D (No) or 3D (Yes).

No

Maximum number of records to fetch for inclusion in a List report (minimum is 1; no maximum). The report will indicate if the specified maximum has been reached.

1,000

Specification for the height (in pixels) of PNG chart report images.

500

Specification for the height (in pixels) of PNG chart report images.

750

Specification (Yes or No) for whether to inline chart report images within the email (Yes) or include them as attachments (No). If any other attachments, such as standard error and standard output, are included, this property does not apply; the chart report image will be delivered as an attachment.

Yes

Specification (Landscape or Portrait) for the page layout of the PDF.

Landscape

Specification (Letter, Legal, or A4) for the page size of the PDF.

Letter

Specification for whether to obtain the time zone from the Server (Server) or from the User record of the Execution User (User).
 
This property applies to all report types (List, Bar Chart/Horizontal, Bar Chart/Vertical, and Pie Chart).

Server

Script Resolve Variables Default
(uc.script.variables.resolve.default)

Specification (true or false) for whether or not the last login time is shown in the console when logging into the user interface.

For more information and examples, see Show Last Login.

Specification (Yes or No) for whether or not the Metadata section displays automatically in the the Details of all Controller records.
 
You can override this system default configuration by customizing the Show Metadata user preference.

No

Specification (Yes or No) for whether or not to fetch and display Global Variables automatically for the Show Variables action.
 
If No, the visibility of Global Variables in Show Variables can still be toggled, on demand, by the Show Global and Hide Global buttons.
 
You can override this system default configuration by customizing the Show Variables Fetch Global Automatically user preference.

No

Specification (true or false) for whether or not additional debug information about any Email Connection issues (for example, Email Connection Test fails or errors while sending emails) will be included in the log.

false

true

Specification (true or false) for whether or not to create a SQL Results record for rows affected when no results (result sets or update counts) are returned by SQL or Stored Procedure tasks.

false

Specifies the maximum number of rows that can be returned from an SQL task or Stored Procedure task.

(none)

false

Specification (true or false) for whether or not to stop any application monitors currently running on an Agent if the Controller is no longer managing those monitors (Windows and Linux/Unix only).

false

Specification (true or false) for whether or not to restrict dashboard creation only to users with the ops_admin, ops_report_admin, ops_dashboard_group, or ops_dashboard_global role.

false

Specification (true or false) for whether or not to restrict report creation only to users with the ops_admin, ops_report_admin, ops_report_group, or ops_report_global role.

false

Task instance status types to include in the Active, Blocked, Completed, and Problem Quick Filters. You can add statuses to or delete statuses from any of these Quick Filter. You also can delete any of these Quick Filters and create you own Quick Filters.

Active=!180,!190,!200;
Blocked=10,20,23,30,33,60;
Completed=180,190,200;
Problem=35,81,99,110,120,125,130,140

Pathname from where imported XML files are written.

<tomcat-home>/uc_import
or
<tomcat-home>\uc_import
 
(<tomcat-home> is the base tomcat installation directory.)

Specification (Yes or No) for all users whose Command Line access field in their User Details is set to -- System Default --, for whether or not to control a user's ability to access the Controller through the Command Line Interface (CLI).

Yes

Yes

Specification (Yes or No) for whether or not to enable command confirmations when issuing commands against task instances.

No

Maximum number of version records (1 to 255) to maintain per definition.

100

Specification (true or false) for whether or not to simulate the launching of tasks when triggers are eligible to fire. If simulation is enabled, only the scheduled launch of the task by the trigger is inhibited. All other aspects of the trigger execution, including generation of forecast data, are enabled.
 
You can still force a trigger by using the Trigger Now command or launch a task by using the Launch command.

false

Specification (Yes or No) for whether or not virtual resource limits are updated as part of a promotion.

Yes

Specification (Yes or No) for whether or not to apply Wait/Delay Options to a task only if it runs within a workflow.

Yes

Specification (Yes or No), for all users whose Web Browser access field in their User Details is set to -- System Default --, for whether or not to control a user's ability to access the Controller through the user interface.

Yes

Specification (Yes or No), for all users whose Web Service access field in their User Details is set to -- System Default --, for whether or not to control a user's ability to access the Controller through the RESTful Web Services API.

Yes

Specification for which System Details widget categories to expand by default:

• Cluster Node
• Release
• Memory
• License
• Database

User-selected name displayed in the System Identifier field on the User Task Bar.

(none)

Background color for the System Identifier field on the User Task Bar.

black

Text color for the System Identifier field on the User Task Bar.

white

blank

Task Simulation Permitted
(uc.task.simulation.permitted)

Specification (true or false) for whether or not the simulation feature is enabled. When disabled:

• Simulation service no longer available from Services menu.

• Auto open for Simulation tab ignored.

• Simulate option no longer available from Task and Task Instance forms.

• Simulate option no longer available from Launch with Variables… and Trigger Now… commands.

Specification (Server or Inherited) for whether the time zone for a task is evaluated on the time zone of the server or the time zone of the Parent Workflow or Trigger / Launch specification.

Server

Task Variable Path Function Permitted 
(uc.task.variable_path.function.permitted)

If Wait For Output is enabled for a task where automatic output retrieval is selected (potentially, to be used by a successor task); Length of time (in seconds) that the task will wait (that is, remain Running) until the output is returned by the Agent so that the successor task does not run before the output is available.

60

Minimum frequency - in seconds - of the Time Interval for a Time Trigger.

5

false

Default value of the Task Launch Skip Condition field for all trigger types:

• None
• Active
• Active By Trigger

Specification (true or false) for whether or not to permit utilizing Interact with Desktop option for Universal Task.

Maximum number of bytes (6000000 -  1000000000) for a Universal Template Extension Archive.

6000000

Specification (true or false) for whether or not to enable the URL Action parameter, which lets you automatically perform an action in the user interface.

true

Specification (true or false) for whether or not to implement checksum validation in order to prevent tampering of Controller data outside of the Controller system.

false

Specification (Yes or No) of the system default for the Use Dashboard Visibility Icons user preference.

Yes

Label for this user-defined field that will display in the General Information section of the Details for all existing and new tasks and task instances.

(none)

Specification (true or false) for whether or not User Defined Task Field 1 is required.

false

Label for this user-defined field that will display in the General Information section of the Details for all existing and new tasks and task instances.

(none)

Specification (true or false) for whether or not User Defined Task Field 2 is required.

false

Label for this user-defined field that will display in the General Information section of the Details for all existing and new triggers.

(none)

Specification (true or false) for whether or not User Defined Trigger Field 1 is required.

false

Label for this user-defined field that will display in the General Information section of the Details for all existing and new triggers.

(none)

Specification (true or false) for whether or not User Defined Trigger Field 2 is required.

false

Default density setting (font and control size offset) for the user interface:

• Dense (-2)

• Compact (-1)

• Standard ( 0)

• Expanded (+1)

• Spacious (+2)

When the User Interface Density user preference is -- System Default --, this property specifies the density to be used.

Default display theme to use for the user interface:

• Light
• Dark

When the User Interface Theme user preference is -- System Default --, this property specifies the theme to be used.

Virtual page size to be used when scrolling in a list.

100

Virtual page size to be used when scrolling the options in a drop-down list that are bound by another data source (for example, the Task To Monitor drop-down list options in the Task Monitor Task Details).

100

Web Service Basic Auth Permitted
(uc.web_service.basic_auth.permitted)

Allows enabling/disabling the use of Web Service credentials.

• If false:
  • Creation of new Web Service credentials will be prohibited.
  • All Web Service Task Instances using authentication will transition into the Start Failure status.
• If false on a target Controller to which you are promoting, the promotion will fail.

true

Default type of content, XML or JSON, for web service responses.

XML

Percentage of allocated memory in use that defines a threshold for prohibiting access to the RESTful Web Service API.

The threshold must be a whole number (integer) and cannot be less than 1 or more than 99.

Controls the maximum expiration day for a web service personal access token.

If specified, expiration for any newly generated Personal Access Token must be within the maximum.

false

List of content-types, such as binary, that are discarded to avoid being stored as Web Service Task output, which are not supported and can lead to task instance run failure.

image/*,audio/*,video/*,application/pdf

false

Specification (true or false) for whether or not to use the Java proxy system properties for HTTP Web Service tasks.

false

Number of seconds to wait for the request to complete, if a Timeout value is not specified for a Web Service task.

60

Regular Expression that specifies the URLs supported by the Web Service task. (The default value specifies that all URLs are supported.)
 
If you have a specific regex that you want to be case-insensitive, pre-pend the following option to the regex: (?i)"."(?i)

^https?://.+$

true

Specification (true or false) for whether to enable (true) or disable (false) the display of a Task Description field in the Task Instance Details for a task instance in a Workflow Monitor.

Results limit when querying for task records from the Task Find or Open Workflow pop-up.

200

Specification (true or false) for whether or not the ops_promotion_admin role additionally requires Create (or Update) permission, on the target Universal Controller, for any record type being promoted.

Any user without the ops_promotion_admin role always will require Create (or Update) permission, regardless of this property.

true

true

1

7.4.0.0

• Agent
• Agent Cluster
• Calendar
• Credential
• Database Connection
• Email Connection
• Email Template
• OMS Server
• PeopleSoft Connection
• SAP Connection
• SNMP Manager
• Trigger Forecasts
• Virtual Resource

If the property is false, users have implicit Read permission for these record types.

If the property is true, users can view these record types only if they are granted Read permission explicitly via an appropriate role or permission.

true

Specification (true or false) for whether Universal Controller will enforce Execute constraints for connections (Database Connections, Email Connections, SAP Connections, and SNMP Managers) during task instance execution.

If Strict Connection Execute Constraints is false, only Read constraints for connections are enforced based on the configuration of the 63584943 Strict Business Service Membership Read Constraints Universal Controller system property.

If Strict Connection Execute Constraints is true, the Execution User for any task instance executing with a connection must have Execute permission for that connection; otherwise, the task instance will transition into a Start Failure status.

true

Specification (true or false) for enabling enhanced Global Variable security.

true

Specification (true or false) for enabling enhanced Virtual Resource security.

true