OnixS ICE iMpact Multicast Price Feed Handler C++ library 8.18.0
Users' manual and API documentation
Loading...
Searching...
No Matches
Adjusting Handler Settings

Advanced Initialization Parameters

In the simplest case, the Handler needs a reference for a connectivity configuration to get initialized. However, other parameters also affect miscellaneous aspects of Handler's behavior. These parameters are collected into a single HandlerSettings class. An instance of this class must be delivered to the Handler during construction.

Activating Logging in the Handler

The HandlerSettings::logLevel parameter of the HandlerSettings class instructs the Handler whether it should log its events and which events should be written to the log. By default, to achieve maximum performance, the Handler does not log. However, in some cases, logging becomes a useful feature. For example, log data can be used by the support team to analyze and resolve miscellaneous issues that occurred during the execution of the Handler.

Specifying License Store

The Handler relies on unified licensing services, which allow storing multiple licenses for a single product and multiple products in a single place. By default, it looks for the license in the application's current directory. However, sometimes it is necessary to store the license in a different location, especially when a company uses multiple Onix Solutions products. For this reason, HandlerSettings exposes the HandlerSettings::licenseDirectory parameter, which lets you specify the directory where the Handler should look for the license.

Example

The following example demonstrates how to construct a Handler with custom options:

HandlerSettings handlerSettings;
// Activates logging to get data for the Support.
handlerSettings.logLevel = LogLevels::Info;
// By default, the license is stored in the `license/`
// directory of the distribution package.
// Instead of copying, we will use the original file.
handlerSettings.licenseDirectory = "../license";
// Constructs a handler with a custom license
// root and enabled logging.
Handler handler(handlerSettings);