Handler Settings

All Handler's constructors accept an instance of OnixS::Xetra::MarketData::MDI::HandlerSettings class which defines values of various parameters for determination Handler's behavior. The role of the most important parameters, that are used in regular cases, is described below.

Primary Settings

Directory for Log Files

By default, all important aspects of handlers' activity are logged. Therefore, the handler must know where this kind of information can be stored on a local file system. OnixS::Xetra::MarketData::MDI::HandlerSettings::logDirectory parameter needs to be defined for pointing the handlers place where log files are to be stored.

Licensing

To run a handler's instance, it is required to have a license file. When the instance is not able to find a valid license, it throws an exception at the initialization stage.

OnixS::Xetra::MarketData::MDI::HandlerSettings contains OnixS::Xetra::MarketData::MDI::HandlerSettings::licenseDirectory Member, which contains a path to the directory containing license file(s). If its value is empty, the handler looks for the license file in the current directory.

Note: If there is more than one license file in the license directory, the most significant one is used (for example, production instead of trial, if both are available).

Example

The following example demonstrates how to setup primary settings for OnixS::Xetra::MarketData::MDI::Handler:

OnixS::Xetra::MarketData::MDI::HandlerSettings handlerSettings;

// This option is used to control logger's output verbosity.
settings.logLevel = OnixS::Xetra::MarketData::MDI::LogLevel::Debug;

// This option is used to specify extra logger settings.
settings.logSettings = OnixS::Xetra::MarketData::MDI::LogSettings::Default;

// Logs will be stored in the 'logs' local sub folder.
settings.logDirectory = "logs";

// This option is used to instruct Handler where to look for a valid license.
settings.licenseDirectory = "../../license";

// Path to a template file.
settings.templateFile = "../Xetra Release 16.0 - Xetra market Data Interface - Final Version Fast Message Template.xml";

// Ip addresses and port numbers of Xetra feeds.
settings.stateChangesFeed = FeedDescriptor ("233.65.120.254", 12001, "", 0);
settings.tickerFeed = FeedDescriptor ("233.65.120.254", 12002, "", 0);
settings.marketDataFeed = FeedDescriptor ("233.65.120.254", 12003, "", 0);

// first argument defines an operating mode
OnixS::Xetra::MarketData::MDI::Handler handler (settings);