Environment entries and resources

The FTM enterprise application contains a number of environment entries and resources that need to be adjusted to complete your installation. The values for the environment entries for this web module can be changed by using IBM® WebSphere® Liberty. You can change the Db2® database schema that is used by the application. You can also change several other entries, including security and IBM MQ resource references.

The following list shows the entries for the Operations and Administration Console (OAC):

dbDataConnections

Used to configure multiple database connections.

lang

Sets the language setting for the logon page. Use two-letter language codes such as en, fr, es, nl, or ja to set the default language at logon. For overall language setting, when logged in, the user can set the language on the User Preferences window.

jms_persistent

Set to true to make the messages that are sent from the console persistent. Persistent messages guarantee message delivery if the message server fails.

enableSecurityManager

Used to turn on or off the FTM console security manager, which controls page authorization. This entry is normally enabled in a production environment. Valid values are true or false.

enableSecurityManagerReloading

The security manager loads authorization data from the FTM database. If this function is enabled, this data is reloaded at a defined interval. Valid values are true or false.

securityManagerReloadInterval

Used to specify the interval (in seconds) at which the security manager reloads data if this function is enabled.

resourceAuthorizationFailedPage

Used to specify the JSP that is loaded when a user tries to access a page and is not authorized to do so.

enablePerUserDebug

Controls the logging of trace on a per-user level within a users session. Valid values are true or false.

genTableSql

Controls the availability of the SQL that is used to produce a list of tabulated query results. Valid values are true or false.

countAllAlerts

Used to turn on or off a summary on the alerts page that indicates the total number of alerts in the system. Depending on your search criteria, the list can be empty. The summary at least provides an indication that you have alerts that are not in your results. Valid values are true or false.

enableTxnAltId

Used to turn on or off the presentation of an ALT ID field on some windows. Valid values are true or false.

enableExceptionView

Used to turn on or off the presentation of the full details of error exceptions.

ccsidZeroDefault

Defines the default CCSID to use for a physical transmission to be rendered by the FTM console when the CCSID for the transmission is set to 0. The format of this entry is [chan,] nnnn. Either specify a fixed CCSID or specify that FTM first refer to the channel that the transmission is related to before it defaults to using a set value. If FTM cannot resolve the CCSID, the transmission is rendered as binary.

allAlertsInterval

Specifies an automatic reload interval for the alerts page. Set this entry to -1 to disable the auto reloading function. Set this entry to 0 to disable the function but allow a user to enable it for their session. Other positive values set the reload interval in seconds. Using the auto reload function has a slight security risk because your web session never expires if the alerts page is left open.

numberRowsPerList

Specifies the maximum number of entries to be populated in a scroll table for search results. This entry is the default value for the user, which can be changed in the FTM console user preferences.

opSearchAuto

Enables and disables automatic searching when a search page loads. Valid values are true or false. This entry is the default value for the user, which can be changed in the FTM console user preferences.

opSearchOrderByDefault

Controls ordering of search results when no specific order was requested. Valid values are true or false. This entry is the default value for the user, which can be changed in the FTM console user preferences.

time zone

Used to set the time zone that is used in the rendering and processing of timestamps.

expireSessionOnLeave

The OAC can cause a user session to expire when the browser is used to browse away from FTM. For example, by using the back, address bar, or favorites options in the browser to go to a different web page. Valid values for this entry are shown in the following list.

no: The user session does not expire when the browser is used for something other than FTM. This value is the default.
yes: The user session does expire when the browser is used for something other than FTM.
prompt: Before the session expires, a dialog box is opened for the user to indicate whether they want their session to expire or not.

isfVersion

Specifies the version of ISF to be used when ISF command messages are sent. The user interface attempts to work with any numeric version string of the form nn.nn.nn. The current valid ISF versions are 1.0, 2.0 and 3.0.

systemIdentifier

This entry can be used to add a system or environment label, which is shown just under the main menu, to the user interface. It can be used in situations where you might need to work with multiple systems or environments at the same time; for example, development, test, or production. This identifier can provide a clear indication to a user about which system they are currently using, hopefully reducing the chance of interacting with the wrong environment.

systemIdentifierCSS

This entry can be used to control the display properties of the systemIdentifier label. The content of this value follows CSS inline style syntax

property:
value;

. A default value is provided as an example on how to set the text size, color, background, and border:

color: DarkBlue; width: 25%; 
background-color: AliceBlue; 
font-size: medium; font-weight: bold; 
text-align: center; border: solid; 
text-decoration: none

You can apply any valid CSS property in this entry. However, these properties are currently applied to a <span> element and some browsers might behave slightly different than what you expect since CSS support varies.

Notes:

Border properties were observed to not work with Internet Explorer 7, so the FTM user interface does special formatting for Internet Explorer if you specify this property in this entry. You might find that Internet Explorer ignores other border-related properties if you specify them.
FTM supports CSS text-decoration: blink on Internet Explorer and Firefox, even though Internet Explorer does not support this property.

resolveDetailSummaryThreshold

Specifies the number of rows in a list of objects to be resolved for which the details are to be shown. Unless the number of objects in the list of objects to be resolved exceeds this threshold, the details for all objects are displayed. Otherwise, only the count of how many objects are in the list is displayed. This entry is the default value for the user, which can be changed in the FTM console user preferences.

suppressSecurityWarnings: Set this entry to true to suppress the alert that advises the user whether one or more web application security vulnerabilities exist. For more information, see Web application security warnings in the OAC. Valid values are true or false. The default is false.

enableCount: Set this entry to true to always display a count of the total number of rows in a list. This entry is set to false by default, which means that the count is displayed only on the last page of any list. Enabling this feature affects the performance as a further database query is needed to obtain the count. Valid values are true or false.

enableSubTypeCheck: Set this entry to true to indicate that when multiple objects are selected for resolution, their subtype must be the same. Valid values are true or false, and the default is true.

refererAllowedList

This entry is a comma-separated list of trusted referrer URLs that are allowed when the RefererFilter servlet checks for potential cross-site request forgery (XSRF) attempts. If an allowlist is configured, the list is expected to be a comma-separated list of names in the following format: [*][<protocol>://]<host>[:<port>][*] The wildcard character (*) can be used to allow any protocol or port to be accepted.

For example, to allow the following referrer URL, https://www.example.com:1234, the allowlist needs to contain any one of the following entries.

https://www.example.com:1234
*www.example.com*
*www.example.com:1234
https://www.example.com*