Load Balancing Mode


Type:	Enumerated value of C type T_IPC_LB_MODE
Default Value:	The message type load balancing mode is used. The message type load balancing mode default is T_IPC_LB_NONE.
Valid Values:	T_IPC_LB_NONE T_IPC_LB_ROUND_ROBIN T_IPC_LB_SORTED T_IPC_LB_WEIGHTED

In normal publish-subscribe operation, a message is sent to all RTclients that have subscribed to the subject the message is being published to. However, in some situations you may wish to have messages sent to only one subscribing RTclient. Load balancing can only be used for RTclient publish-subscribe connections, not peer-to-peer connections. By default, messages are not load balanced and are distributed to all subscribers. For a detailed discussion of load balancing, see Load Balancing. The four possible load balancing modes are:


T_IPC_LB_NONE	No load balancing (this is the default).
T_IPC_LB_ROUND_ROBIN	Go to each subscriber in turn.
T_IPC_LB_SORTED	Go to the subscriber in lowest lexicographical order (sorted by unique subject).
T_IPC_LB_WEIGHTED	Go to the subscriber with the lightest load (fewest number of unacknowledged messages).

Function to set value:

TipcMsgSetLbMode. For example:

if (!TipcMsgSetLbMode(msg, T_IPC_LB_ROUND_ROBIN)) { 
  /* error */ 
}

Function to get value:

TipcMsgGetLbMode. For example:

if (!TipcMsgGetLbMode(msg, &lb_mode)) { 
  /* error */ 
}