layout: default_md title: Multicast Transport Reference title-class: page-title-activemq5 type: activemq5

Using ActiveMQ > Configuring Transports > ActiveMQ Connection URIs > Multicast Transport Reference

The Multicast Transport

The Multicast transport allows clients to connect to a remote ActiveMQ broker using multicast

Note that by default Multicast is not reliable; datagrams can be lost so you should add a reliability layer to ensure the JMS contract can be implemented on a non-reliable transport.

Configuration Syntax

multicast://address:port?transportOptions
Transport Options
Option NameDefault ValueDescription
groupdefaultspecify a unique group name that can segregate multicast traffic
minmumWireFormatVersion0The minimum version wireformat that is allowed
tracefalseCauses all commands that are sent over the transport to be logged
useLocalHosttrueWhen true, it causes the local machines name to resolve to “localhost”.
datagramSize4 * 1024Specifies the size of a datagram
timeToLive-1The time to live of datagrams. Set greater than 1 to send packets beyond the local network. (NOTE: This won't work for IPv4 addresses without setting the property java.net.preferIPv4Stack=true. For more info see the IPv6 User Guide for JDK)
loopBackModefalseShould loopback mode be used
wireFormatdefaultThe name of the WireFormat to use
wireFormat.*All the properties with this prefix are used to configure the wireFormat. See Configuring Wire Formats for more information
Example URIs

To use the default value of “multicast://239.255.2.3:6155” with a default multicast group name of “default” from MulticastDiscoveryAgent use

multicast://default 

To specify the IP address and port use

multicast://224.1.2.3:6255

To specify a multicast group name other than the default name of “default” use

multicast://224.1.2.3:6255?group=mygroupname