TipcMtSetPriority

Name

TipcMtSetPriority — set the priority of a message type

Synopsis

T_BOOL TipcMtSetPriority(mt, priority) 
T_IPC_MT mt; 
T_INT2 priority; 

Arguments

mt — message type to set priority for

priority — message type priority

Return Values

TRUE if the priority was successfully set for the message type, FALSE otherwise.

Diagnostics

If TipcMtSetPriority fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMtSetPriority sets the priority of a message type. The priority of a message type, if set, is used as the default priority for messages of this type. See TipcMtGetPriority for more information on message type priorities.

Use the function TipcMtSetPriorityUnknown to set the message type priority to unknown.

Caution

Setting message priorities on GMD or load-balanced (LB) messages is not recommended. GMD and LB rely on high sequence numbers for correct functioning, and unexpected behavior may occur if such messages are received out of order due to the use of message priorities.

See Also

TipcMsgSetPriority, TipcMtGetPriority, TipcMtSetPriorityUnknown

Examples

This example sets the priority of the NUMERIC_DATA message type to 2:

T_IPC_MT mt; 
 
mt = TipcMtLookup("numeric_data"); 
if (mt == NULL) { 
  return;  /* error */ 
} 
 
if (!TipcMtSetPriority(mt, 2)) { 
  return;  /* error */ 
}