Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Connection : tibemsMulticastExceptionCallback

tibemsMulticastExceptionCallback
Function Type
Purpose
Programs define functions of this type to asynchronously detect conditions with EMS multicast that may affect message consumers.
C Declaration
typedef void (*tibemsMulticastExceptionCallback) (
    tibemsConnection connection,
    tibemsSession session,
    tibemsMsgConsumer consumer,
    tibems_status status,
    const char* description,
    void* closure);
Parameters
 
Remarks
When a program uses a multicast consumer to receive messages, EMS can detect conditions that may indicate a problem, and notify the client program by returning an error status code. The client application can then take the appropriate action.
This callback provides a pathway for alerting a client program of multicast problems. The program implements this callback and registers it. When the client library detects a multicast problem, it calls this callback and passes it the appropriate EMS objects, a status code that identifies the problem, and a detailed description of the problem. This callback is invoked for each consumer that is affected by the multicast warning or error. Some applications may just simply log the problem; others may take further measures.
See Also
tibems_SetMulticastExceptionListener on page 415
Chapter 14, Using Multicast, in the TIBCO Enterprise Message Service User’s Guide

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved