Set up a multicast broker either by using the workbench or by using the Configuration Manager Proxy Java™ API. This topic describes how to use the workbench.
Before you can use multicast, you must define the topics that are capable of being multicast. See Making topics multicast.
For information about how to use the Configuration Manager Proxy (CMP), see Developing applications that use the Configuration Manager Proxy Java API and Class com.ibm.broker.config.proxy.BrokerProxy.MulticastParameterSet.
To enable a broker to handle multicast requests:
The preferred way to change the broker's multicast configuration is to use the workbench. However, you can also use the command mqsichangeproperties to change the broker's properties.
Warning: Any changes to the broker configuration that you make on the mqsichangeproperties are overwritten with the configuration that is held in the Configuration Manager whenever the broker configuration is deployed.
Property name | mqsichangeproperties parameter |
---|---|
Multicast Enabled | multicastEnabled |
Protocol Type | multicastProtocolType |
IPv4 Minimum Address | multicastAddressRangeMin |
IPv4 Maximum Address | multicastAddressRangeMax |
Data Port | multicastDataPort |
Broker Packet Size | multicastPacketSizeBytes |
Broker Heartbeat Timeout | multicastHeartbeatTimeoutSec |
Broker Multicast TTL | multicastMCastSocketTTL |
IPv4 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) | Not applicable |
Broker Minimal History Size | multicastMinimalHistoryKBytes |
Broker NACK Accumulation Time | multicastNackAccumulationTimeMillis |
Maximum Client Memory Size, | multicastMaxMemoryAllowedKBytes |
mqsichangeproperties WBRK_BROKER -o DynamicSubscriptionEngine -n multicastEnabled -v true
This command 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,50000
None of the other properties of the broker are changed.Use commas to separate the properties that are being changed, and their values.
For the changes to be effective, restart the broker.