# tibemsExceptionCallback

Type

## Purpose

Programs define functions of this type to asynchronously detect problems with connections.

## C Declaration

    typedef void (*tibemsExceptionCallback) (
        tibemsConnection connection,
        tibems_status status,
        void* closure);

## Parameters

Parameter | Description
--- | ---
`connection` | Receive the connection object.
`status` | Receive a status code, which identifies the connection problem.
`closure` | Receive the closure data, which the program supplied in the call that registered the callback.

## Remarks

When a program uses a connection to send messages, the send calls can detect problems with the connection, and notify the client program by returning an error status code. However, when a program uses a connection only to receive messages, the client cannot detect errors in this way.

This callback provides an alternate pathway for alerting a client program of connection problems. The program implements this callback, and registers it with the connection object. When the client library detects a connection problem, it calls this callback with a status code that identifies the problem.

This call is not supported in COBOL.

## See Also

`tibemsConnection`

`tibemsConnection_SetExceptionListener`

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