← Back to X_TRADER® Help Library

FIX Adapter System Administration Documentation

Starting TT FIX Adapter


This chapter explains how to start TT FIX Adapter and perform basic maintenance tasks.

Desktop icons

The TT FIX Adapter installation script creates the desktop icons shown in the following table. You use these icons to start various TT applications.

Icon Description

To start Guardian, double-click Start Guardian. When Guardian starts, TTM™ begins broadcasting across the network, and the TT Server Admin program can interact with the machine. For more information, refer to the TT Gateways SAM Version 7.X.

Use this icon to stop the TT Guardian™ program. Stopping Guardian does the following:

  • If the machine is a WAN Router, it stops the machine from WAN Routing. If this machine is currently a primary WAN Router, the network is disconnected.
  • Disconnects the machine from the TT system. TT Server Admin is not able to see the machine or collect log files. Client TT workstations are unable to connect to the TT Gateway.

TT Chron automates services and computer processes. Refer to the TT Gateways SAM Version 7.X for detailed information on how to use TT Chron.

To start TT Chron, double-click Start TT Chron. TT Chron starts all services scheduled to run in the <root drive>:ttconfigttchron.ini file. TT recommends that you use TT Chron to manage TT FIX Adapter run times including startup and shutdown

To start the TT FIX Adapter, double-click Name Adapter. You can edit this shortcut to include additional command line parameters.

Key Server requirements

To submit orders through the TT FIX Adapter, you must run at least one key server on a TT Gateway in your TT Trading System. If you do not run a key server, the TT FIX Adapter rejects all incoming orders. Additionally, if the FIX Adapter cannot assign a unique order key to an order (i.e., because the TT FIX Adapter disconnects from the key server), it rejects the order.

Command-line options

You can run TT FIX Adapter from any directory. You can use the command line options described in the following to customize how the TT FIX Adapter runs.

Note: When you run TT FIX Adapter in a command window, do not click in the command window. Doing so suspends the TT FIX Adapter process and can cause a connected client to lose its connection.

The FIXAdapter command uses the following syntax:

FIXAdapter.exe [-n name] [[-r [sessionName [SendSeqNumRcvSeqNum]]...]

Option Description

-n name

Sets the name that you want to assign a TT FIX Adapter for a particular run (session). You use this option to rename a TT FIX Adapter for as long as it runs, when the TT FIX Adapter stops, it reverts to its original name.






Performs the following actions:
  • Resets the message sequence numbers of the specified persistent FIX sessions to 1.
  • Purges all FIX session data for the specified persistent FIX sessions from the TT FIX Adapter cache.
  • If sessionName is not provided, also purges the local instrument definition cache. (This should not be done unless specifically instructed to do so by TT Support.)

Resetting the message sequence number does not purge the ID of a last fill sent to each FIX client.

The sessionName value has the form, LocalCompId-RemoteCompId. You can also supply a wildcard (*) for either or both CompIds to match any values. You can optionally supply new sequence numbers for the incoming and outgoing counters (SendSeqNum and RcvSeqNum). To leave a value unchanged, supply -1.

You must specify sequence numbers separately for each session name. If you provide multiple session names and omit numbers, the command uses default values for the preceding session name. For example:

  • -r FA-Bob 10 15 FA-Sue 20 20 resets the sessions with the specified sequence numbers
  • -r FA-Bob 10 15 FA-Sue resets FA-Bob with sequence numbers 10 and 15, but resets FA-Sue with sequence numbers 1 and 1 (default values)
  • -r FA-Bob FA-Sue 20 20 resets FA-Bob with sequence numbers 1 and 1 (default values) and FA-Sue with sequence numbers 20 and 20

Additionally, do not use special characters, such as commas or semi-colons, for different session parameters.

After resetting the sessions, the command terminates FIX Adapter.