Adjusting Handler Settings

Handler Settings

OnixS::SURF::MarketData::Handler constructor accepts instance of the OnixS::SURF::MarketData::HandlerSettings class which defines values for various parameters that affect Handler behavior. The section below describes the most important parameters.

Primary Settings

Directory for Log Files

By default, the Handler logs all important aspects of its activity while processing market data. Therefore, it must know where on local filesystem it can store this kind of information. OnixS::SURF::MarketData::HandlerSettings::logDirectory parameter value must be defined to point the Handler in which directory it can place its log files.

Licensing the Handler

Handler needs a license for successful execution. If the Handler is not able to find a valid license it will throw an exception at the initialization stage.

OnixS::SURF::MarketData::HandlerSettings structure exposes OnixS::SURF::MarketData::HandlerSettings::licenseDirectory parameter which allows to instruct the Handler where to look for a valid license. By default, the Handler looks for a license in the current directory for the application which uses the Handler.

Note

Handler looks for a valid license in the specified folder and selects the best one. If multiple license available, it will select most significant one (for example, Production instead of Trial if both are available).

Example

Following example demonstrates how to setup primary settings for the Handler:

using namespace OnixS::SURF::MarketData;

int main (int argc, char* argv[])
{
    HandlerSettings settings;

    // This option used to control verbosity of logger.
    settings.logLevel = LogLevel::Debug;

    // This option used to specify extra logger settings.
    settings.logSettings = LogSettings::Default;

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

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

    Handler handler (settings);

    // ...
}