TraderLogoutResponse
Logging out Traders
Under an established FIX Session, multiple traders/users can be authenticated with the Trader Logon message. Trader Logons allow order routing for multiple traders under the same physical connection of the FIX Session. Trader Logons must follow the successful FIX Logon of the initial Master User.
A trader that has been successfully authenticated with a Trader Logon can be logged out by the Master User with a Trader Logout message. The FIX API responds to Trader Logouts with the Trader Logout Response message.
Responding to Trader Logouts
The Trader Logout Response message identifies the trader (whose logout was attempted with a Trader Logout message) via the UserName tag (Tag 553). The success/failure result of the Trader Logout is carried in the Text tag (Tag 58).
| Tag Name | Tag Number | Description |
|---|---|---|
| UserName | 553 | T4 User |
| Text | 58 | T4 Description of Trader Logout result |
A successful attempt to log out a trader is acknowledged with a Trader Logout Response message that contains a Success description in the Text tag (Tag 58).
Failure to logout a trader will result in a failed Trader Logout Response message sent to the client. The message may contain a short description of the failure in Text (Tag 58).
A failed Trader Logout does not result in a physical disconnection. The FIX Session continues with the Master User and any other authenticated traders. The FIX Session is only terminated by a FIX Logout message.
Message Dictionary
| Tag | Field Name | Req'd | Comments |
|---|---|---|---|
| Standard Header | Y | MsgType = UCJ | |
| 49 | SenderCompID | Y | T4 App Name (inbound) / T4 Firm Name (outbound) |
| 56 | TargetCompID | Y | T4 Firm Name (inbound) / T4 App Name (outbound) |
| Body | Y | ||
| 553 | UserName | Y | T4 User to be logged out |
| 58 | Text | Y | Description of Trader Logout result |
| Standard Trailer | Y |
Sample
In this example, the T4 FIX API client initiates a FIX Session, enables Multi-Trader mode (Tag 372=UCG), and logs in with the Master User. A Trader Logon is used to authenticate a new trader. The client then sends a Trader Logout and finally a FIX Logout.
1 - LOGIN (in)
Login Request from T4 FIX API Client
34=1|49=T4Example|56=ctsdev|52=20160930-16:33:21.227|91=112A04B0-5AAF-42F4-994E-FA7CB959C60B|90=36|98=None|108=25|553=MasterUser|554=***|1407=58BD-B00F-5805-98AA-BD46-0417-C2B8-9C5F|384=1|372=UCG|
[MsgSeqNum] 34 = 1 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SendingTime] 52 = 20160930-16:33:21.227 [SecureData] 91 = 112A04B0-5AAF-42F4-994E-FA7CB959C60B [SecureDataLen] 90 = 36 [EncryptMethod] 98 = None [HeartBtInt] 108 = 25 [UserName] 553 = MasterUser [Password] 554 = *** [DefaultApplExtID] 1407 = 58BD-B00F-5805-98AA-BD46-0417-C2B8-9C5F [NoMsgTypes] 384 = 1 [RefMsgType] 372 = UCG (ENABLE_TRADER_LOGINS)
2 - LOGIN (out)
Successful Login Response from T4 FIX API
34=1|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:26.714|98=0|108=30|553=MasterUser|554=***|1408=4.3.62.0|
[MsgSeqNum] 34 = 1 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:26.714 [EncryptMethod] 98 = 0 (NONE) [HeartBtInt] 108 = 30 [UserName] 553 = MasterUser [Password] 554 = *** [DefaultCstmApplVerID] 1408 = 4.3.62.0
3 - TRADERLOGIN (in)
Trader Logon Request from T4 FIX API Client
34=2|49=T4Example|56=ctsdev|50=Trader1|52=20160930-16:33:41.989|91=112A04B0-5AAF-42F4-994E-FA7CB959C60B|90=36|109=CTS|553=Trader1|554=***|
[MsgSeqNum] 34 = 2 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SenderSubID] 50 = Trader1 [SendingTime] 52 = 20160930-16:33:41.989 [SecureData] 91 = 112A04B0-5AAF-42F4-994E-FA7CB959C60B [SecureDataLen] 90 = 36 [ClientID] 109 = CTS [UserName] 553 = Trader1 [Password] 554 = ***
4 - TRADERLOGINRESPONSE (out)
Successful Trader Logon Response
34=57|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:47.460|553=Trader1|58=Success|
[MsgSeqNum] 34 = 57 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:47.460 [UserName] 553 = Trader1 [Text] 58 = Success
5 - TRADERLOGOUT (in)
Trader Logout Request
34=3|49=T4Example|56=ctsdev|50=Trader1|52=20160930-16:33:44.181|109=CTS|553=Trader1|
[MsgSeqNum] 34 = 3 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SenderSubID] 50 = Trader1 [SendingTime] 52 = 20160930-16:33:44.181 [ClientID] 109 = CTS [UserName] 553 = Trader1
6 - TRADERLOGOUTRESPONSE (out)
Successful Trader Logout Response
34=58|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:49.605|553=Trader1|58=Success|
[MsgSeqNum] 34 = 58 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:49.605 [UserName] 553 = Trader1 [Text] 58 = Success
7 - LOGOUT (in)
Logout Request
34=4|49=T4Example|56=ctsdev|52=20160930-16:33:49.444|
[MsgSeqNum] 34 = 4 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SendingTime] 52 = 20160930-16:33:49.444
8 - LOGOUT (out)
Successful Logout Response
34=59|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:54.851|58=Successful logout upon request|
[MsgSeqNum] 34 = 59 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:54.851 [Text] 58 = Successful logout upon request