FTGroupMember
Class
Superclasses
System.Object
FTGroupMember
Visual Basic
Public Class FTGroupMember
C#
public class FTGroupMember
Purpose
Represent membership in a fault tolerance group.
Remarks
Upon creating this object, the program joins a fault tolerance group.
By destroying a member object, the program withdraws its membership in the fault tolerance group. The method FTGroupMember.Destroy destroys a member object explicitly and immediately. You can also destroy a member object implicitly by deleting all references to it, but the garbage collector might introduce a delay before it destroys the object.
Destroying the queue or transport of a member object automatically destroys the member object as well.
|
Member |
Description |
|
Public Instance Properties |
||
|
The group member joins the fault tolerant group with this name. |
Get |
|
Fault tolerance events for this member dispatch from this event queue. |
Get |
|
The group member uses this transport for fault tolerance internal protocol messages (such as heartbeat messages). |
Get |
|
Weight represents the ability of this member to fulfill its purpose, relative to other members of the same fault tolerance group. Rendezvous fault tolerance software uses relative weight values to select which members to activate; members with higher weight take precedence over members with lower weight. Acceptable values range from 1 to 65535. Zero is a special, reserved value; Rendezvous fault tolerance software assigns zero weight to processes with resource errors, so they only activate when no other members are available. For more information, see Weight below. |
Get Set |
Public Events |
||
|
ActionTokenReceivedEventHandler An action token arrived. |
|
|
Method |
Description |
Page |
Weight
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.)
For more information, see these sections:
| • | Rank and Weight in . |
| • | Adjusting Member Weights in . |