Configuration file

The bridge has a number of configuration options which are specified in a configuration file. This configuration file is divided in stanzas or sections.

Stanzas start with a name in square brackets, for example, [stanza1], except for the first stanza, which does not need an explicit header. The first stanza ends with the beginning of a new stanza, or with the end of the configuration file.

Each stanza contains a set of logically related configuration parameters which are in keyword=value format. Keywords must be unique per stanza but the same keywords can be used in different stanzas.

Comments can be added to the configuration file at any point. Comment lines must start with a hash pragma (#) in the first column. Comment lines are simply ignored by the input parser. The same is true for blank lines which may be interspersed at any point.

Bridge configuration parameters

The configuration properties are read by the bridge at program start up time. Any changes applied to the configuration file are ignored until the bridge is stopped and re-started. If any of the mandatory stanzas or properties are missing, the adapter for FRONT ARENA terminates immediately.

Note:
The stanza names, keywords, and values are case sensitive.

Configuration parameters, ordered by stanzas, are supported by the bridge.

General configuration settings

The main (unnamed) stanza contains some general configuration properties and the parameters used for communication with the AMB component of FRONT ARENA.

Table 21. Main (unnamed) stanza

Keyword Mandatory/ Optional/ Default value Possible values Description
Mode Mandatory Event, Request, Both The types of processing supported by the bridge include the following:
  • Event: Event processing only
  • Request: Request processing only
  • Both: Both event and request processing
FAHost Mandatory Valid URL The URL of the system hosting FRONT ARENA.
FAAMBPort Mandatory 1 - 65536 The port number of the FRONT ARENA AMB server.
FAUserID Optional 1 - 65536 Valid FRONT ARENA (AMB) User ID The user ID used when logging in to the AMB.
Note: If no user ID and password are provided, the values from the
AMB.ini
file are taken.
FAPassword Optional Valid FRONT ARENA (AMB) password The password used when logging in to the AMB.

FAMonitoring Port

Optional 1 - 65536 The port number of the FRONT ARENA System Monitor.
Note: This is supported with FRONT ARENA 1.5 or higher only.
FARetries Optional
Default: 3
Integer value: Zero value means retry forever. The number of retries if the connection to the AMB cannot be established or drops.

FARetryInterval

Optional
Default: 60000
Integer value > 0 The time (in milliseconds) between successive retries to establish an AMB connection.

PollFrequency

Optional
Default: 10000
Integer value > 0 The time interval (in milliseconds) between successive attempts to read messages from the AMB or WebSphere MQ queues. In the case of heavy traffic, the time interval is automatically reduced by the application.
TraceFile Optional
Note: This property must be provided if the trace is switched on (TraceLevel>0).

(Path and) file name The trace file name.
TraceLevel Optional
Default: 0
0: Trace switched off
1: Error messages
2: Not used currently
3: Not used currently
4: Trace call sequence
5: Informational messages
The trace level.
Note: Higher trace levels include all messages from lower levels.
LogFile Mandatory (Path and) file name The log file name.
LogLevel Optional
Default: 3
1: Log errors only
2: Log errors and warnings
3: Log errors, warnings, and informational messages
The log level.

Copyright IBM Corp. 1997, 2004