Ultra Messaging® Configuration Guide
Prev	Chapter 4. Reference	Next

4.11. Transport LBT-RU Network Options

LBT-RU receivers initiate UDP connections toward LBT-RU sources for delivering NAKs and ACKs. LBT-RU sources then initiate connections toward LBT-RU receivers for delivery of UMS messages.

Figure 4-10. LBT-RU network options

transport_lbtru_port_low is the lowest port that UMS will allocate for LBT-RU sources in a context; transport_lbtru_port_high is the highest. No more than transport_lbtru_maximum_ports ports will be assigned to LBT-RU sources within a single context.

Creation of an UMS source on an LBT-RU transport will allocate an unused UDP port from the range if less than transport_lbtru_maximum_ports ports have already been allocated. Setting transport_lbtru_maximum_ports to a fraction of the range allows the corresponding multiple number of UMS processes to share a common configuration.

If a particular UDP port is desired by a source, it may be given with transport_lbtru_port. If the desired port is already in use, then an unused port will be sought as described above. A value of 0 (the default) expresses no preference and results in the default open port seeking behavior described above.

transport_lbtru_interface may be used on LBT-RU sources to choose particular interface, overriding the default INADDR_ANY which accepts connections on all interfaces. Similarly, transport_lbtru_interface may be used on receivers to choose a particular interface for outgoing connections.

4.11.1. transport_lbtru_interface (receiver)

Specifies the network interface over which UM LBT-RU receivers read application data messages. Can specify full IP address of interface, or just network part (see Specifying Interfaces for details).

Scope:	receiver
Type:	lbm_ipv4_address_mask_t
Default value:	0.0.0.0 (`INADDR_ANY`)
When to Set:	Can only be set during object initialization.

4.11.2. transport_lbtru_interface (source)

Specifies the network interface over which UM LBT-RU sources receive connection requests from topic receivers. Can specify full IP address of interface, or just network part (see Specifying Interfaces for details). Be aware that this option is applied to the transport session when the first topic is created on that session. Thus, setting a different interface for a subsequent topic that maps onto the same transport session will have no effect. Default is set to INADDR_ANY, meaning that it will accept incoming connection requests from any interface.

Scope:	source
Type:	lbm_ipv4_address_mask_t
Default value:	0.0.0.0 (`INADDR_ANY`)
When to Set:	Can only be set during object initialization.

4.11.3. transport_lbtru_maximum_ports (context)

Maximum number of unicast port numbers that LBT-RU will use for all implicitly allocated sessions.

Scope:	context
Type:	lbm_uint16_t
Units:	number of ports
Default value:	5
When to Set:	Can only be set during object initialization.

4.11.4. transport_lbtru_port (source)

The preferred unicast port number for this Topic. If 0, the context will attempt to find one in the given LBT-RU source port range.

Scope:	source
Type:	lbm_uint16_t
Default value:	0 (use open port)
Byte order:	Network
When to Set:	Can only be set during object initialization.

4.11.5. transport_lbtru_port_high (context)

High unicast port number to assign LBT-RU sources to. Clients will send connection requests, ACKs, and NAKs to a port number in this range.

Scope:	context
Type:	lbm_uint16_t
Default value:	14389
Byte order:	Host
When to Set:	Can only be set during object initialization.

4.11.6. transport_lbtru_port_high (receiver)

High port number to use for receiving LBT-RU data. All LBT-RU data for the topic will arrive on this range.

Scope:	receiver
Type:	lbm_uint16_t
Default value:	14379
Byte order:	Host
When to Set:	Can only be set during object initialization.

4.11.7. transport_lbtru_port_low (context)

Low unicast port number to assign LBT-RU sources to. Clients will send connection requests, ACKs, and NAKs to a port number in this range.

Scope:	context
Type:	lbm_uint16_t
Default value:	14380
Byte order:	Host
When to Set:	Can only be set during object initialization.

4.11.8. transport_lbtru_port_low (receiver)

Low port number to use for receiving LBT-RU data. All LBT-RU data for the topic will arrive on this range.

Scope:	receiver
Type:	lbm_uint16_t
Default value:	14360
Byte order:	Host
When to Set:	Can only be set during object initialization.

Prev	Home	Next
Transport LBT-RM Operation Options	Up	Transport LBT-RU Reliability Options