Appendix B: Migrating Open Server Applications to EAServer

Specifying event handlers

To specify an event handler from EAServer Manager:

Double-click the Servers folder.
Highlight the server for which you are specifying the event handler.
Select File | Server Properties.
Select the Handlers tab.

Enter the DLL or shared library name and the function name of the specific event handler being called, separated by a colon.

The following examples illustrate an entry for a connect event handler for Solaris and Windows:

Solaris

libsamp.so:debug_connect

where libsamp.so is the shared library name and debug_connect is the function called whenever a connect event handler is called.
Windows

libsamp.dll:debug_connect

where libsamp.dll is the DLL name and debug_connect is the function called whenever a connect event handler is called.

The following table summarizes the types of event handlers that you can install. For information on coding event handlers, refer to“Additional event handler information”and your Open Server documentation.

**Table B-1: Individual server event handlers**
Event handler	Called
Connect	Each time a client connects to EAServer
Disconnect	When the client disconnects from EAServer
Error	When an Open Server processing error occurs
Initialization	Before starting EAServer
Start	After initialization, but before accepting client requests
Stop	When a request to stop the server is made
Language	When a client sends a language request, such as a SQL statement
RPC	When a client issues a remote procedure call
Attention	When an attention had been received. An attention is an immediate event; EAServer services the attention as soon as it occurs, rather than adding it to the client’s event queue
Cursor	When a client sends a cursor request
Dynamic	When a client sends a dynamic SQL request
Message	When the client sends a message
Option	When a client sends an option command
Bulk	When a client issues a bulk copy request

View this book as PDF