OSE Gateway Documentation
- OSE Gateway And The Exchange
- Installing And Upgrading
- Configuring Global Settings
- Configuring Market Data
Configuring The Order Server
- Understanding Order Management
- Order and Fill Server Files
- Configuring Order and Fill Server Connections
- Configuring Multi-Session and Multi-Member
- Configuring Order Management
- Supported Order Types
- Configuring Give Up Orders / Account Codes
- OSE Auto Give-up and Auto-allocation Order Processing
- HST Algorithm Flag Support
- OSE Gateway Recovery
- Configuration Parameters
- Configuration Parameters: Multi Member
If not using the default multicast group (220.127.116.11), manually change the multicast address to match the multicast of the environment in which the OSE Gateway resides.
- Modify the multicast in the ttmd.cfg file.
- Open the Aconfig Utility to modify the multicast in the
You can automatically change the multicast address by accessing the Daemon Setup within Guardian. However, the automatic process only works after Guardian runs.
You must configure and uncomment the Key Server section in the ttchron.ini file. If you choose to run a Key Server on this server, remove the hash symbols (#) from the following lines (including the section header):
You can only run a maximum of one Key Server per market; if another OSE Gateway is running a Key Server in this TT environment, do not uncomment the Key Server section.
You must add trader IDs to the TT User Setup Server (via TT User Setup located on a different machine within the TT environment) or to WUAS/Active Directory.
Be sure to follow the proper syntax for trader IDs as indicated in this document and configure each trader ID in the Exchange-Flavorhostinfo.cfg file.
Start TT Services
After reboot, open the Control Panel and select Administrative Tools. Within the Administrative Tools menu, select Services. Double-click on the Start Guardian icon from the desktop.
Verify that the IP address that this TT Gateway has been licensed for appears in the Applications On section of Guardian. Start the GuardServer service and ensure GuardServer shows up under the correct OSE Gateway Exchange-Flavor.
If the GuardServer shows up under the “TT GuardServers starting up” Exchange, it has not found a valid license.
Start the TTChron Service in order to start all necessary TT Services, (assuming you are starting the OSE Gateway during normal trading hours).
Execute Test Trade
Once the OSE Gateway is completely green in Guardian, log into an X_TRADER® machine and enter a test trade. Remember that necessary risk parameters must be set up in order to successfully place a trade.
The TT Gateway installation package distributed by TT includes an Exchange-provided login test tool utility: apitstlogin.exe. This utility installs in <root drive>:ttExchange-Flavor. You must run this executable from a command prompt.
To test API login:
- On the Start menu, point to Programs, and then click Command Prompt.
- Type: apitstlogin.exe UserName
Password Gateway Port
- UserName is the trader’s userID.
- Password is the trader’s password to connect to OSE.
- Gateway is the IP address of the OSE Gateway.
- Port is the port number of the OSE Gateway.
Example API Login Test
apitstlogin.exe TTO31P23 4cdt3 18.104.22.168 5001
Failed Connectivity Test
If the connectivity test fails, you will receive the following message: Error (-2012) Reason : system error occured on ‘connect’
If you receive this message, check the command line for incorrect typing. Alternatively, the Exchange host may be down or off-line.
Contact the Exchange if you are unable to perform a successful connectivity test.
Successful Connectivity Test
If the connectivity test is a success, you will receive the following response:
Example Successful Connectivity Test Response
C:ttOSE> apitstlogin.exe TTO31A23 4cdt3 22.214.171.124 5001
Logging in user.. Success
Getting user info.. Success
Country ID: SG
Getting facility id EP0.. Success
EP0 Facility 720
Logging out user..
Closing API session..
Once your connectivity test is successful, the UserName, Password, Gateway, and Port may be used in the Exchange-Flavorhostinfo.cfg as TTO, TTP, or TTF settings.