Engine Initialization and Shutdown

Initializing the Engine

To initialize the Engine services, the OnixS::FIX::Engine::init method must be used. configFile parameter points to the Engine's configuration file. This method must be called before all other methods.

Shutting down the Engine

To shutdown the Engine, the OnixS::FIX::Engine::shutdown method must be used.

Note

No other members of any class from C++ FIX Engine, public API as well as instances by themselves, must be called after this method.

Shutting down the whole Application

The good practice is to shut down the whole application in the following order:

• OnixS::FIX::Session::shutdown all sessions.
• Unregister the OnixS::FIX::IEngineListener listener.
• OnixS::FIX::Engine::shutdown the FIX Engine.
• Shut down all reactors if they exist (please see ExternalThread Mode).
• Close the application.

The following example demonstrates the Engine's initialization and shutdown:

Example

    using namespace OnixS::FIX;

    try
    {
        // Initialization phase.
        Engine::init();

        // Session-related logic goes here.

        // Shutdown phase.
        // Shut down all sessions.
        Engine::instance()->unregisterListener();
        Engine::shutdown();
        // Shut down all reactors if they exist.
    }
    catch(const Exception& ex)
    {
        std::cout << "Exception: " << ex.what() << std::endl;
    }