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.
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.
Configuration parameters, ordered by stanzas, are supported by the bridge.
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:
|
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.inifile 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. |