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