You can set up a multicast broker by either using the Message Brokers Toolkit or by using the Configuration Manager Proxy Java API. This topic describes how to use the Message Brokers Toolkit. For information about how to use the Configuration Manager Proxy (CMP), see Developing applications using the CMP and Class com.ibm.broker.config.proxy.BrokerProxy.MulticastParameterSet.
To make a broker capable of handling multicast requests:
Before you can use multicast, you must define some topics as capable of being multicast.
The recommended way of changing the broker's multicast configuration is to use the workbench. However, you can also use the command mqsichangeproperties to change the broker's properties.
Property name | mqsichangeproperties parameter |
---|---|
Multicast Enabled | multicastEnabled |
Protocol Type | multicastProtocolType |
Min Address | multicastAddressRangeMin |
Max Address | multicastAddressRangeMax |
Data Port | multicastDataPort |
Broker Packet Size | multicastPacketSizeBytes |
Broker Heartbeat Timeout | multicastHeartbeatTimeoutSec |
Broker Multicast TTL | multicastMCastSocketTTL |
Broker Network Interface | multicastMulticastInterface |
Overlapping Multicast Topic Behavior | multicastOverlappingTopicBehavior |
Maximum Key Age | multicastMaxKeyAge |
Broker Transmission Rate Limit Activation | multicastLimitTransRate |
Broker Transmission Rate Limit Value | multicastTransRateLimitKbps |
Client NACK Back Off Time | multicastBackoffTimeMillis |
Client NACK Check Period | multicastNackCheckPeriodMillis |
Client Packet Buffer Number | multicastPacketBuffers |
Client Socket Buffer Size | multicastSocketBufferSizeKbytes |
Broker History Cleaning Time (deprecated in V6) | N/A |
Broker Minimal History Size | multicastMinimalHistoryKBytes |
Broker NACK Accumulation Time | multicastNackAccumulationTimeMillis |
Maximum Client Memory Size, | multicastMaxMemoryAllowedKBytes |
mqsichangeproperties WBRK_BROKER -o DynamicSubscriptionEngine -n multicastEnabled -v trueThis enables the broker for multicast, but does not change any other properties of the broker.
mqsichangeproperties WBRK_BROKER -o DynamicSubscriptionEngine -n multicastEnabled, multicastLimitTransRate,multicastTransRateLimitKbps -v true,Static,50000None of the other properties of the broker are changed.
Note the use of commas to separate the properties that are being changed, and also their values.
For the changes to be effective, you must restart the broker.
Warning: Any changes to the broker configuration made using mqsichangeproperties are overwritten with the configuration that is held in the Configuration Manager whenever the broker configuration is deployed.