HCL Workload Automation, Version 9.4

Customizing your global settings

How to customize global settings.

About this task

To customize the behavior of the Dynamic Workload Console, you can optionally configure some advanced settings. These settings are specified in a customizable file named TdwcGlobalSettings.xml.template.

By default, the customizable file is copied into the following path after you install the Dynamic Workload Console:
For Windows systems:
C:\Program Files\IBM\JazzSM\profile\registry\TdwcGlobalSettings.xml.template
For UNIX and Linux systems:

You can find a copy of this file also on the installation media in the directory /utilities/TdwcGlobalSettings.xml.

If you have Administrator privileges, you can modify the file to replace default values with customized ones and enable commented sections. To enable commented sections, remove the <!-- and --> tags that enclose the section. You then save the file locally with the name TdwcGlobalSettings.xml.

You can add and modify some customizable information, such as:
  • The URLs that link to videos in the Dynamic Workload Console. For example, you can link to a company intranet server to view help videos rather than to a public video site.
  • The maximum number of objects to be shown in the graphical views.
  • The setting to display the plan view in a new window.
  • Start of changeThe auto refresh interval for the Show Plan View graphical view.End of change
  • The configuration details to enable the news notification beacon and be constantly up-to-date with product information. See Disabling news notification.
  • The creation of predefined tasks.
  • The URLs where you can store customized documentation about your jobs or job streams to associate customized documentation to them.
  • The current user registry in use.
  • The timeout to read and write information on a IBM Workload Scheduler for z/OS engine.
  • The maximum number of objects to be retrieved with a query, the maximum number of rows to display in a table, and the maximum number of direct queries to maintain in history.
  • Allowing or preventing users from sharing tasks and engine connections.
  • The display of all dependencies, both satisfied and unsatisfied.
  • The use of audit files to track activities in the Self-Service Catalog and Self-Service Dashboards mobile applications.
  • Displaying or hiding all predecessors from the What-if Analysis Gantt view.

This file is accessed at each login, and all configurations specified in the file are immediately applied, except for the precannedTaskCreation property. This property is read only when a user logs in for the first time and is then used whenever this user logs in again.

You can use any text or XML editor to edit this file, but ensure that you save it is as a valid XML file.

The file is organized into sections that group similar properties. An explanation of each section is available in the file. For more information, see TdwcGlobalSettings.xml sample.

Sections can also be repeated multiple times in the same file and applied differently to different user roles. To apply a section only to the users belonging to a role, the section must be included within the tags <settings role="user_role"> and </settings>, where:
The user for which the enclosed configuration must be applied. The default value is all users, unless otherwise specified.

Only one settings section can be specified for each role. If a user has more than one role, the settings associated to the higher role are used.

<?xml version"1.0"?>
<property name="planViewNewWindow" value="true"/>

<settings  role="TWSWEBUIOperator">
<property name="planViewNewWindow" value="false"/>
To view the complete syntax for the file, see TdwcGlobalSettings.xml sample.