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:
On Windows operating systems:
DWC_home\usr\servers\dwcServer\registry\TdwcGlobalSettings.xml.template
On UNIX and Linux operating systems:
DWC_home/usr/servers/dwcServer/configDropins/templates/TdwcGlobalSettings.xml.template
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 tags that enclose the section. You then save the file locally with the name TdwcGlobalSettings.xml.
Note: On UNIX and Linux operating systems, you need to save the TdwcGlobalSettings.xml file in the following path: DWC_DATA_dir/usr/servers/dwcServer/registry/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.
  • The auto refresh interval for the Show Plan View graphical view.
  • 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 HCL Workload Automation for Z 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:
<user_role>
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.

To edit the file, proceed as follows:
  1. Stop WebSphere Application Server Liberty Base using the following command:
    UNIX
    Stop the application server
    ./stopAppServer.sh  [-direct]
               
    Windows
    Stop the application server
    stopAppServer.bat [-direct
                [-wlpHome <installation_directory>]
                [-options <parameters>]]
    as described in Application server - starting and stopping.
  2. Log is as root or Administrator to the Dynamic Workload Console.
  3. Browse to
    On Windows operating systems:
    DWC_home\usr\servers\dwcServer\registry\TdwcGlobalSettings.xml.template
    On UNIX and Linux operating systems:
    DWC_home/usr/servers/dwcServer/configDropins/templates/TdwcGlobalSettings.xml.template
  4. Edit the file as necessary, rename it to TdwcGlobalSettings.xml and save it.
    Note: On UNIX and Linux operating systems, you need to save the TdwcGlobalSettings.xml file in the following path: DWC_DATA_dir/usr/servers/dwcServer/registry/TdwcGlobalSettings.xml
  5. Start WebSphere Application Server Liberty Base using the following command:
    UNIX
    Start the application server
    ./startAppServer.sh  [-direct]
    Windows
    Start the application server
    startAppServer.bat [-direct]
                     
    as described in Application server - starting and stopping.
Example:
<?xml version"1.0"?>
<tdwc>
.
.
<settings>
<graphViews>
<property name="planViewNewWindow" value="true"/>
</graphViews>
</settings>

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