Open topic with navigation

TIBCO Rendezvous® 8.7.0

# tibrvftMemberCallback

Function Type

## Declaration

    typedef void (*tibrvftMemberCallback) (
        tibrvftMember    member,
        const char*      groupName,
        tibrvftAction    action,
        void*            closure);

## Purpose

Process fault tolerance events for a group member.

## Remarks

Each member program of a fault tolerance group must define a function of this type. Programs register a member callback function 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 function to activate, deactivate, or prepare to activate the program.

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

| • | When the number of active members exceeds the active goal, the fault tolerance callback function (in any active member that is outranked by another active member) receives the action token TIBRVFT_DEACTIVATE; the callback function 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 function (in the ranking inactive member) receives the action token TIBRVFT_PREPARE_TO_ACTIVATE; the callback function 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 function subsequently receives the TIBRVFT_ACTIVATE token, it will be ready to activate without delay.

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

Parameter | Description
`member` | 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 value of the enumerated type `tibrvftAction, which instructs the callback function to activate, deactivate or prepare to activate.`
`closure` | This parameter receives the closure data, which the program supplied in the call that created the member object.

## See Also

tibrvftAction

tibrvftMember_Create()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.