OnixS Thomson Reuters Matching API (MAPI) Market Data Handler for C++  1.6.0.0
Adjusting Handler's Settings

Handler Settings

OnixS::ThomsonReuters::MarketData::Handler constructor accepts instance of the OnixS::ThomsonReuters::MarketData::HandlerSettings class which defines values for various parameters which affect Handler's behavior. Below section describes role of the most important parameters used in usual cases.

Primary Settings

Directory for Log Files

By default, 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::ThomsonReuters::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 successfull execution. If the Handler is not able to find a valid license it will throw an exception at the initialization stage.

OnixS::ThomsonReuters::MarketData::HandlerSettings structure exposes OnixS::ThomsonReuters::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. However, by using noted parameter, it's possible to specify another folder anywhere on filesystem.

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:

int main (int argc, char* argv[])
{
HandlerSettings settings;
// This option used to control verbosity of logger.
// This option used to specify extra logger settings.
// Logs will be stored in 'logs' local subfolder.
settings.logDirectory = "logs";
// This option used to instruct the Handler where to look for a valid license.
settings.licenseDirectory = "../../license";
Handler handler (settings);
// ...
}