4 - Sending Commands Using the Remote Control Interface

The remote control interface provides a method to send Logger commands to remote Loggers (constructed using Logger command factories, for example, open file).

The commands can be addressed to individual Loggers or to groups of Loggers using DIS-like wildcard values. (The default is to send to all remote Loggers.) Each sent command has an associated sequence number passed all the way up to the invoking remote control application. The remote Loggers return an acknowledge message with the sequence number when a command is received. In some cases, the remote Logger may indicate that the command is rejected, but usually the acknowledge message merely indicates that the command message was received. The remote control interface collects the acknowledgements from all the Loggers and invokes a single accept callback when they have been received. If one or more Loggers fail to acknowledge, the remote control interface invokes a “command timed out” callback. Each command rejection results in a “command reject” callback.

[<< Inspecting Logger State] [Home] [Invoking Actions Using Domain Interfaces >>]