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.