Copyright © TIBCO Software Inc. All Rights Reserved

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

 

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

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.

This call is not supported in COBOL, and is not supported on z/OS and IBM i systems.

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