VERSION 1.0

Overview

Reuters Bridge is the adaptor which is used for communication between financial information exchange protocols - Thomson Reuters Ticket Output Feed (TOF) и Financial Information eXchange (FIX).

Thomson Reuters Ticket Output Feed (hereinafter TOF) - financial information exchange protocol which is distributed by the Thomson Reuters. TOF provides possibility for subscription and receiving data related to deals.

Financial Information eXchange (hereinafter FIX) - an open procolol which is standard for exchanging financial data and making transactions in real time.

Reuters Bridge works as a service for receiving data by systems which support FIX protocol from systems which support TOF protocol, i.e. data is transmitted only in the direction from TOF server to FIX server. While working Reuters Bridge acts as a client for both FIX server and TOF server. 

Package structure description

Reuters Bridge programm module is distrubuted as archive. Reuters Bridge can work as a console application (ReutersBridge.exe --run console) or as a windows service.

Package structure

License information

License information is kept in ‘engine.license’ file which is provided separately from the installation package. Need to put the license file to the root Reuters Bridge directory ('./ReutersBridge/'). In order to update license it is enough to replace existing license file with new one.

Note: Reuters Bridge won't work without license or with expired license. If your license has expired or was lost, contact sales@btobits.com to obtain the new one;

Installation procedure

Installation of the Reuters Bridge can be performed by following step-by-step instruction described below:

1. Create directory on the local disk (e.g c:\b2bits);
2. Unpack the downloaded archive with Reuters Bridge to created directory;
3. Adjust configuration files for your current business needs;
4. Open the command line and go to application directory (e.g., cd c:\b2bits\ReutersBridge);
5. Use the following command to initiate application installation: ReutersBridge.exe --run install

Functionality description

Reuters Bridge program module performs the following main functions:

• supports FIX 4.4 protocol and TOF-protocol described in Reuters Bridge specification «Thomson Reuters Dealing - Datafeed TOF/IP & TOF/Serial User Guide» in version 4.7.10;
• allows to set up and keep connection between TOF-protocol data source and FIX-protocol data source;
• converts received TOF messages to FIX format;
• sends converted messages from TOF server to FIX server;
  

Supported message types

Reuters Bridge supports the following message types:

FIX -> Reuters Bridge:

• Session Level Messages (Heartbeat (0), Logon (A), Logout (5), Reject (3), Resend Request (2), Sequence Reset (4), Test Request (1))

Reuters Bridge -> Reuters:

• Data and Updates Request (332)
• Snapshot Request (333)

Reuters -> Reuters Bridge:

• Record Response (340)
• Updates (316)
• Status Response (407)

Reuters Bridge -> FIX:

• Session Level Messages (Heartbeat (0), Logon (A), Logout (5), Reject (3), Resend Request (2), Sequence Reset (4), Test Request (1))
  
• Trade Capture Report (MsgType = ‘AE’)

Supported deal types

Below is the list of deal types, for which Reuters Bridge supports their mapping to FIX format and transmitting to FIX server:

1. FX Swap
2. FX Spot
3. FX Outright
4. FX FRA
5. FX Deposit
6. NDF FX Swap
7. NDF Outright

Main Use Case scenario

Below is the main Use Case scenario of the Reuters Bridge programm module:

1. Reuters Bridge establishes a session with FIX server;
2. Reuters Bridge establishes a connection with TOF server;
3. For each Dealing Server identifier specified in the configuration file Reuters Bridge sends a request to TOF server to receive deals;
4. In case of successful processing, TOF server sends range of deals related to the requested Dealing Server identifier;
5. Reuters Bridge constructs requests for deal data and related conversation for each deal from the range and sends them to TOF server;
6. In case of successful requests processing, TOF server sends couple of messages which contain data about deal and related conversation.
7. For each found pair "deal/conversation" Reuters Bridge checks the deal type;
8. If the deal type is supported by Reuters Bridge, it performs conversion of linked TOF messages which contain "deal/conversation" data to FIX message Trade Capture Report (MsgType = ‘AE’) according to the mapping rules.
9.  In case converting is successful, Reuters Bridge sends FIX message Trade Capture Report (MsgType = ‘AE’) to FIX server.

Alternative scenarios:

Step 4, 6:

in case request processing failed, TOF server sends Status Response (407) message which is processed by Reuters Bridge in the following way:

• If Status = 96 (Connection Restored), Reuters Bridge writes corresponding INFO record to the log;
• If Status = 26 (Rejected, Try Again), Reuters Bridge writes corresponding WARNING record to the log and sends repeated request to TOF server;
• else Reuters Bridge writes corresponding ERROR record to the log.

Step 8:

In case defined deal type is not supported by Reuters Bridge, it writes corresponding record to the log, "deal/conversation" pair conversion is considered as completed.

Step 9:

In case conversion failed, Reuters Bridge writes corresponding record to the log, "deal/conversation" pair conversion is considered as completed.

Configuration

Common settings of the Reuters Bridge can be configured by means of the configuration file config.cfg. It allows to configure common properties of the application, TOF server's parameters, FIX server's parameters and logging parameters.

Table below represents all available configurable properties:

FIX level setting can be configured by means of fix.engine.properties file.

Reuters Bridge as a Windows Service 

Generally, for work with windows services the following commands are used:

If --name parameter is not specified, «ReutersBridge» will be used.

If --config parameter is not specified, «<path to the executable file>/config.cfg» will be used.

Note: If the application works as a service, paths in configuration files must be absolute.

Logging

All incoming and outgoing messages can be logged for furher analysis and troubleshooting.

• Tof-messages.in – logging incoming TOF messages in text file;
• SenderCompID-TargetCompID.in – logging incoming messages from FIX session in text file;
• SenderCompID-TargetCompID.out – logging outgoing messages from FIX session in text file;

Logging is configured by means of the configuration files config.cfg  and log4cxx.properties. Refer to article How to configure logging and logs rotation in Reuters Bridge for detailed instructions.

Error diagnosis by means of command line

Generally, error diagnosis is performed by means of application logs. However, sometimes (e.g. for the cases which can take place before logging subsystem initialization is done) it can be useful to run the application in command line mode.

To run the application in command line mode you need to:

1. Open Windows command line and go to application directory (e.g., cd c:\b2bits\ReutersBridge);
2. Run the application using the following command: ReutersBridge.exe --run console

Below is the list of console parameters: