LOCALADDRESS

For a connection to a queue manager, this property specifies either the local network interface to be used, or the local port, or range of local ports, to be used.

Applicable Objects

ConnectionFactory, QueueConnectionFactory, TopicConnectionFactory, XAConnectionFactory, XAQueueConnectionFactory, XATopicConnectionFactory

JMS administration tool long name: LOCALADDRESS

JMS administration tool short name: LA

Programmatic access

Setters/getters

  • MQConnectionFactory.setLocalAddress()
  • MQConnectionFactory.getLocalAddress()

Values

"" (empty string)
This is the default value.
A string in the format [ip-addr][(low-port[,high-port])]
Here are some examples:

192.0.2.0

The channel binds to address 192.0.2.0 locally.

192.0.2.0(1000)

The channel binds to address 192.0.2.0 locally and uses port 1000.

192.0.2.0(1000,2000)

The channel binds to address 192.0.2.0 locally and uses a port in the range 1000 to 2000.

(1000)

The channel binds to port 1000 locally.

(1000,2000)

The channel binds to a port in the range 1000 to 2000 locally.

You can specify a host name instead of an IP address. For a real-time connection to a broker, this property is relevant only when multicast is used, and the value of the property must not contain a port number, or a range of port numbers. The only valid values of the property in this case are null, an IP address, or a host name.