Affecting Handler behaviour

Advanced Initialization Parameters

In simplest case, Handler needs reference for a connectivity configuration to get initialized. However, there were other parameters which affect miscellaneous aspects of Handler's behaviour. These parameters are collected into the single OnixS::ICE::iMpact::MarketData::HandlerSettings class. Instance of this class must be delivered to the Handler at the construction stage.

Activating Logging in the Handler

OnixS::ICE::iMpact::MarketData::HandlerSettings::logLevel parameter of the OnixS::ICE::iMpact::MarketData::HandlerSettings class instructs the Handler whether it should log its events and which of events should be put into the log. By default, to provide maximum performance, logging is not performed by the Handler. However, in some cases logging becomes a useful feature. For example, log data can be used by support team to analyse and resolve miscellaneous issues occurred during execution of Handler.

Specifying License Store

Since recently, the Handler uses new unified licensing services which allow to store multiple licenses for a single and multiple products in the single place. By default, the Handler looks for license at the current directory of the application which executes the Handler. However, sometimes there's a need to store license in a different place, especially when a company uses multiple Onix Solutions products. For this reason, OnixS::ICE::iMpact::MarketData::HandlerSettings exposes OnixS::ICE::iMpact::MarketData::HandlerSettings::licenseDirectory parameter which allows to specify directory in which Handler should look for the license.

Example

Following example demonstrates how to construct Handler with custom options:

HandlerSettings handlerSettings;

// Activates logging to get data for the Support.
handlerSettings.logLevel = LogLevels::Info;

// By default, license is stored in lib folder of the distribute 
// package. Instead of copying, will use original file.
handlerSettings.licenseDirectory = "../license";

// Constructs handler with custom license root and enabled logging.
Handler handler(handlerSettings);