tibemsExceptionCallback


Function 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); 

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.

Parameter
Description
connection
This parameter receives the connection object.
status
This parameter receives a status code, which identifies the connection problem.
closure
This parameter receives the closure data, which the program supplied in the call that registered the callback.

See Also

tibemsConnection

tibemsConnection_SetExceptionListener


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com