Creating event subscriber extensions

This topic describes how to extend IBM Director to support additional event sources.

Subtopics

Related topics

Related sample code

Understanding event subscriber extensions

The IBM Director Event Subscriber Client is an extendable service that manages events from external sources. The client manages events from external sources such as CIM, DMI, or the Windows NT Event Log, etc. by providing a framework by which available events can be described and sent selectively to the IBM Director server for additional processing. You can manage additional events by implementing an event source library.

Event source library discovery

When the Event Subscriber Client TWGESCLI.EXE is started, it searches for event source libraries. To be discovered by the Event Subscriber Client, an event source library must:

Developing an event source library

An event source library is a dynamic link library (DLL) that is loaded by the Event Subscriber Client at startup. To add a new event source library, do the following:

Reliability, availability, and serviceability (RAS)

The Event Subscriber Client, on the initialize() method call, passes a pointer to a RAS object to each event source library. An event source library should use this RAS object pointer to provide important debug and trace information. This information can be enabled directly via the RAS object pointer using the enable() method call or by creating the file twgescli.dbg in the bin directory. When enabled, debug and trace data are written to the file twgescli.log in the log directory.