TibrvFtMember::setWeight()

Method

Declaration

TibrvStatus setWeight(
    tibrv_u16  weight);

Purpose

Change the weight of a fault tolerance member within its group.

Remarks

Weight summarizes the relative suitability of a member for its task, relative to other members of the same fault tolerance group. That suitability is a combination of computer speed and load factors, network bandwidth, computer and network reliability, and other factors. Programs may reset their weight when any of these factors change, overriding the previous assigned weight.

You can use relative weights to indicate priority among group members.

Zero is a special value; Rendezvous fault tolerance software assigns zero weight to processes with resource errors, so they only activate when no other members are available. Programs must always assign weights greater than zero.

When Rendezvous fault tolerance software requests a resource but receives an error (for example, the member process cannot allocate memory, or start a timer), it attempts to send the member process a DISABLING_MEMBER advisory message, and sets the member’s weight to zero, effectively disabling the member. Weight zero implies that this member is active only as a last resort—when no other members outrank it. (However, if the disabled member process does become active, it might not operate correctly.)

Parameter	Description
weight	The new weight value. See weight.

See Also

Adjusting Member Weights in TIBCO Rendezvous Concepts.