Guides through the most significant parts of the Handler's architecture.

Adjusting Handler Settings Describes primary aspects of configuring the Handler.
Controlling Handler Logging Provides information about logging.
Events in the Handler Provides information about event listeners.
Error Handling Provides information about error handling.
Warning Handling Provides information about warning handling.
Understanding Handler States Provides information about the Handler's states.
Message Identification Provides information about message identification.

All the Handler classes are encapsulated into the OnixS::Eurex::DropCopy namespace. Header files are collected in the master "OnixS/Eurex/DropCopy.h" header file.

How to get started

The typical way of using the Handler is as follows:

Create an instance of OnixS::Eurex::DropCopy::HandlerSettings class and adjust Handler settings.
Create an instance of OnixS::Eurex::DropCopy::Handler class using the previously initialized HandlerSettings instance.
Register error and warning listeners to be notified about failures.
Register session and order handling listeners.
Create an instance of OnixS::Eurex::DropCopy::Logon class and adjust session credentials.
Establish the connection using the OnixS::Eurex::DropCopy::Handler::connect method. This call blocks until the session logon completes and the handler transitions to the OnixS::Eurex::DropCopy::HandlerState::Connected state. After connect returns, wait for OnixS::Eurex::DropCopy::TradSesEvent::EndOfOrderBookSynch before treating received data as live — see Understanding Handler States for the full session lifecycle.
Receive order events via OnixS::Eurex::DropCopy::OrderHandlingListener callbacks until the session ends.
Terminate the connection using OnixS::Eurex::DropCopy::Handler::disconnect (blocking until the session is fully disconnected) or OnixS::Eurex::DropCopy::Handler::disconnectAsync (same logout sequence, non-blocking return). See Understanding Handler States for details.

Session Logon (Plain text password)

The Handler supports plain text password session logon. To use this feature:

Create an instance of OnixS::Eurex::DropCopy::Logon and adjust session settings.
Assign OnixS::Eurex::DropCopy::Logon::password with the plain text password.
Establish the connection using OnixS::Eurex::DropCopy::Handler::connect.

Please refer to the EDCI Manual §4.3.1 for details on the Session Logon message, including the Password field.