Try TT Now

hostinfo.cfg

Overview

You configure the Price and Order Server connections in hostinfo.cfg, as well as general TT Gateway behavior. If you do not configure this file properly, the TT LME Gateway does not function correctly.

You configure hostinfo.cfg immediately after installing the TT LME Gateway, and again later, when you must make changes to network connectivity. The hostinfo.cfg has the following sections:

  • [OrderServer]: Defines the FIX Order Server Sessions used by the TT LME Gateway.
  • [OrderServerSession]: Configures the FIX Order Server connection to LME.
  • [PriceServer]: Configures the Price Server connection to LME.

Section: [OrderServer]

Example [OrderServer] section in the hostinfo.cfg file

[OrderServer]

HeartbeatInterval=30

ReconnectInterval=10

MaxReconnectAttempts=-1

The [OrderServer] section of the hostinfo.cfg defines the FIX Order Sessions used by the TT LME Gateway. The [OrderServer] section contains the following parameters:

[OrderServer] parameters

Parameter

Description

[OrderServer]

This is the section name. Do not change it.

HeartbeatIntervalSets the frequency, in seconds, that the Order Server sends a heartbeat to the exchange and expects Heartbeats from the exchange. HeartbeatInterval is established as part of Logon. In order to maintain a connection, the Order Server must send and receive a heartbeat to and from the exchange at the HeartbeatInterval specified. Setting HeartbeatInterval to a value less than 1 will result in the parameter using the default value.

By default, TT LME Gateway 7.15 and lower installs with this parameter set to 30.

Warning

You should contact your local TAM before configuring this parameter on TT LME Gateways 7.15 and lower. The exchange may disconnect the Order Server session if the value of HeartbeatInterval is less than the time it takes for the exchange to send the entire order execution report. Your TAM may recommend increasing the HeartbeatInterval if the Order Server experiences multiple disconnects and appears unable to reach an Active Trading State.

ReconnectInterval

Sets the amount of time, in seconds, that the Order Server waits before attempting to reconnect to the exchange.

By default, TT LME Gateways install with this parameter set to 10.

MaxReconnectAttempts

Sets the number of concurrent FIX logon attempts made by the Gateway. If the Gateway is rejected after the specified number of attempts, it will shut down.

By default, TT LME Gateways install with this parameter set to -1, meaning infinite reconnection attempts.

Section: [dns]

Example [dns] section in the hostinfo.cfg file

[dns]

resolver=10.2.3.4

The [dns] section of the hostinfo.cfg defines DNS resolver address the LME Gateway connects to. The [dns] section contains the following parameters:

[OrderServer] parameters

Parameter

Description

[dns]

This is the section name. Do not change it.

resolverSupplies the DNS resolver address used by the LME Gateway. If this parameter is used, the ExchangeIP parameter in the [OrderServerSession_#] section must be a Fully Qualified Domain Name (FQDN). If the resolver parameter is commented out, the ExchangeIP and ExchangePort parameters are used.
Note

When configuring multiple sessions, you must either use this parameter or the ExchangeIP and ExchangePort parameters. If a DNS resolver is listed, the ExchangeIP parameter will always be treated as a FQDN, and DNS will be used for all sessions.

Section: [OrderServerSession]

Example [OrderServerSession_#] section in the hostinfo.cfg file

[OrderServerSession_1]

ExchangeIP=10.1.2.3

ExchangePort=1234

GatewayCompany=GDT

Member=LDBFEAC

ExchangeCompany=LME

SessionPassword=HtC3

FAXKey=BE4E7F78D098FCB753265768646997096E029641D00EEC6AE076E934C6BA7907

The [OrderServerSession] section configures the connection information for the FIX order session. The following table lists this section’s parameters and descriptions:

[OrderServerSession] section parameters

Parameter

Description

[OrderServerSession_#]

This is the user-defined section heading. By default, installation sets this to [OrderServerSession_1].

ExchangeIP

Sets the IP address that the TT LME Gateway uses to establish connectivity to the Exchange.

ExchangePort

Sets the port that the TT LME Gateway uses to establish connectivity to the Exchange.

GatewayCompany

Identifies the name of the firm that connects to the exchange for order data and is supplied by LME. A unique GatewayCompany value is required for each order session.This field supplies the value of the FIX tag 49 (SenderCompID) in all outbound messages for that connection.

Member

Identifies the client’s Member login. This seven-character maximum variable must match the Member portion of the MemberGroupTrader ID defined in TT User Setup. The Member ID is not provided by the exchange. The value must be different from GatewayCompany and unique across all order sessions or else the Order Server will not start.

Note

If there is a duplicate Member parameter configured on a multi-session TT LME Gateway, the Order Server will not start. This value must be unique per [OrderServerSession_#].

ExchangeCompany

Identifies the name of the exchange host that sends messages to the TT LME Gateway. This field supplies the value of the FIX tag 56 (TargetCompID) in all inbound messages to the TT LME Gateway.

SessionPassword

Sets the password the Order Server uses to connect to the exchange for order data. This is assigned by the exchange. This field supplies the value of FIX tag 96 (Raw Data) in the Session Startup request message sent to the exchange.

FAXKey

Identifies the exchange-assigned key used to encrypt the SessionPassword.

For more information on multiple Order Sessions, refer to Configuring Multi-Member/ Multi-Session.

Configuring Multiple Order Sessions

Example hostinfo.cfg file configured with two order sessions

[OrderServerSession_1]

ExchangeIP=10.1.2.3

ExchangePort=1234

GatewayCompany=GDT

Member=LDBFEAC

ExchangeCompany=LME

SessionPassword=HtC3

FAXKey=BE4E7F78D098FCB753265768646997096E029641D00EEC6AE076E934C6BA7907

[OrderServerSession_2]

ExchangeIP=10.1.2.3

ExchangePort=1235

GatewayCompany=CST

Member=PDXFEAC

ExchangeCompany=LME

SessionPassword=HtC9

FAXKey=ZA3D7G98F154JCB765487698773987009F738508F11FFC9BD05E847D6DC8707

You can configure multiple order sessions using the procedure listed below.

To configure additional order sessions:

  1. Open the hostinfo.cfg file.
  2. Copy the heading and required parameters from the [OrderServerSession_1].
  3. Paste the copied text into the hostinfo.cfg file.
  4. Change the second [OrderServerSession_#] heading to a unique name (e.g., [OrderServerSession_2] or [OrderServerSession_3].
    Note

    Each [OrderServerSession_#] must have a unique GatewayCompany and Member value. Values for SessionPassword and FAXKey may also need to be changed.

  5. Save and close the hostinfo.cfg.

Section: [PriceServer]

Example [PriceServer] section in the hostinfo.cfg file

[PriceServer]

ExchangeIP=10.1.1.1

ExchangePort=1001

ReconnectionInterval=35

GatewayCompany=GDT

HeartbeatInterval=30

ExchangeCompany=LME

SessionPassword=HtCP3

FAXKey=BE4E7F78D098FCB753265768646997096E029641D00EEC6AE076E934C6BA7907

The [PriceServer] section contains Price Server configurations for connecting to TT LME Gateway.

The [PriceServer] section contains the following parameters:

[PriceServer] section parameters

Parameter

Description

[PriceServer]

This is the user-defined section heading.

ExchangeIP

Sets the IP address that the TT LME Gateway uses to establish connectivity to the Exchange. The Exchange assigns this value.

ExchangePort

Sets the port that the TT LME Gateway uses to establish connectivity to the Exchange. The Exchange assigns this value.

ReconnectionInterval

Sets the amount of time, in seconds, that the Price Server waits before attempting to reconnect to the exchange.

By default, TT LME Gateways install with this parameter set to 35.

Note

The default setting of 35 is the minimum exchange-recommended value. Setting ReconnectionInterval to a value that is less than 35 can result in unsuccessful logins.

GatewayCompany

Identifies the name of the firm that connects to the exchange for order data and is supplied by LME. A unique GatewayCompany value is required for each price session.This field supplies the value of the Tag 49 (SenderCompID) in all outbound messages for that connection.

HeartbeatInterval

Sets the frequency, in seconds, that the Price Server sends a heartbeat to the exchange and expects Heartbeats from the exchange. In order to maintain a connection, the Price Server must send and receive a heartbeat to and from the exchange at the HeartbeatInterval specified. Setting HeartbeatInterval to a value less than 1 will result in the parameter being set to the default value.By default, TT LME Gateways install with this parameter set to 30.

Warning

The Price Server may be disconnected by the exchange if the value of HeartbeatInterval is set to a value below the default.

ExchangeCompany

Sets the name of the exchange host that sends messages to the TT LME Gateway. This field supplies the value of the Tag 56 (TargetCompID) in all inbound messages to the TT LME Gateway.

SessionPassword

Sets the password the Price Server uses to connect to the exchange for price data. This is assigned by the exchange.This field supplies the value of Tag 96 (Raw Data) in the Session Startup request message sent to the exchange.

FAXKey

Identifies the exchange-assigned key used to encrypt the SessionPassword.

RequestProdDefsOnDisconnect

Determines if the Price Server will re-download products/contracts upon disconnect from the exchange.The available settings for this parameter are:

  • Y: re-downloads products/contracts upon disconnect
  • N: does not re-download products/contracts upon disconnect
Note

The Price Server will always re-download products/contracts after a disconnection if any of the products/contracts were missing when the Price Server went active.

LogFixMessagesToDisk

Sets the logging of all FIX messages to FIX message cache on disk. The available settings for this parameter are:

  • Y: logs all FIX messages to disk
  • N: does not log FIX messages to disk

By default, this parameter is not present and the Gateway behaves as if N. Setting this parameter to Y may negatively impact performance on the Price Feed.

ProductsDownloadTimer

Specifies the amount of time, in seconds, the Price Server must wait before going active, regardless of whether or not all Security List definitions have been received. The Price Server always becomes active after all Security List definitions are received, even if that occurs before the number of seconds specified in ProductsDownloadTimer have elapsed. The Price Server will log out and then log in again for a maximum of three attempts if the following criteria are met:

  • The ProductsDownloadTimer is expired
  • No Security List messages have been received from the exchange

If the Price Server reaches the maximum login attempts and no Security List messages have been received, it will shut down.

By default, this parameter is not present and the Gateway behaves as if ProductsDownloadTimer=10.

SecurityListDownloadDelay

Specifies the amount of time, in seconds, the Price Server waits between receiving the logon message from the Exchange and sending the first Security List request. Available values for this parameter are between 0 and 120. If this parameter is missing or invalid, the Gateway behaves as if SecurityListDownloadDelay=5.

By default, this parameter is not present and the Gateway behaves as if SecurityListDownloadDelay=5.

TcpWindowSize

Sets the receive buffer size, in KB, for the TT LME Gateway. For assistance with setting TcpWindowSize, please contact your TAM. Your TAM will determine the appropriate TCP window size using the following formula: TCP window size = (Bandwidth of the link in bps) * (round trip time in seconds) / 8192. This parameter must be set to a whole number.By default, this parameter is not present and the Gateway behaves as if TcpWindowSize=64.