1 \addtogroup error-and-warning-handling
3 \brief Describes how to handle issues which
4 may occur while processing market data.
6 \section error-handling Handling Errors And Warnings
8 Being a C++ class library, the SDK uses exceptions to report about
9 an error occurred while performing a certain action. For example,
10 the SDK raises an ordinary exception in case of license check failure.
11 However, the OnixS::CME::MDH::Handler processes market data asynchronously,
12 therefore it is not able to report any further errors from the moment market data
13 processing is started. For this reason, the OnixS::CME::MDH::HandlerListener
14 contains two members: OnixS::CME::MDH::HandlerListener::onWarning and
15 OnixS::CME::MDH::HandlerListener::onError. The OnixS::CME::MDH::Handler
16 instance ivokes given members in case of a warning and an error respectively.
18 In most cases, the OnixS::CME::MDH::Handler manages each issue case on its own.
19 For example, if data is lost, the Handler uses the corresponding recovery
20 service like a TCP recovery of market state recovery from snapshots according
21 to its parameters. Therefore, in most cases, no additional actions are required
22 from the user side. THe Handler keeps processing market data according its settings.
23 However, under some circumstances, manual intrusions are required. For example, if
24 the Handler is unable to join to multicast channel, user must define further steps.
