Try TT Now

hostinfo.cfg

Overview

Configure the Price and Order Server connections, as well as general TT Gateway behavior, in the hostinfo.cfg file. If you do not configure this file properly, the TOCOM Gateway will not function properly.

Configure hostinfo.cfg immediately after installing the TOCOM Gateway, and again later when making changes to network connectivity. The hostinfo.cfg has the following sections:

  • [Global]: Configures connection information, levels of logging and heartbeating for the TOCOM Gateway.
  • [Priceserver]: Sets the ITCH multicast product group (7.18 or higher)
  • [TTP]: Sets the user ID and password for the Price Server.
  • [TTF]: Sets the user ID and password for the Order Server.
  • [TTO_#]: Sets the user ID and passwords for additional Order Sessions.
Note

When updating the hostinfo.cfg file, you must restart the TOCOM Gateway in order for the changes to take effect.

Warning

Prior to reconfiguring Login User IDs on the TOCOM Gateway (e.g., removing [TTO_#] or [TTF] sections) customers must cancel all working orders at the Exchange. If an order was originally submitted through a [TTO_#] or [TTF] section that has since been commented out or removed, and the order is not canceled, it may be filtered out during initialization and ignored by the Gateway.

Example hostinfo.cfg File

The default TOCOMhostinfo.cfg file contains values that begin with the '#' character. You must replace values beginning with the '#' with the correct values prior to staring the Price Server.

Example

[GLOBAL]

AccessIP=10.1.2.3

AccessPort=1234

#AccessIPSecondary=10.2.3.4

#AccessPortSecondary=2345

LogLevel=Normal

HeartbeatInterval=5

PollingInterval=20

[PriceServer]

MulticastGroup=TOCOM-1

[TTP]

UserID=MFTTRHL82

UserPassword=12345678

[TTF]

UserID=TTORHL82

UserPassword=12345678

[TTO_1]

UserID=TTORHL82

UserPassword=12345678

[Traders]

TTORD;TTT;001

Section: [Global]

Example

[Global]

AccessIP=10.1.2.3

AccessPort=1234

#AccessIPSecondary=10.2.3.4

#AccessPortSecondary=2345

LogLevel=Normal

HeartbeatInterval=5

PollingInterval=20

The [Global] section of the hostinfo.cfg configures connection information, levels of logging, and heartbeating for the TT TOCOM Gateway.

The [Global] section contains the following parameters:

[Global] Parameter Descriptions

Parameter

Description

AccessIP

Identifies the IP address the Gateway uses to connect with the exchange.

AccessPort

Identifies the port the Gateway uses to connect with the exchange.

AccessIPSecondary

Identifies the secondary IP address the Gateway uses to connect with the exchange if the primary IP address fails to connect.

AccessPortSecondary

Identifies the secondary port the Gateway uses to connect with the exchange if the primary port fails to connect.

LogLevel

Sets the level of detail the TT TOCOM Gateway provides to its log files. This parameters has three available settings and are listed from the least detailed to the most:

  • Low: This level is the least verbose and logs only required and important messages.
  • Normal: This level logs important and normal messages.
  • Verbose: This level logs all messages.

By default, TOCOM Gateways install with logging level set to Normal.

HeartbeatInterval

Sets the maximum amount of time, in seconds, between heartbeats before the exchange logs out the Order Server (TTO) connection.

To maintain connectivity, the TOCOM Gateway sends heartbeats to the exchange at regular intervals.

By default, the value is set to 5.

Warning

Setting this value higher than 5 is not recommended and may cause buffer overflow errors.

PollingInterval

Sets the length of time, in N milliseconds, the Gateway waits before requesting new data from the exchange after receiving a “no new broadcast” message. The TT Gateway consistently requests data from the exchange. If the exchange responds with new data, the Gateway continues to request and receive updates. However, if the exchange sends a message showing that there is no new data available, the Gateway will wait N milliseconds before sending a new request.

Due to the variety of available network configurations, TT cannot recommend setting PollingInterval equal to any one particular value. Therefore, TT recommends leaving this parameter set to its default value.

By default, this parameter is set to 50. TT recommends referencing the hostinfo.cfg_master file for the appropriate default value.

If the parameter is missing or contains an invalid value, the Gateway behaves as if set to 1.

The following considerations can assist your TAM in changing this parameter, if needed. Only change this parameter if told to do so by a TAM or TT personnel.

Setting to a low value (i.e., 50 milliseconds or less), can result in loss of data and disconnection caused by a buffer overflow on the Exchange end.

Setting to a higher value (i.e., 50 milliseconds or more) can result in latency issues caused by the Order Server polling the Exchange interface too aggressively.

Warning

Do not alter this parameter unless told by a member of TT to do so.

Section: [PriceServer]

This section configures the Price Server to subscribe to the real time price data on the ITCH API price feed. The TOCOM Gateway only uses one [PriceServer] section.

This section contains the following parameters:

[PriceServer] section parameters

Parameter

Description

MulticastGroup=<TOCOM_group_number>

Sets the multicast group(s) for real time price and market data subscriptions (e.g, MulticastGroup=TOCOM-1). All available multicast groups in hostinfo.cfg are enabled by default.

NetworkInterface=x.x.x.x

Unless your Primary NIC is in the exchange network, uncomment (remove the #) for this parameter and enter the NIC IP address.

Section: [TTP]

This section sets the user ID and password for the Price Server. The TOCOM Gateway uses only one [TTP] section.

This section contains the following parameters:

[TTP] Parameter Descriptions

Parameter

Description

UserId

Sets the exchange-assigned user ID for the Price Server connection. This value must be different across each TT TOCOM Gateway.

UserPassword

Sets the exchange-assigned password for the Price Server connection.

Section: [TTF]

You must configure the [TTF] section of the hostinfo.cfg file to set the user ID and password for the Order Server, which connects to the Exchange via the Order Session.

When using a single Order Session, the TT TOCOM Gateway routes all order and fill data through the [TTF] session. In this scenario, only the [TTF] section of the hostinfo.cfg file contains connection information. The [TTO_1] section should remain commented-out and the TT TOCOM Gateway ignores this information.

Tip

By default, TT TOCOM Gateways use the TTF Order Session to process both order and fill data. During heavy trading, this limits the performance of the TT TOCOM Gateway. To improve performance, TT recommends using multiple Order Sessions. Even adding one TTO Order Session shows a significant improvement over a single TTF Order Session and no TTO Order Sessions. Please contact the Exchange for information on obtaining additional Login User IDs.

This section contains the following parameters:

[TTF] Parameter Descriptions

Parameter

Description

UserId

Sets the user ID for orders and fills.

UserPassword

Sets the password for the order server connection.

Section: [TTO_#]

The [TTO_#] section sets the user IDs and passwords for additional Order Sessions. By default, TOCOM Gateways install with this section commented-out.

If you only use one Order Session, do not uncomment and configure [TTO_#] sections in the hostinfo.cfg file. You should only configure the default [TTF] section. If you use two Order Session IDs, you must uncomment and configure the [TTO_#] section for the second session. If you use more than two Order Session IDs, you must add and configure [TTO_#] sections for each additional one. TT TOCOM Gateways can be configured with as many as 50 [TTO_#] sessions. Per TOCOM restrictions, only 50 users may be logged in per Network Gateway.

Warning

Prior to reconfiguring Login User IDs on the TT TOCOM Gateway (e.g., removing or adding [TTO_#] sections) customers must cancel all working orders at the Exchange. If an order was originally submitted through a [TTO_#] section that has since been commented out or removed, and the order is not canceled, it may be filtered out during initialization and ignored by the Gateway.

This section contains the following parameters:

[TTO_#] Parameter Descriptions

Parameter

Description

[TTO_#]

Section name. In the first [TTO_#] section, # is 1. For every [TTO_#] section after the first, you must increment this number by one.

UserId

This value is assigned by the exchange and must be unique across each TOCOM Gateway.

UserPassword

Sets the password for this session.

Section: [Traders] - 7.15.X and below

In TOCOM Gateways 7.16.0 and later, the [Traders] section is no longer used.

If this section is still present in the hostinfo.cfg file, it will be ignored.

In TOCOM Gateways 7.15.X and below, the TOCOM Gateway uses this section to identify and map direct traders. You must configure each set of trader ID data on a unique line.

Note

You must list all traders in the [Traders] section of the hostinfo.cfg file. If the trader is not listed, they will not be able to submit orders.

[Traders] Parameter Descriptions

Parameter

Description

Member;Group;Trader

For each trader, users must define the Member, Group, and Trader. Trader IDs must be unique across each TOCOM Gateway in the same environment.