Function : Events
EventQueuePut - Place an event in an event queue.
#include <event.h> STATUS LNPUBLIC EventQueuePut( char far *QueueName, char far *Originating Server, WORD Type, WORD Severity, TIMEDATE far *EventTime, WORD FormatSpecifier, WORD EventDataLength, void far *EventSpecificData);
An event producer calls EventQueuePut to place an event in an event queue. The parameter EventSpecificData may be used to pass user-defined data to the event consumer.
Each different combination of type and severity defines a distinct event, so a fairly large number of distinct events can be handled.
Note: The names of the event type flags (EVT_xxx) and the event severity flags (SEV_xxx) are descriptive of how Domino uses events. An event producer writing to a user-defined event queue is not required to follow this convention. In other words, if a user is not interested in anything relating to mail, the event type EVT_MAIL may be used to signal some other type of occurrence.
A user might even want to re-map the event type names (defined in EVT_xxx) and event severity names (defined in SEV_xxx) to have names that are more relevant to their tasks by doing something like:
define User_Defined_Event_1 EVT_MAIL
Parameters : Input : QueueName - Far pointer to a null-terminated character string containing the name of the queue that will receive the event. Some internal queue names are defined in EVENT_XXXX_QUEUE_NAME.
Originating Server - Far pointer to a null-terminated character string containing the name of the server on which the event occurred. If NULL, uses the current server name.
Type - The type of event. See the definition of EVT_xxx for a list of valid values for this parameter.
Severity - The severity of the event. See the definition of SEV_xxx for a list of valid values for this parameter.
EventTime - The time at which the event is generated.
FormatSpecifier - The format of the data specific to this event. See FMT_XXX for Valid format specifier flags.
EventDataLength - The length of the data specific to this event.
EventSpecificData - A far pointer to the first byte of data that is specific to this event. This data block is user-defined.
Output : (routine) - Return status from this call -- indicates either success or what the error is. The return codes include:
NOERROR ERR_xxx - Errors returned by lower level functions. There are so many possible causes, that It is best to use the code in a call to OSLoadString and display/log the error for the user.