faq:logout [WIKI]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Logout ======
==== Session Termination ====

The Logout message requests or indicates the termination of a FIX session. The logout initiator should wait for a response and/or confirmation to the logout condition. This will permit the counterparty to gently close its connection and honor a potential message gap-fill.

If the T4 FIX API server initiates a Logout, an issuing physical disconnection will follow. When possible, the T4 FIX API will provide information on the nature or cause of the termination. If the client sends a Logout message, no more messages should be sent by the client.

Under normal operating conditions, the client requests a logout and the T4 FIX API server honors the request. A physical disconnection without an exchange of Logout messages is considered an abnormal condition.

==== Failed Authentication ====

To start a new FIX session, the T4 FIX API will need to reach successful authentication of the client's [[faq:logon|Logon]] message. To provide as much information as possible, a failed authentication is responded (by the T4 FIX API) with a Logout message.

A new FIX session (with sequence numbers reset to 1) will be required after the receipt of a Logout message and its subsequent physical disconnection.

==== Message Dictionary ====

^ Tag ^ Field Name ^ Req'd ^ Comments ^
| **Standard Header** | Y | MsgType = 5 |
| 58 | Text | N | Free format text string. Contains information related to the cause of the logout. |
| **Standard Trailer** | Y | |

==== Sample Message ====

Client request to logout:

<code>
34=2|49=CTS|56=T4Example|52=20120904-22:13:57.789|

[FIXLOGOUT]
[MsgSeqNum] 34 = 2
[SenderCompID] 49 = CTS
[TargetCompID] 56 = T4Example
[SendingTime] 52 = 20120904-22:13:57.789
</code>


Server Response:
<code>
34=2|49=T4Example|56=CTS|50=T4FIX|52=20120904-22:13:57.789|58=Successful logout upon request|

[FIXLOGOUT]
[MsgSeqNum] 34 = 2
[SenderCompID] 49 = T4Example
[TargetCompID] 56 = CTS
[SenderSubID] 50 = T4FIX
[SendingTime] 52 = 20120904-22:13:57.789
[Text] 58 = Successful logout upon request
</code>