Properties

Overview

Universal Controller contains three types of configurable properties:

Universal Controller Start-up Properties (uc.properties)

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).

Universal Controller System Properties

Universal Controller system properties define Controller system information and performance. They have their values set during installation.
 
You can reset these properties at any time, without having to stop the Controller, via the user interface.
 

Note

In a High Availability environment, all Universal Controller cluster nodes share the same database; therefore, updating Universal Controller System Properties for one cluster node applies to all cluster nodes.

Command Line Interface (CLI) Properties

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

Note

Properties for Universal Message Service (OMS) are installed as configuration file options when OMS is installed as a component of Universal Agent. The values for these options are set during the installation. There are several configuration methods available for changing these values.

Universal Controller Start-up Properties (uc.properties)

The uc.properties file is read by the Controller, which is started by Tomcat.

The uc.properties file resides here:

[tomcat directory]\conf

Note

The backslash character in a property value must be escaped as a double backslash.

For example:

example.path=c:\\stonebranch\\uc

Property Name

Description

Default

For MySQL:



uc.db.mysql.character_encoding

Allows the retrieval of output with extended unicode characters. If the property is not set, character encoding will not be used in the JDBC URL.
 
Examples:

uc.db.mysql.character_encoding=US-ASCII
uc.db.mysql.character_encoding=Cp1252
uc.db.mysql.character_encoding=UTF-8


uc.db.rdbms=mysql

Database type. Specify this property if you are using a MySQL database.


uc.db.url=jdbc:mysql://localhost/

JDBC connect URL. Specify this property if you are using a MySQL database.


For SQLServer



uc.db.rdbms=sqlserver

Database type. Specify this property if you are using a SQLServer database.


uc.db.url=jdbc:sqlserver://localhost:1433;DatabaseName=uc

JDBC connect URL. Specify this property if you are using a SQLServer database.


For Oracle



uc.db.rdbms=oracle

Database type. Specify this property if you are using an Oracle database.


uc.db.url=jdbc:oracle:thin:@//localhost:1521/@oracle.db.name@

JDBC connect URL. Specify this property if you are using an Oracle database.


For All Databases



uc.db.name

IMPORTANT

If you specify a database name in this property and in uc.db.url, the names must be the same.

Name for the Controller database.

uc

uc.db.password

Database password that will be replaced by uc.db.password.encrypted in the uc.properties file upon start-up.

(none)

uc.db.password.encrypted

Encrypted version of uc.db.password that will replace uc.db.password in the uc.properties file upon start-up.

(none)

uc.db.pooler.connections

Sets the minimum number of idle connections to maintain in the Server connection pool, or zero to create none.
 
The Server connection pool is used by all internal database transactions.

1

uc.db.pooler.connections.Client

Sets the minimum number of idle connections to maintain in the Client connection pool, or zero to create none.
 
The Client connection pool is used by all user interface related database transactions.

1

uc.db.pooler.connections.max

Sets the maximum number of connections that can be allocated by the Server connection pool at a given time.
 
The Server connection pool is used by all internal database transactions.
 

Note

The installer overrides the default by configuring a maximum number of 40 in the uc.properties file.

30

uc.db.pooler.connections.max.Client

Sets the maximum number of connections that can be allocated by the Client connection pool at a given time.
 
The Client connection pool is used by all user interface related database transactions.

30

uc.db.pooler.connections.max.Reserved

Sets the maximum number of connections that can be allocated by the Reserved connection pool at a given time.
 
The Reserved connection pool is used by all critical internal database transactions.

30

uc.db.pooler.connections.Reserved

Sets the minimum number of idle connections to maintain in the Reserved connection pool, or zero to create none.
 
The Reserved connection pool is used by all critical internal database transactions.

1

uc.db.url.append.properties

Allows additional options to be appended to the JDBC URL generated by Universal Controller.
 
Example:
 

(none)

uc.db.user

Login ID that the Controller will use to log in to your database.

root

For LDAP:



uc.ldap.groups.filter_indirect

When this property is set to true, any Groups synchronized indirectly (that is, through a User's memberOf attribute) will honor the Group search filter and Group OU filters under the LDAP Advanced Settings section.
 

Note

The code default for this property, which is used if this property is not set, is false.

true

uc.ldap.groups.single_parent_per_child

IMPORTANT

This property should be set to true only if your Groups being synchronized from AD have at most one parent Group.

When synchronizing Groups, the default behavior in the Controller is to copy the members of a Sub Group into the Parent Group.
 
When this property is set to true, the Controller assumes that each Group has, at most, a single Parent Group and will use the Parent field on the Group definition to maintain the hierarchy instead of copying members.

false

uc.ldap.groups.update_members

IMPORTANT

This property should be set to false only when synchronizing Groups from AD, and the number of values for the member attribute exceeds the MaxValRange LDAP policy (and the MaxValRange cannot be increased).

When synchronizing Groups, the default behavior in the Controller is to use the multi-valued member attribute to update the members for a Group; however, AD limits the number of values returned for an attribute, which can result in Group members being removed unexpectedly. This limit is determined by the MaxValRange LDAP policy (typically 1,500).
 
When this property is set to false, the Controller will not use the member attribute values to update members when synchronizing Groups from AD. Group membership will continue to be updated based on the memberOf attribute values when synchronizing Users from AD.

true

uc.ldap.users.synchronize_by_range

IMPORTANT

This property should be set to false only if your LDAP server supports paged results.

 
When synchronizing Users, the default behaviour in the Controller is to search based on ranges, using a filter like (&(uid>=a)(uid<=b)). To use the <= or >= operators in a filter, an ordering rule must be defined for the attribute in the LDAP schema.
 
OpenLDAP's schema does not define an ordering rule for the User Id Attribute (for example, uid), so searches using filters like the above do not return any results.
 
When this property is set to false, the Controller will not search based on ranges when synchronizing Users.

true

uc.ldap.users.synchronize_indirect

IMPORTANT

This property should be set to true only if your LDAP server does not support the User Membership Attribute (for example, memberOf).

Synchronizes LDAP users indirectly based on group membership. This only applies to groups that users are direct members of.
 
When this property is set to true, the following will apply for the LDAP refresh (scheduled and server operations):

  • Users will not be synchronized directly based on the User Filter and User Target OU List.
  • Groups will continue to be synchronized directly based on the Group Filter and Group Target OU List.
  • For each matching group, the Group Member Attribute (for example, member) will be used to synchronize users matching the User Filter and User Target OU List

Note

The uc.ldap.groups.update_members property will be ignored when indirect user synchronization is enabled.

Note

There is currently no support for nested groups if the User Membership Attribute is not supported by the LDAP server.

false

uc.ldap.users.update_memberships_on_login

IMPORTANT

This property should not be set to true if group membership for users is static, since there is extra overhead to process the groups, which may impact login performance.

When this property is set to true, LDAP group memberships for existing LDAP users are updated upon successful login.

Note

When dynamically creating a new LDAP user at login, the user will be added only to groups that it is a direct member of. Likewise, when updating an existing LDAP user at login, the user will be removed from any groups that it is not a direct member of. Therefore, it is not recommended that you enable this property if a group hierarchy exists, since the user will be removed from any parent groups when logging in. (Group membership for the parent groups will be restored the next time the LDAP refresh runs; however, this can take up to 24 hours.)

false

For Single Sign-On:



saml.log.level

Configures the log level for the SAML framework: ALL, TRACE, DEBUG, INFO, WARN, or ERROR.

INFO

saml.maxAuthenticationAge

Specifies how long, in seconds, users can single sign-on after their initial authentication with the Identity Provider (based on value AuthInstance of the Authentication statement). Some Identity Providers allow users to stay authenticated for longer periods than this, so you might need to change the default value.

7200

Other Properties:



jdk.xml.entityExpansionLimit

Limits the number of XML entity expansions.
 
Valid values are any positive integer. A value equal to 0 indicates no limit.
 
If jdk.xml.entityExpansionLimit is not specified in uc.properties (or on start-up with -Djdk.xml.entityExpansionLimit=<limit>), Universal Controller will initialize it to a default value of 1.

  • If jdk.xml.entityExpansionLimit is specified on start-up with -Djdk.xml.entityExpansionLimit=<limit>, this takes precedence over the Universal Controller default value of 1.
  • If jdk.xml.entityExpansionLimit is specified in uc.properties, this takes precedence over specifying it on start-up with -Djdk.xml.entityExpansionLimit=<limit>.

1

uc.date.formats

Accepted input date formats for Date Functions and Stored Procedure parameters. For example: uc.date.formats=yyyy/MM/dd;dd/MM/yyyy. Formats can vary, but years must be defined with four digits (yyyy). Formats are used on a "first match" basis.


uc.email.attachments.local.path

Directory location from where files can be attached for a specific Cluster Node / Server. You must specify a location in this property in order for the Attach Local File field to display in the Email Task and Email Notifications Details.
 
The uc.properties file is refreshed every 10 minutes to accommodate changes to this property without requiring a restart. Every 10 minutes, uc.properties is read, and if this property value has changed, that new value then will be used within the Controller.
 

This property is local to the Cluster Node and must be specified on each Node based upon the path for that Node. Each Node can have a different path, but they should point to the same shared physical location in order to achieve the expected behavior. Best practices would be to use the same path in each Node.


uc.action.email_notification.attach_output.subscription.timeout_in_seconds

Number of seconds for Email Notification output timeout. 180

uc.keymanager.algorithm

Java key manager algorithm.

  • For IBM AIX, the value must be IbmX509.
  • For all other platforms, use the default value.

If no value is specified, the configured JVM default will be used.


uc.keymanager.client.alias

If multiple certificates reside in the keystore that could match the OMS server's certificate request, specifying an alias ensures that the intended client certificate is presented to the OMS server.


uc.keymanager.keystore

Location of the keystore which holds certificates and keys.


uc.keymanager.keystore.password

Password (if required) for the keystore that will be replaced by uc.keymanager.keystore.password.encrypted in the uc.properties file upon start-up.


uc.keymanager.provider

Java key manager provider.

  • For IBM AIX, the value must be IBMJSSE2.
  • For all other platforms, use the default value.

If no value is specified, the configured JVM default will be used.


uc.mbean.catalina.manager.name

The Controller uses the Catalina:type=Manager MBean for the User Sessions feature.
 
To determine the Manager MBean object name, the Controller dynamically determines the context. For example:
 
Catalina:type=Manager,context=/uc,host=localhost
 
If the following error appears in the Console while you are using the User Sessions feature, you may need to configure this property manually:
 
Universal Controller not configured for user session operations.
 
In the uc.log, you would see the following:
 
javax.management.InstanceNotFoundException: Catalina:type=Manager,context=/uc,host=localhost


uc.oms.service_timeout

Sets the OMS service timeout value specifying the number of seconds of inactivity before a timeout exception will be thrown.

For example, you will see the following in the uc.log:

Default (180 seconds)

2021-08-04-21:12:25:542 -0400 INFO [UC.OMS.Monitor.0] Created: OMSServerConnection [userName=null, clientId=ops.controller.f9a86ee2bd5e4928b3173b186e0feb3c, clientInstance=15296bc7-e994-49eb-a6cf-0ecbf72d5f2f, transportAddresses=OMSTransportAddress [[localhost/127.0.0.1:7878]], nft=true, socketTimeout=30, serviceTimeout=180, authenticateServer=false, serverAddress=null, nextSessionId=0, isClosing=false, connectionInstance=1]

uc.oms.service_timeout=300

OMSServerConnection [userName=null, clientId=ops.controller.f9a86ee2bd5e4928b3173b186e0feb3c, clientInstance=96e45eb5-c513-489a-8746-6223e962e901, transportAddresses=OMSTransportAddress [[localhost/127.0.0.1:7878]], nft=true, socketTimeout=30, serviceTimeout=300, authenticateServer=false, serverAddress=null, nextSessionId=0, isClosing=false, connectionInstance=1]
180 seconds

uc.overdue.timer.startup.threshold

Maximum number of days after which an overdue trigger is considered "stale/expired."

2

uc.servlet.port

Port number used by Tomcat.

8080

uc.trustmanager.algorithm

Java trust manager algorithm.

  • For IBM AIX, the value must be IbmX509.
  • For all other platforms, use the default value.

SunX509

uc.trustmanager.provider

Java trust manager provider.

  • For IBM AIX, the value must be IBMJSSE2.
  • For all other platforms, use the default value.

SunJSSE

uc.trustmanager.ssl.protocols

Comma-separated list of SSL/TLS protocols that can be used for Controller/OMS communications.
 

  • If the property does not contain a protocol list, a default SSL/TLS context will be referenced for building the SSL/TLS socket used for Controller/OMS communications.
  • If the property is used, only those protocols will be enabled for the Controller/OMS session.
  • If the property is not used, only the protocols specified in currently configured default SSL/TLS Context's default SSL/TLS protocol list will be enabled for the Controller/OMS session.


uc.trustmanager.truststore

Location of the keystore which holds certificates and keys.

properties/cacerts

uc.trustmanager.truststore.password

Password (if required) for the keystore that will be replaced by uc.trustmanager.truststore.password.encrypted in the uc.properties file upon start-up.

changeit

uc.trustmanager.truststore.password.encrypted

Encrypted version of uc.trustmanager.truststore.password that will replace uc.trustmanager.truststore.password in the uc.properties file upon start-up.


uc.ui.session_timeout

Default browser session timeout, in minutes. To use the Tomcat session configuration (default 30 minutes), set this property to 0.

30

uc.web_service.allow_unknown_properties

Specifies (true or false) whether web service APIs will fail if the request payload contains unknown properties. false

uc.web_service.httpclient.socket.keep_alive

Specifies (true or false) whether TCP socket keep-alive option is enabled for HTTP(S)/REST Web Service Tasks.

false

Sample uc.properties File

# DB
uc.db.rdbms=mysql
uc.db.url=jdbc:mysql://localhost/
# MYSQL
# uc.db.mysql.character_encoding=UTF-8
# uc.db.rdbms=mysql
# uc.db.url=jdbc:mysql://localhost/
# MS SQLSERVER
# uc.db.rdbms=sqlserver
# uc.db.url=jdbc:sqlserver://localhost:1433;DatabaseName=uc
# ORACLE
# uc.db.rdbms=oracle
# uc.db.url=jdbc:oracle:thin:@//localhost:1521/@oracle.db.name@
#
# COMMON
#
# trust manager algorithm & provider
# uc.trustmanager.algorithm=SunX509
# uc.trustmanager.provider=SunJSSE
# uc.trustmanager.ssl.protocols=TLSv1,TLSv1.1,TLSv1.2
#
uc.db.user=root
uc.db.password=pswd
uc.db.name=uc
uc.servlet.port=8080
uc.ui.session_timeout=30

Universal Controller System Properties

Properties for your Universal Controller system are set (in the Controller database) during Controller installation. These properties let you define Controller system information and performance.

Universal Controller system properties do not reside in a properties file; they are available only via the user interface.

Although you can reset these properties any time after the Controller is in operation without having to stop and restart the Controller, you should click the Reload current page icon in your browser taskbar after resetting a property.
 

Note

You must be assigned the ops_admin role in order to reset these properties.

Step 1

From the Available Services, select Administration > Properties. The Properties list displays.
 

Step 2

If you want to change the value of a property, click a its Value field and select/enter a new value.

Step 3

To filter the list of displayed properties, enter appropriate characters (not case-sensitive) in the empty fields above the Name and/or Value columns.
 
For example, to display only properties elated to promotion, enter promotion (or PROMOTION, promo, etc.) in the empty field above the Name column.


The following table describes the Universal Controller system properties:

Name
(Property Name)

Description

Default

Administrator Email Address
(uc.admin.email_addr)

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)

Agent Address Information Restricted
(uc.agent.address_info_restricted)

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.

true

Agent Cache Retention Period in Days
(uc.agent.cache.retention)

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

7

Agent Cluster Network Alias Cache Retention In Minutes
(uc.agent_cluster.network_alias.cache_retention_in_minutes)

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

30

Agent Cluster Network Alias Retry Interval In Minutes
(uc.agent_cluster.network_alias.retry_interval_in_minutes)

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

5

Agent Cluster Network Alias Uquery Port
(uc.agent_cluster.network_alias.uquery_port)

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

7887

Agent Credentials Required
(uc.agent.credentials.required)

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

false

Agent Credentials Required On Registration
(uc.agent.credentials.required.registration)

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

(none)

Agent Heartbeat Grace Period in Seconds
(uc.agent.heartbeat.grace_period_in_seconds)

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.

false

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

Allow In Doubt Re-run
(uc.task_instance.rerun.allow_in_doubt)

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

Audit Owner Read Permitted
(uc.audit.owner.read.permitted)

Specifies if users without the ops_admin role or the ops_audit_view role can view their own audits, specifically, any audit indicating it was Created By their User Id (Username). true
Autofit Plain Large Text Fields 
(uc.universal_template.text_field.large.plain.auto_fit)
Specification (true or false) for whether or not the Controller will auto-fit Universal Task Large Text Fields when Text Type is Plain. true

Automatically Create Versions
(uc.version.automatically)

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

Banner Background Color
(uc.banner.background_color)

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

Banner Logo
(uc.banner.logo)

Name of the Banner Logo file to use in the Universal Controller user interface page banner (next to the Stonebranch logo). Enter the name of the logo file, excluding the path, from directory ../tomcat/uc_images/. Valid logo files end in extension .png, .jpg, or .gif.
 

Note

The banner logo is allocated a maximum width of 298px and a maximum height of 32px. The image will be scaled, preserving its ratio, to fit within its designated area.

(none)

Banner Logo URL
(uc.banner.logo_url)

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

Bulk Export Activity Permitted
(uc.bulk_export.activity.permitted)

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

false

Bundle Exclude On Existence Picker Default
(uc.bundle.exclude_on_existence.picker.default)

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)

Bundleless Promotion With Execute Permission Permitted
(uc.promotion.bundleless.execute_permission.permitted)

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

Business Service Visibility Restricted
(uc.bsrvc.visibility_restricted)

Specification (true or false) for whether or not drop-down lists for selecting a Business Service, such as in the Member of Business Services field, should restrict the visibility of Business Services available for selection based on a user's assigned (or inherited) Permissions and Roles.
 
If a user has any Permission, directly assigned or inherited, with its Member of Any Business Service or Unassigned checkbox selected, the user will have no Business Service visibility restrictions.
 
For any Permission that the user has, directly assigned or inherited, with an explicit Business Service specified for Member of Business Services, visibility for that specific Business Service will not be restricted.
 
The following Roles, directly assigned or inherited, provide a user with unrestricted Business Service visibility.

  • ops_admin
  • ops_agent_cluster_admin
  • ops_bundle_admin
  • ops_dba
  • ops_email_admin
  • ops_oms_admin
  • ops_peoplesoft_admin
  • ops_promotion_admin
  • ops_sap_admin
  • ops_service
  • ops_snmp_admin
  • ops_user_admin

Note

In cases where the user can Read a record that is a member of one or more Business Services, and visibility for one or more of those Business Services is restricted for that user, the user will be able to see the display name of those Business Services in the Member of Business Services field; however, the drop-down will not contain those Business Services for selection.
 
Any attempt to modify the selection of the Member of Business Services field will result in the removal of restricted Business Services from the selection.

false

Calendar Preview Past Period In Months
(uc.calendar.preview.past.months)

Number of months (going backwards) to show all Custom Days defined for a calendar in a Calendar Preview. 3

Calendar Preview Future Period In Years
(uc.calendar.preview.years)

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

CLI/Web Service Result Limit
(uc.cli.result_limit)

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

Confirm Enable/Disable Trigger Command
(uc.user.confirm.enable.disable.trigger.default)

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

yes

Confirm Exit
(uc.browser.confirm_exit)

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

Confirm Update For Tasks In Workflows
(uc.task.confirm.workflow_update)

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

Create Version On Related List Change
(uc.version.on.related.list.change)

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

Critical Path Calculations Permitted
(uc.cp.calculations.permitted)

Specification (true or false) for whether or not a user can use the Critical Path feature of the Controller.

false

Critical Path Color
(uc.cp.color)

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)

Critical Path Dynamic Calculation Threshold In Seconds
(uc.cp.calculations.dynamic.threshold_in_seconds)

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

Critical Path Monitor Polling Interval In Seconds
(uc.cp.monitor.polling.interval_in_seconds)

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

Critical Path Monitor Polling Threshold In Seconds
(uc.cp.monitor.polling.threshold_in_seconds)

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

Critical Path Projected Late Action Maximum
(uc.cp.projected_late.action.maximum)

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

Critical Path Projected Late Threshold In Minutes
(uc.cp.projected_late.threshold_in_minutes)

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

Custom Day Global Permitted
(uc.custom_day.global.permitted)

Specification (true or false) for whether to enable (true) or disable (false) global Custom Days.
 

Note

You cannot set Custom Day Global Permitted to false if there are any existing global Custom Days.

true

Custom Day Local Indicator Enabled
(uc.custom_day.local_indicator.enabled)

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

Custom Day Strict Mode
(uc.custom_day.strict.mode)

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

Data Backup/Purge Export Path
(uc.backup.path)

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

(none)

Disable Tab Indicators
(uc.disable.tab.indicators)

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

Email Body Default Begin Marker
(uc.email.body_begin_marker)

Default Begin Marker for Email Monitor Body Variables field.

- - BEGIN - -

Email Body Default End Marker
(uc.email.body_end_marker)

Default End Marker for Email Monitor Body Variables field.

- - END - -

Email Credentials Permitted
(uc.credentials.email.permitted)

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

true

Email Monitor Polling Interval In Seconds
(uc.email.monitor.polling.interval_in_seconds)

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

120

Email Notification Audit
(uc.email.notification.audit)

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

(none)

Exclude Holidays for Business Days
(uc.calendar.exclude_holidays)

Specification (true or false) for whether or not the Controller will consider a Business Day on which a holiday falls as a non-Business Day.

  • If true, holidays that fall on Business Days are considered non-Business Days.
  • If false (the default), holidays that fall on Business Days are considered Business Days.

For example, if the default value (false) is used, and a job is defined to run on Business Days, the job will run on Christmas Day, even though it is a holiday.
 
This behavior applies to Triggers, Task Run Criteria, and JavaScript functions that operate on Business Days, and provides a means to avoid having to specify a restriction or skip criteria for holidays.

false

Expand Lists Automatically
(uc.lists.expand_automatically.default)

Specification (Yes or No) for whether or not to Expand Lists by Default in the List / Details views. No

Export Agent References
(uc.export.agent_references)

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

false

Export Path
(uc.export.path)

Pathname where exported XML files are written.
 
All cluster nodes use their own local system default export path. You should set a value for Export Path only if the path is writable by all cluster nodes.
 

Note

Any bulk import or list import of an Export Path property (from version 6.1.1.0 or earlier) will result in the server resetting the database back to the default "unset" Export Path value.
 
Both bulk export and list export will first look for a configured Export Path property. If a value has not been set, they will use the local system default path of <tomcat>/uc_export.

(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

File Transfer Task Exclude Protocols
(uc.task.file_transfer.exclude_protocols)

Specification for which protocols will be excluded from the Transfer Protocol field in the File Transfer Task Details:

  • FTP
  • SFTP
  • UDM
  • FTPS
  • FTPES

You can select multiple, but not all, protocols. Also, you cannot exclude a protocol if it is specified in the Transfer Protocol field for any exisitng File Transfer Task or Task Instance.


Flatten Reference List Fields In Chart Reports
(uc.report.flatten_references)

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

false

Forecast Period in Days
(uc.forecast.days)

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

31

Inherit Actions On Defined For Insert Task
(uc.inherit_actions.on_defined.insert_task)

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

LDAP Synchronization Enabled
(uc.security.ldap.enabled)

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

Log File Retention Period in Days
(uc.log.retention)

Number of days that the Controller retains its log files.

5

Log Level
(uc.log.level)

Level of logging for the Controller:

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

INFO

Login Disclaimer
(uc.login.disclaimer}

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

(none)

Login Notification
(uc.login.notification}

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

(none)

Maximum Nested Variable Depth
(uc.variable.maximum_depth)

Maximum number of nested variables allowed.

25

Maximum Nested Variable Expansion
(uc.variable.maximum_expansion)

Maximum number of nested variable characters allowed.

250000

Maximum Processing Threads
(uc.threads.max)

Maximum number of processing threads used.

1000

Maximum Timer Threads
(uc.timer.threads.max)

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. 

Yes

Node Time Display
(uc.node_time.display.default)

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

Yes

Node Time Display Background Color
(uc.node_time.display.background_color.default)

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

White

Node Time Display Color
(uc.node_time.display.color.default)

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

Black

Node Time Display Time Zone
(uc.node_time.display.tz.default)

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

OMS Log Level
(uc.oms.log.level)


INFO

Operational Memo Reset On Re-run
uc.task_instance.operational_memo.reset_on_rerun

Specification (true or false) for whether or not to reset the Operational Memo field on a task instance re-run. true

Perform Actions On Defined For Tasks Within Skipped Workflow
(uc.perform_actions.on_defined.tasks_within_skipped_wf)

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

Perform Actions On Defined Workflow First
(uc.perform_actions.on_defined.wf_first)

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

Perform Actions On Halt
(uc.perform_actions.on_halt)

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

Picker Fetch Limit
(uc.picker.fetch_limit)

Fetch limit for all picker windows; minimum =200, maximum = 1000.

For example, the value of this property determines how many tasks can be fetched at any one time for stonebranchbundle-01.

200

Platform Log Level
(uc.platform.log.level)

Level of logging for the user interface framework:

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

WARN

Promote By Business Service Membership Permitted
(uc.bundle.promote_by_bsrvc_membership.permitted)

Specification (true or false) for whether or not you can promote a Bundle by Business Service Membership.

You cannot set this property to false if the Promote Members of Business Services or Visible To field in any Bundle records has a non-empty value.

Also, if the proparty is set to false:

  • If the Promote Members of Business Services or Visible To field in a Bundle record has a non-empty value, Bundle promotion (including schedule Bundle promotion) is prohibited for that record.
  • If the Promote Members of Business Services and Visible To field in a Bundle reocrd has an empty/blank value, the Promote By Business Service Membership section will be hidden for this record.
true

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.

true
Promotion Follow Report References
(uc.promotion.report.follow_references)
Specification (true or false) for whether or not to promote referenced reports in an email task or email notification when Follow References is true for the promotion. true

Promotion History Retention Period in Days
(uc.promotion_history.retention)

Number of days that the Controller retains Promotion History.

60

Promotion Schedule Retention Period In Days
(uc.promotion_schedule.retention)

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

7

Promotion Validate Report References
(uc.promotion.report.validate_references)

Specification (true or false) for whether or not to implement report-related promotion validation.
 

This property applies to the target system to which a promotion payload is being promoted.

true

Purge Activity By Primary Key Limit
(uc.backup.purge_by_primary_key.limit)

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

500

Purge All Non-Default Users And Groups Permitted
(uc.purge.non_default_users_and_groups.permitted)

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

false

Purge Dates From Custom Day List Older Than
(uc.custom_day.purge_dates_older_than)

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

(none)

Re-run (Suppress Intermediate Failures) Permitted
(uc.task_instance.rerun.suppress_intermediate_failures.permitted)

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

true

Reconcile Built-In Universal Template Changes On Promotion
(uc.promotion.universal_template.system_template.reconcile_changes)


Controls the promotion behavior when promoting a Universal Task based on a built-in Universal Template that has changed. false

Recurring Task Launch Skip Condition Default
(uc.recurring.task.skip_condition.default)

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

  • None
  • Active
  • Active By Recurring Task Instance
None

Recurring Task Minimum Frequency In Seconds
(uc.recurring.task.minimum_frequency_in_seconds)

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

The minimum value is 0.

5

Remote File Monitor Task Exclude Protocols
(uc.task.ftp_file_monitor.exclude_protocols)

Specification for which protocols will be excluded from the Server Type field in the Remote File Monitor Task Details:

  • FTP
  • SFTP
  • FTPS
  • FTPES

You can select multiple, but not all, protocols. Also, you cannot exclude a protocol if it is specified in the Server Type field for any exisitng Remote File Monitor Task or Task Instance.

Report Average Color
(uc.report.average_color.default)

Specification of the default hexadecimal color of the average line when using the Show Average option on Bar Chart/Horizontal and Bar Chart/Vertical reports. #000000

Report Group Threshold
(uc.report.group_threshold.default)

If the Group Threshold field on the Report is - - System Default - -; Maximum number of groups to display on a Chart report. All groups above the threshold will be displayed in one group named Other.
 

Note

This option formerly was named System Default Report Group Threshold.

10

Report Threshod Color
(uc.report.threshold_color.default)

Specification of the default hexadecimal color of the threshold line when using the Show Threshold option on Bar Chart/Horizontal and Bar Chart/Vertical reports. #000000

Resolvable Credentials Permitted
(uc.credentials.resolvable.permitted)

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

false

Retain Overridden Step Codes On z/OS Task Re-run
(uc.task_instance.rerun.zos.retain_step_codes)

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

Retrieve Output Default Number Of Lines
(uc.retrieve_output.maximum_lines)

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

Retrieve Output Maximum Lines
(uc.retrieve_output.maximum_lines.limit)

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

(none)

Scheduled Report 3D Pie Chart
(uc.report.scheduled.3d_pie_chart.default)

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

No

Scheduled Report Fetch Limit
(uc.report.scheduled.fetch_limit)

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

Scheduled Report Image Height
(uc.report.scheduled.image_height.default)

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

500

Scheduled Report Image Width
(uc.report.scheduled.image_width.default)

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

750

Scheduled Report Inline Image
(uc.report.scheduled.inline_image.default)

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

Scheduled Report PDF Orientation
(uc.report.scheduled.pdf.orientation.default)

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

Landscape

Scheduled Report PDF Size
(uc.report.scheduled.pdf.size.default)

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

Letter

Scheduled Report Time Zone
(uc.report.scheduled.tz.default)

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 Resolve UAC Variables option in scripts is enabled by default. false
Show Last Login
(uc.login.show_last_login)

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.

true

Show Metadata
(uc.form.show_metadata.default)

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

Show Variables Fetch Global Automatically
(uc.show_variables.fetch_global.default)