Configuration Guide

Multicast Immediate Messaging Network Options

The multicast address and port used for incoming and outgoing multicast immediate messages can be set with mim_address (context) and mim_destination_port (context) options.

Attention
  MIM reception is disabled by default. If you want an application to be able to receive MIM messages, you must set the configuration option mim_address (context) to the desired multicast group address.

A context may use different multicast addresses and/or ports for incoming and outgoing messages by setting one or more of:

- mim_incoming_address (context)
- mim_outgoing_address (context)
- mim_incoming_destination_port (context)
- mim_outgoing_destination_port (context)

In case of conflict, the most recently set option wins.

As with LBT-RM on multi-homed hosts, the interface UM uses for MIM follows the interface used with multicast topic resolution. See resolver_multicast_interface (context).

Warning
  The addresses and ports you configure for MIM traffic should not overlap with any addresses or ports - or address and port ranges - configured for LBT-RM transports or Topic Resolution traffic. For example, do not use the same multicast address for both Topic Resolution (resolver_multicast_address (context)) and MIM (mim_address (context)). Use different addresses and ports for all multicast address options and port options.

See also Multicast Immediate Messaging for general information on MIM.

# Reference <-

## mim_address (context) <-

  Convenience option to set both the incoming and outgoing multicast addresses for multicast immediate messages.

  See mim_outgoing_address (context) and mim_incoming_address (context) for their respective default values. See Multicast Immediate Messaging for general information about MIM.

  Scope: | context
  Type: | struct in_addr
  Default value: | n.a.
  When to Set: | Can only be set during object initialization.

## mim_destination_port (context) <-

  The UDP destination port that multicast immediate messages are sent to and received from.

  See Port Assignments for more information about configuring ports. See Multicast Immediate Messaging for general information about MIM.

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

## mim_incoming_address (context) <-

  The IP multicast address (or domain name of the multicast address) that multicast immediate messages are received from.

  IMPORTANT: The default value 0.0.0.0 disables reception of multicast immediate messages. See Multicast Immediate Messaging for general information about MIM.

  Scope: | context
  Type: | struct in_addr
  Default value: | 0.0.0.0
  When to Set: | Can only be set during object initialization.

## mim_incoming_destination_port (context) <-

  The UDP destination port that multicast immediate messages are received from.

  See Port Assignments for more information about configuring ports. See Multicast Immediate Messaging for general information about MIM.

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

## mim_outgoing_address (context) <-

  The IP multicast address (or domain name of the multicast address) that multicast immediate messages are sent to.

  See Multicast Immediate Messaging for general information about MIM.

  Scope: | context
  Type: | struct in_addr
  Default value: | 224.10.10.21
  When to Set: | Can only be set during object initialization.

## mim_outgoing_destination_port (context) <-

  The UDP destination port that multicast immediate messages are sent to.

  See Port Assignments for more information about configuring ports. See Multicast Immediate Messaging for general information about MIM.

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