# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.