Try TT Now

FIX Adapter Reference

Logon (A)

Purpose

Used to establish a connection between a FIX client and the TT FIX Adapter

Message Direction

From TT FIX Adapter to FIX client and from FIX client to TT FIX Adapter

Message Availability

Use CasePrice SessionOrder Session

Drop Copy

YesYes

Order Routing

YesYes

Supported Tags

Tag #Field NameReq’dComments
Component Block <Standard Header>Y35=A (MsgType)
96RawDataC

Logon password. The value must match the logon password for the FIX session. The TT FIX Adapter does not include this tag in its responses.

Data type: data

Condition: Required in FIX client requests.

98EncryptMethodY

Method of encryption. As the TT FIX Adapter does not support encrypted logons, you must set the value to 0 (None/Other).

Data type: int

108HeartBtIntY

Heartbeat interval.

Data type: int

141ResetSeqNumFlagN

Whether to reset the sequence numbers on both sides of the FIX session. Valid values include Y and N (default).

Data type: Boolean

Note: If the TT FIX Adapter configuration enables the Send Orders On Reset option and you set 141=Y, TT FIX Adapter sends an Execution Report (8) with Tag 150 (ExecType)=D for all working orders immediately after TT FIX Adapter sends the Logon (A) acknowledgment.

Enabling this configuration option performs the same function as requesting an order book download using an Order Status Request (H) message without Tag 11 (ClOrdID) and Tag 37 (OrderID).

For more information, see the TT FIX Adapter System Administration Manual.
Component Block <Standard Trailer>Y

Message Notes

The Logon (A) message is used by a FIX client to begin a new or continue an existing session with the TT FIX Adapter.

The following data flow illustrates a typical logon sequence between the TT FIX Adapter and FIX client for an order session:

  1. FIX client initiates a socket connection.
  2. FIX client sends a Logon (A) message to the TT FIX Adapter.
  3. The TT FIX Adapter receives the FIX client logon message and verifies the following tags in the Logon (A) message against the corresponding parameter values:
    • Tag 49 (SenderCompID) to RemoteCompId (in FACT)
    • Tag 56 (TargetCompID) to LocalCompId (in TT User Setup)
    • Tag 96 (RawData) to Password (in TT User Setup)
  4. If any of the following errors occur, the TT FIX Adapter stops processing the logon attempt, sends the FIX Client a Logout (5) message with the reason for rejection in Tag 58 (Text), and closes the socket connection.
    1. These tags do not match for the adapter and the client.
    2. TT User Setup does not respond.
    3. The TT universal login credentials (tags 49 and 96) are invalid.
  5. Examine the value of Tag 141 (ResetSeqNumFlag).

    If Tag 141 (ResetSeqNumFlag) is set to N, the TT FIX Adapter compares the value of Tag 34 (MsgSeqNum) in the Logon (A) message against its current sequence number.

    • If MsgSeqNum is less than the TT FIX Adapter’s expected sequence number, the TT FIX Adapter stops processing the logon attempt, sends a Logout (5) message as its response, and closes the socket connection.
    • If MsgSeqNum is greater than the TT FIX Adapter’s expected sequence number, the logon process continues normally. However, after the logon process completes, the TT FIX Adapter sends a Resend Request (2) message.

    If Tag 141 (ResetSeqNumFlag) is set to Y, the TT FIX Adapter expects the value of Tag 34 (MsgSeqNum) in the Logon (A) message to be 1.

    • If Tag 34 is not 1, TT FIX Adapter stops processing the logon attempt, sends a Logout (5) message, and closes the connection.
    • Otherwise, the logon process continues normally.
  6. TT FIX Adapter sends a Logon (A) message to the FIX client.

Related Information

Logout (5)

Resend Request (2)

Sequence Reset (4)

FIX Message Conversations, Logon and logout