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.