The Operator Console Agent

SMT
Version 2.81

The Operator Console Agent - SMTOPER

Accepts error messages, warnings, and information messages, and does something useful (but unspecified) with them. The current implementation writes all received messages to the standard error device.

To use SMTOPER, call smtoper init(). This creates a single unnamed thread automatically the first time it is called, and has no effect thereafter. You can then send messages to this thread. SMTOPER does not reply. It supports these methods:

ERROR - handle serious error message.
WARNING - handle warning message.
INFO - handle information message.
LOG - direct console messages to a log file.

Example of initialising SMTOPER:

/*  Static data                                                 */
static QID
    console;                    /*  Operator console queue      */

    /*  In agent initialisation code                            */
    THREAD  *thread;            /*  Handle to console thread    */
    /*  Ensure that operator console is running, else start it  */
    smtoper_init ();
    if ((thread = thread lookup (SMT_OPERATOR, "")) != NULL)
        console = thread-> queue-> qid;
    else
        return (-1);

The ERROR Method

The event body contains a string. This string is handled as a serious error message. For example:

    sendfmt (&console, "ERROR", "Could not open %s", filename);
    senderr (&console);
    raise exception (exception_event);

The WARNING Method

The event body contains a string. This string is handled as a non-fatal warning message. For example:

    sendfmt (&console, "WARNING", "Exceeded connection quota");

The INFO Method

The event body contains a string. This string is handled as a information message. For example:

    sendfmt (&console, "INFO", "Connection from %s", system);

The LOG Method

The event body contains a string that specifies the name of a SMTLOG thread. All operator output is sent to this thread.

SMTOPER Implementation

The hypertext view of SMTOPER's dialog and source code may help to understand how SMTOPER works.

| << | < | > | >>