Try TT Now

hostinfo.cfg: Multi-Member

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 levels of logging and heartbeating for the TOCOM Gateway.
  • [TTP]: Sets the connectivity, user ID, and password for the Price Server.
  • [MEMBER_<CUST1>]: Sets the exchange connectivity for the Order Server and Member ID for order routing.
  • [MEMBER_<CUST1>_TTF]: Sets the user ID and password for the Fill Session.
  • [MEMBER_<CUST1>_TTO_#]: Sets the user ID and password for each Order Session.
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.

The following lists shows the parameters removed in 7.17 and describes the default gateway behavior.

  • ResubmitOnSessionDown=1 When removed, the gateway behaves as if orders inactivated by the exchange due to a session loss will be on hold.
  • ResubmitOnStartup=1 - When removed, the gateway behaves as if orders inactivated by the exchange will be left on hold during initialization.
  • ForceAutoAggress=1 - By default, the gateway sets as passive or aggressive based on how the order was placed by the client trading application.

Example hostinfo.cfg: 7.17 and Higher

The default TOCOM hostinfo.cfg file supports multiple members and 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]

# Configure any global parameters here.

## PRICE SERVER CONFIGURATION ##

[TTP]

AccessIP=10.37.253.2

AccessPort=12345

AccessIPSecondary=10.37.253.3

AccessPortSecondary=67890

UserId=TTORHL80

UserPassword=12345678

## ORDER SERVER CONFIGURATION ##

[MEMBER_CUST1]

Member=MBR1

AccessIP=10.1.2.3

AccessPort=1234

AccessIPSecondary=10.2.3.4

AccessPortSecondary=2345

[MEMBER_CUST1_TTF]

UserID=TTORHL82

UserPassword=12345678

[MEMBER_CUST1_TTO_1]

UserID=TTORHL82

UserPassword=12345678

[MEMBER_CUST1_TTO_2]

UserId=TTORHL83

UserPassword=12345678

# [MEMBER_CUST2]

# Member=MBR2

# [MEMBER_CUST2_TTF]

# UserId=xxxx

# UserPassword=xxxx

# AccessIP=x.x.x.x

# AccessPort=xxxxx

# AccessIPSecondary=x.x.x.x

# AccessPortSecondary=xxxxx

# [MEMBER_CUST2_TTO_1]

# UserId=xxxx

# UserPassword=xxxx

# AccessIP=x.x.x.x# AccessPort=xxxxx# AccessIPSecondary=x.x.x.x# AccessPortSecondary=xxxxx# [MEMBER_CUST2_TTO_2]# UserId=xxxx# UserPassword=xxxx# AccessIP=x.x.x.x# AccessPort=xxxxx# AccessIPSecondary=x.x.x.x# AccessPortSecondary=xxxxx

Section: [Global]

Example

[Global]

# Configure any global parameters here.

The [Global] section of the hostinfo.cfg includes hidden parameters that should not be configured unless you first contact your TAM or TT Support.

The following list shows the default value and behavior of the hidden parameters in this section for 7.17:

  • PollingInverval - By default, the gateway waits the following time before requesting new data from the Exchange after receiving a “no new broadcast” message: BTEC=Not applicable, OSE=Not Present, SGX=20 milliseconds, TOCOM=20 milliseconds
  • HeartbeatInterval - The maximum amount of time, in seconds, between heartbeats before the Exchange logs out the order session: BTEC=8 seconds, OSE=Not Present, SGX=5 seconds, TOCOM=5 seconds
  • LogLevel - OM Gateways behave as if set to “Normal” (logs important and normal messages).

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

AccessIP

Identifies the IP address the Gateway uses to connect with the exchange for market data. This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured in the TTP section.

AccessPort

Identifies the port the Gateway uses to connect with the exchange for market data.

This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured in the TTP section.

AccessIPSecondary

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

This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured in the TTP section.

AccessPortSecondary

Identifies the secondary port the Gateway uses to connect with the exchange if the primary port for market data fails to connect. This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured in the TTP section.

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: [MEMBER_<CUST1>]

You must configure the [MEMBER_<CUST1>] section of the hostinfo.cfg file to set the Exchange Member’s connectivity to the exchange host for order and fill sessions. When configuring multiple Exchange Members on the gateway for routing orders and fills, add a unique [MEMBER_<CUST1>] section per Member.

This section contains the following parameters:

[Member_<User>] Parameter Descriptions

Parameter

Description

[Member_<CUST1>]

Sets the section name. This section includes the Member’s user-defined trader ID, as well as the exchange-provided IP Address and port connections to the exchange for the Member’s order sessions. The gateway identifies order and fill connections for each member configured with the same <CUST1> variable in the section name. The “Member_” portion of the section name is required, but the <CUST1> parameter can be user-defined (e.g., [Member_BrokerB]) or used with the default value CUST1. This is a required parameter.

Member

Defines the Exchange Member routing orders through the gateway. This parameter is user-defined and must match the Member value (the “M” of the MGT gateway login) set in TT User Setup for the Exchange Member. Each Member parameter configured on the TT Gateway must be unique. This is a required parameter.

Warning

The Order Server shuts down if the same Member parameter is configured more than once in hostinfo.cfg.

AccessIP

Identifies the IP address the Gateway uses to connect with the exchange. This credential is provided by the exchange. The IP Address configured in this section provides connectivity for the order [TTO_#] and fill [TTF] sessions configured for the Exchange Member.

AccessPort

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

This credential is provided by the exchange. The port configured in this section provides connectivity for the order [TTO_#] and fill [TTF] sessions configured for the Exchange Member.

AccessIPSecondary

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

This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured per member and is optional.

AccessPortSecondary

Identifies the secondary port the Gateway uses to connect with the exchange if the primary port fails to connect. This credential is provided by the exchange. For 7.17 and later versions, this parameter is configured per member and is optional.

Section: [MEMBER_<CUST1>_TTF]

You must configure the [MEMBER_<CUST1>_TTF] section of the hostinfo.cfg file to set the user ID and password for the Member to connect to the exchange via a fills session.

When using a single Order Session, the TT Gateway routes all order and fill data through the [TTF] session. In this scenario, only the [TTF] section of the hostinfo.cfg file is configured, and the Exchange Member’s [TTO_1] sections is commented-out.

Tip

By default, TOCOM Gateways use the TTF Order Session to process both order and fill data. During heavy trading, this limits the performance of the 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

[Member_<CUST1>_TTF]

Sets the section name. This section includes the Member’s exchange-provided User ID and password for connecting to the exchange for fills. The gateway identifies order and fill connections for each member configured with the same <CUST1> variable in the section name. The “Member_” portion of the section name is required, but the <CUST1> parameter can be user-defined (e.g., [Member_BrokerB_TTF]) or used with the default value (CUST1). This is a required parameter.

UserId

Sets the user ID for orders and fills. Enter the user ID provided by the exchange.

UserPassword

Sets the password for the Order Server connection. Use the password provided by the exchange.

AccessIP

Identifies the IP address the Gateway uses to connect with the exchange. This is optional if you want to override the IP Address configured in the [Member_<CUST1>] section.

AccessPort

Identifies the port the Gateway uses to connect with the exchange. This is optional if you want to override the port configured in the [Member_<CUST1>] section.

AccessIPSecondary

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

This is optional if you want to override the secondary IP Address configured in the [Member_<CUST1>] section.

AccessPortSecondary

Identifies the secondary port the Gateway uses to connect with the exchange if the primary port fails to connect. This is optional if you want to override the secondary port configured in the [Member_<CUST1>] section.

Section: [MEMBER_<CUST1>_TTO_#]

The [TTO_#] section sets the user IDs and passwords for each Member’s Order Sessions. The gateway selects an order session using a round-robin algorithm based on messaging volume. For example, if the transaction per second (TPS) is lower on TTO_2 than it is on TTO_1, the gateway will select TTO_1 to route the order.

If you use more than two Order Session IDs, you must add and configure [MEMBER_<CUST1>_TTO_#] sections for each additional session. OM Gateways 7.17 and later versions can be configured with as many as 200 [TTO_#] sessions with 25 sessions and 1 fill session [*TTF_#] per Member.

Warning

Prior to reconfiguring Login User IDs on the TT TOCOM Gateway (e.g., removing or adding [MEMBER_<CUST1>_TTO_#]sections) customers must cancel all working orders at the Exchange. If an order was originally submitted through a [MEMBER_<CUST1>_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

[MEMBER_<CUST1>_TTO_#]

Sets the section name. This section includes the Member’s exchange-provided User ID and password for connecting to the exchange for fills. The gateway identifies order and fill connections for each member configured with the same <CUST1> variable in the section name. The “Member_” portion of the section name is required, but the <CUST1> parameter can be user-defined (e.g., Member_BrokerB_TTO_1]) or used with the default value (CUST1). This is a required parameter.

In the first [MEMBER_<CUST1>_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. Enter the password provided by the exchange.

AccessIP

Identifies the IP address the Gateway uses to connect with the exchange. This is optional if you want to override the IP Address configured in the [Member_<CUST1>] section.

AccessPort

Identifies the port the Gateway uses to connect with the exchange. This is optional if you want to override the port configured in the [Member_<CUST1>] section.

AccessIPSecondary

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

This is optional if you want to override the secondary IP Address configured in the [Member_<CUST1>] section.

AccessPortSecondary

Identifies the secondary port the Gateway uses to connect with the exchange if the primary port fails to connect. This is optional if you want to override the secondary port configured in the [Member_<CUST1>] section.