dlm_MonStart()

Starts the flow of data from the server.

#include "dlmmon.h"

DlmResult dlm_MonStart
    (
        DlmMonitorId  id
    );

dlm_MonStart() starts the flow of data from the server if it has been stopped. The monitor when starting up a session with a call to dlm_MonOpen defaults with data flowing from the server to the monitor. A call to dlm_MonStop can be used to stop the flow of data from the server.

If successful, dlm_MonStart() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dlm_ERROR_INVALID_ID

dlm_MonStop()

if ((result = dlm_MonOpen(password, address, line,
                              callback, 0, &id)) < 0)
{
    printf("Error: Failure opening: %s.\n", dlm_ErrorMessage(result));
}
else
{
    dlm_MonStop(id);

    /* do something */

    dlm_MonStart(id);

    /* do something */

    if ((result =  dlm_MonClose(id)) < 0)
    {
        printf("Error: Failure closing: %s.\n", dlm_ErrorMessage(result));
    }
    else
    {
        printf("Monitor session closed.\n");
    }
}