XMSC_WMQ_LOCAL_ADDRESS

    Data type:
    String

    Property of:
    ConnectionFactory

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

The value of the property is a string with the following format:

  • [host_name][(low_port)[,high_port])]

The meanings of the variables are as follows:

    host_name
    The host name or IP address of the local network interface to be used for the connection.

    Providing this information is necessary only if the system on which the application is running has two or more network interfaces and we need to be able to specify which interface must be used for the connection. If the system has only one network interface, only that interface can be used. If the system has two or more network interfaces and we do not specify which interface must be used, the interface is selected at random.

    low_port
    The number of the local port to be used for the connection.

    If high_port is also specified, low_port is interpreted the lowest port number in a range of port numbers.

    high_port
    The highest port number in a range of port numbers. One of the ports in the specified range must be used for the connection.

The maximum length of the string is 48 characters.

Here are some examples of valid values of the property:

  • JUPITER
  • 9.20.4.98
  • JUPITER(1000)
  • 9.20.4.98(1000,2000)
  • (1000)
  • (1000,2000)

By default, the property is not set.

This property is relevant only when an application connects to a queue manager in client mode.

Parent topic: Property definitions