TibrvFtMemberCallback::onFtAction()

Method

Declaration

virtual void onFtAction(
    TibrvFtMember* ftMember,
    const char* groupName,
    tibrvftAction action ) = 0;

Purpose

Process fault tolerance events for a group member.

Remarks

Each member program of a fault tolerance group must implement this method. Programs register a member callback object (and this method) with each call to TibrvFtMember::create().

Rendezvous fault tolerance software queues a member action event in three situations. In each case, it passes a different action argument, instructing the callback method to activate, deactivate, or prepare to activate the program.

•

When the number of active members drops below the active goal, the fault tolerance callback method (in the ranking inactive member process) receives the token TIBRVFT_ACTIVATE; the callback method must respond by assuming the duties of an active member.

•

When the number of active members exceeds the active goal, the fault tolerance callback method (in any active member that is outranked by another active member) receives the action token TIBRVFT_DEACTIVATE; the callback method must respond by switching the program to its inactive state.

•

When the number of active members equals the active goal, and Rendezvous fault tolerance software detects that it might soon decrease below the active goal, the fault tolerance callback method (in the ranking inactive member) receives the action token TIBRVFT_PREPARE_TO_ACTIVATE; the callback method must respond by making the program ready to activate immediately. For example, preparatory steps might include time-consuming tasks such as connecting to a database. If the callback method subsequently receives the TIBRVFT_ACTIVATE token, it will be ready to activate without delay.

This token is a hint, indicating that the program might soon receive an instruction to activate. It does not guarantee that an activate instruction will follow, nor that any minimum time will elapse before an activate instruction follows.

For additional information see Fault Tolerance Callback Actions in TIBCO Rendezvous Concepts.

Parameter	Description
ftMember	This parameter receives the member object.
groupName	This parameter receives a string denoting the name of the fault tolerance group.
action	This parameter receives a token that instructs the callback method to activate, deactivate or prepare to activate. See tibrvftAction.

See Also

TibrvFtMember::create()

Fault Tolerance Callback Actions in TIBCO Rendezvous Concepts