Inner Contents
	Adjusting Handler Settings

	Controlling Handler Logging

	Error Handling

	Events in the Handler

	Message Identification

	Trading

	Warning Handling

Detailed Description

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

How to get started

The typical way of using the Handler is as follows:

Create an instance of OnixS::Eurex::Trading::HandlerSettings class and adjust Handler's settings.
Create an instance of OnixS::Eurex::Trading::Handler class using previously initialized instance of OnixS::Eurex::Trading::HandlerSettings.
Register error and warning listener to be notified about failures occurred while the Handler processes market data.
Register listeners for miscellaneous trading events.
Create an instance of OnixS::Eurex::Trading::Logon class and adjust session settings.
Assign OnixS::Eurex::Trading::Logon::encryptedPassword field with encrypted password to use password encrypted session logon. Otherwise, assign OnixS::Eurex::Trading::Logon::password field with plain text password.
Establish the connection using the OnixS::Eurex::Trading::Handler::connect method.
Create an instance of OnixS::Eurex::Trading::UserLoginRequest class and adjust user logon settings.
Send user login request using OnixS::Eurex::Trading::Handler::send method.
Start sending messages.
Create an instance of OnixS::Eurex::Trading::UserLogoutRequest class and adjust user logout settings.
Send user logout request using OnixS::Eurex::Trading::Handler::send method.
Terminate the connection to Eurex ETI using the OnixS::Eurex::Trading::Handler::disconnect method.

Session Logon (FIX Engine fields)

For FIX Engine fields in OnixS::Eurex::Trading::Logon class it is allowed to use the following values:

 logon.fixEngineName = "OnixS Eurex ETI Handler";
 logon.fixEngineVersion = Handler::version();
 logon.fixEngineVendor = "Onix Solutions Ltd.";

But users may not use these values and use their own values instead.

Session Logon (Application fields)

For application fields in OnixS::Eurex::Trading::Logon class users must use their own values that represent their application. For example:

 logon.applicationSystemName = "My Application";
 logon.applicationSystemVersion = "1.0.0";
 logon.applicationSystemVendor = "My Company";

Session Logon (Plain text password)

The Handler supports plain test password session logon. To use this feature, the following steps should be performed:

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

Session Logon (Password encrypted)

The Handler supports password encrypted session logon. To use this feature, the following steps should be performed:

Create an instance of OnixS::Eurex::Trading::Logon class and adjust session settings.
Encrypt password using OnixS::Eurex::Trading::Handler::encryptPassword method.
Assign OnixS::Eurex::Trading::Logon::encryptedPassword field with encrypted password.
Establish the connection using the OnixS::Eurex::Trading::Handler::connect method.

To encrypt a password you will need an RSA public key. You can find these keys for Production and Simulation in the samples/Keys directory.