tibemsConnection_SetExceptionListener

Function

Purpose

Set the exception listener for a connection.

C Declaration

tibems_status tibemsConnection_SetExceptionListener(
    tibemsConnection connection,
    tibemsExceptionCallback listener,
    const void* closure );

COBOL Call

CALL "tibemsConnection_SetExceptionListener_STL"
     USING BY VALUE     tibemsConnection,
           BY REFERENCE tibems-Exception-Status,
           BY VALUE     TIBEMS-NULLPTR,
           RETURNING    tibems-status
END-CALL.
Note: connection has usage pointer.

tibems-Exception-Status has usage binary.

Parameters

Parameter Description
connection Set the exception listener for this connection.
listener Register this exception listener callback.
closure Register this closure argument.

Remarks

This is an alternate pathway for alerting a client program of connection problems. The program defines an exception listener callback function, and calls this function to register the callback and a closure argument. When the client library detects a connection problem, it calls the callback with a status code that identifies the problem.

See Also

tibemsConnection_GetExceptionListener

Asynchronous Errors.

tibemsExceptionCallback