LogOpenEventNotification registers a consumer with the Logging Service, so that the consumer will receive notification when specific log records have been created. Consumers specify which log records they will be notified about by providing filtering information. If no filter data structure is provided, all events that are logged to the specified log file will cause event notifications to be forwarded to the consumer. LogOpenEventNotification returns an ID used to reference this notification request.

LogChangeEventFilter can be used to change the filter that is in effect for a given registration.

LogWaitEvent is used to ask the Logging Service to send the next log record that meets the criteria specified in the registration. When an event notification is received, the consumer receives an event-key data structure and corresponding log entry.

LogCloseEventNotification is used to remove the registration so that no further notifications will be received by the consumer.

#define INCL_LOGGING
#include <os2.h>

ULONG           service;
PLOENREQUEST    pOpenEventNotification;
APIRET          rc;

rc = LogOpenEventNotification(service, pOpenEventNotification);