Inner Contents
	Adjusting Handler Settings
	Controlling Handler Logging
	Events in the Handler
	Error Handling
	Warning Handling
	Understanding Handler States
	Message Identification
	Trading

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.

Please also see section 5.3.3 Password Encryption of Enhanced Trading Interface (ETI) Manual to get more information about password encryption.