OnixS C++ Tradeweb Approved Publication Arrangement (APA) Handler  1.2.2.18
API documentation
Advanced Programming

Inner Contents

 Affecting Packet Gap Detection
 
 Low Latency Best Practices [UPDATED]
 

Detailed Description

This section provides information about more advanced development techniques supported by the Handler.

Thread affinity

FeedEngine provides ability to set affinity mask for threads. For example, OnixS::Tradeweb::MarketData::Apa::FeedEngineSettings::threadAffinity methods can be used to run threads on specific processors.

Warnings Concept

Miscellaneous non-critical issues may occur while handler's instance is being executed. Handler processes such issues by itself, thus no special handling is required in that case. However, sometimes it's reasonable to be notified about such events. For this purpose, handler represents OnixS::Tradeweb::MarketData::Apa::WarningListener class and invokes its OnixS::Tradeweb::MarketData::Apa::WarningListener::onWarning member each time a non-critical issue occurs.

Controlling Logging in the Handler

Handler logs important aspects of its execution. Logs are stored into the directory specified by the OnixS::Tradeweb::MarketData::Apa::HandlerSettings::logDirectory member value. Logging includes network data received and processed by handler and, of course, errors occurred at execution time.

Since handlers output logging data into regular files, this affects their performance and sometimes requires significant system resources like space on hard drive. HandlerCore expose several parameters which allows to suppress certain kinds of logging data and thus to reduce load on the file system and increase general performance.

Following table describes logging-related parameters exposed by the OnixS::Tradeweb::MarketData::Apa::HandlerSettings structure:

Settings Member Default value Description
logLevel OnixS::Tradeweb::MarketData::Apa::LogLevel::Info Specifies whether handler's instance must output informational messages about its state as well as which kind of information must be put into the log. For more information, please, take a look at description of OnixS::Tradeweb::MarketData::Apa::LogLevel enumeration entries.
logSettings OnixS::Tradeweb::MarketData::Apa::LogSettings::Default If logging is activated, this member specifies which additional data must be put into the log. For more information, please, take a look at description of OnixS::Tradeweb::MarketData::Apa::LogSettings enumeration entries.

Activating Logging Example

Following example demonstrates how to enable logging:

settings.logLevel = LogLevel::Debug;
settings.logDirectory = "./logs";
// Log messages will be stored in the file, as well as received binary packets and full state of updated order books.
settings.logSettings = LogSettings::TraceToFile|LogSettings::LogPackets|LogSettings::LogBooks;