The TCP Transport

The TCP transport allows clients to connect to a remote ActiveMQ broker using a TCP socket.

These configuration options are used to tune the underlying TCP transport, and can be configured on a JMS client's connection URI string or on a Brokers transport bind URI.

The options below should be prefixed with transport.* when used on the server side.

Configuration Syntax

tcp://hostname:port?key=value

Transport Options

Option Name	Default Value	Description
minmumWireFormatVersion	0	The minimum version wireformat that is allowed
trace	false	Causes all commands that are sent over the transport to be logged (to view use config of the form: log4j.logger.org.apache.activemq.transport.TransportLogger=DEBUG)
daemon	false	Tells the transport thread to run as a daemon or not. Useful to enable when embedding in a Spring container or a web container to allow the container to shut down properly.
useLocalHost	false	When true, it causes the local machines name to resolve to "localhost".
socketBufferSize	64 * 1024	Sets the socket buffer size in bytes
keepAlive	false	When true, enables TCP KeepAlive on the broker connection. Useful to ensure that inactive consumers don't time out.
soTimeout	0	sets the socket timeout in milliseconds
connectionTimeout	30000	A non-zero value specifies the connection timeout in milliseconds. A zero value means wait forever for the connection to be established. Negative values are ignored.
wireFormat	default	The 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
closeAsync	true	The false value causes all sockets to be closed synchronously
soLinger	MIN_INTEGER	When > -1 causes the socket soLinger option to be enabled with this value. When == -1, causes soLinger to be disabled. (from 5.6.0)
maximumConnections	Integer.MAX_VALUE	The maximum number of sockets the broker is allowed to create
diffServ	0	client only) The preferred Differentiated Services traffic class to be set on outgoing packets, as described in RFC 2475. Valid integer values: [0,64). Valid string values: EF, AF[1-3][1-4] or CS[0-7]. With JDK 6, only works when the Java Runtime uses the IPv4 stack, which can be done by setting the java.net.preferIPv4Stack system property to be true. Cannot be used at the same time as the typeOfService option.
typeOfService	0	(client only) The preferred Type of Service value to be set on outgoing packets. Val id integer values: [0,256). With JDK 6, only works when the Java Runtime uses the IPv4 stack, which can be done by setting the java.net.preferIPv4Stack system property to be true. Cannot be used at the same time as the diffServ option
tcpNoDelay	true	When true, the TCP_NODELAY setting is enabled on the socket.

Example URI

On Server side (in TransportConnector)

+