Specifying event handlers

To specify an event handler from EAServer Manager:

  1. Double-click the Servers folder.

  2. Highlight the server for which you are specifying the event handler.

  3. Select File | Server Properties.

  4. Select the Handlers tab.

  5. 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.

    Table B-1 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