To make a broker capable of handling multicast requests.
Before you can use multicast, you must define some topics as capable of being multicast.
For the topic root, the choice is either Enabled or Disabled. The default is Disabled.
For a child topic root, the choice can be Inherit, Enabled, or Disabled. The default is Inherit.
This must be in the range 224.0.0.0 through 239.255.255.255. The default value is 224.0.0.0.
This must be in the range 224.0.0.0 through 239.255.255.255. The default value is 239.255.255.255.
The default value is 34343.
This can be in the range 500 through 32000. The default value is 7000.
The default value is 20.
The default value is 1, which means that the multicast packet must remain local to its originator and does not pass through any routers. The maximum value is 255.
This can be a host name or an IP address. The default is 'None'. If the default value is chosen, the network interface that is used is operating system dependent.
The Overlapping Multicast Topic Behavior property controls the behavior of the broker when a client requests a multicast subscription for a topic that is part of a topic hierarchy containing topics that are explicitly disabled for multicast.
For example, consider a topic hierarchy where multicast is a topic with two children, foo that is enabled for multicast, and bar that is not enabled for multicast.
The default value is Accept.
The default value is 360.
The default is Disabled. If you choose Static you can also choose a value for the parameter Broker Transmission Rate Limit Value.
This value can be in the range 10 through 1,000,000.
This value can be in the range 0 through 1000. The default value is 100.
This value can be in the range 10 through 1000. The default value is 300.
If memory use is important, try using different values for this parameter and looking at the effect on the overall performance of your application at high transmission rates.
This value can be in the range 1 through 5000. The default value is 500.
This value can be in the range 65 through 10000. The default value is 3000.
This value can be in the range 1 through 20. The default value is 7.
This value can be in the range 1000 through 1,000,000. The default value is 60,000.
This value can be in the range 50 through 1000. The default value is 600.
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. See mqsichangeproperties command.
Property name | mqsichangeproperties parameter |
---|---|
Multicast Enabled | multicastEnabled |
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 | multicastHistoryCleaningTimeSec |
Broker Minimal History Size | multicastMinimalHistoryKBytes |
Broker NACK Accumulation Time | multicastNackAccumulationTimeMillis |
mqsichangeproperties WBRK_BROKER -o DynamicSubscriptionEngine -n multicastEnabled -v true
This 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.
Related concepts
Multicast publish/subscribe
Related tasks
Modifying broker properties
Related reference
Broker Administration perspective
mqsichangeproperties command
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
aq13150_ |