tibems_SetMulticastEnabled

Function

Warning: Along with the multicast feature, this function was deprecated in software release 8.3.0 and will no longer be supported in future releases.

Purpose

Set whether message consumers subscribed to multicast-enabled topics in the EMS client application will receive messages over multicast.

C Declaration

tibems_status tibems_SetMulticastEnabled(
    tibems_bool enabled);

Parameters

Parameter Description
enabled When true, multicast is enabled for the client.

When false, multicast is disabled and the client application will receive all messages over TCP.

Remarks

When enabled, message consumers subscribed to a multicast-enabled topic will receive messages over multicast. By default, multicast is enabled.

tibems_SetMulticastEnabled overrides both the EMS server and factory settings that enable multicast.

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