OnixS C++ FIX Engine  3.24.0
API Documentation
Establishing FIX Connection

Establishing Connection

To establish a FIX connection as an Acceptor, the OnixS::FIX::Session::logonAsAcceptor method must be used.

To establish a FIX connection as an Initiator, the OnixS::FIX::Session::logonAsInitiator method must be used.

Closing Connection

To disconnect the session, the OnixS::FIX::Session::logout method must be used. This member implements a graceful closing of the FIX connection, as defined by the Standard.

Note
OnixS::FIX::Session::logonAsInitiator and OnixS::FIX::Session::logout methods are blocked until the Logon/Logout response is received. These methods have a timeout during which the response should be received. This timeout is equal to the heartbeat interval (by default 30 sec) + OnixS::FIX::EngineSettings::reasonableTransmissionTime value (by default 20%) as percentage from the heartbeat interval. If the acknowledgment Logon/Logout message is not received during the timeout then the Logout message will be sent and the FIX connection will be closed.

Connection and Session Lifetime

A single FIX session can exist across multiple sequential (not concurrent) physical connections. Parties can connect and disconnect multiple times while maintaining a single FIX session. That is, once the OnixS::FIX::Session::logout method is called, FIX Connection is terminated, however the FIX session life continues. It is possible to continue the same session later, using either OnixS::FIX::Session::logonAsAcceptor or OnixS::FIX::Session::logonAsInitiator methods again. In other words, FIX Session is comprised of one or more FIX connections.

Reconnection Facility

When a FIX session is in the active state and there are some network issues the FIX Engine will try to restore the FIX connection in accordance with OnixS::FIX::EngineSettings::reconnectAttempts and OnixS::FIX::EngineSettings::reconnectInterval settings.

Note
Reconnection facility works for already established FIX connections. In other cases, you need to use the Sessions Scheduler component or manually handle OnixS::FIX::LinkErrorException or OnixS::FIX::TimeoutException exceptions of OnixS::FIX::Session::logonAsInitiator method and try to connect again.

Example

using namespace OnixS::FIX;
using namespace OnixS::FIX::FIX40;
const string SENDER_COMP_ID = "SenderCompID";
const string TARGET_COMP_ID = "TargetCompID";
const string HOST = "Localhost";
// Target port is equal to acceptor's port to create a loop back FIX session.
int ACCEPTOR_PORT = Engine::instance()->listenPort();
Session acceptor(TARGET_COMP_ID, SENDER_COMP_ID, VERSION, &listener);
Session initiator(SENDER_COMP_ID, TARGET_COMP_ID, VERSION, &listener);
acceptor.logonAsAcceptor();
// Sends the Logon message and waits for the acknowledgment Logon.
initiator.logonAsInitiator(HOST, ACCEPTOR_PORT);
// Message exchanges and processing logic goes here..
// Sends the Logout message and waits for the confirming Logout.
acceptor.logout();
initiator.logout();
// Frees allocated resources.
initiator.shutdown();
acceptor.shutdown();