Class: TStandardCaucusResumeMessage

Declaration: StandardCaucus.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

TStandardCaucusResumeMessage is used to send a resume message to a caucus. The client sends a resume message by creating a TStandardCaucusResumeMessage object, streaming data into it, and destroying the object. To pause the caucus initially, send a TStandardCaucusPauseMessage. Pausing means any messages sent after the pause message are queued internally. Only after a resume are the pending messages released. Pausing allows a member to synchronize shared data among members. A member sending a pause message knows all messages have been received when that member receives its own pause message. Only the member who sent the original pause message can resume. Additional pause messages sent by other members are queued with all other messages until the first pause is resumed. Join and Leave messages are also queued if the caucus is paused. A member that has paused the caucus should send a resume message before leaving the caucus. TStandardCaucusPauseMessage and TStandardCaucusResumeMessage should always be constructed on the stack.

Instantiation:

Always allocate on the stack.

Deriving Classes:

Do not derive from this class.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Member Function: TStandardCaucusResumeMessage::TStandardCaucusResumeMessage

TStandardCaucusResumeMessage (TStandardCaucusMember * memberAlias)

Interface Category:

API.

Purpose:

Creates a new TStandardCaucusResumeMessage to send a message for the specified member. Initiates the resume operation.

Calling Context:

Called by the caucus member sending the resume message.

Parameters:

TStandardCaucusMember * memberAlias -The sender of the message. It must not be NIL.

Return Value:

None.

Exceptions:

Throws TCaucusException::kNotInCaucus if the member has not joined or is not longer a member of the caucus. All others are passed through.

Concurrency:

Multithread safe.

Other Considerations:

Always allocate on stack.

Member Function: TStandardCaucusResumeMessage::~TStandardCaucusResumeMessage

~ TStandardCaucusResumeMessage ()

Interface Category:

API.

Purpose:

Destructor. Completes the resume message (for example, calls the member's EndResume member function).

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws TCaucusException::kNotInCaucus if the member has not joined or is not longer a member of the caucus. All others are passed through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TStandardCaucusResumeMessage::operatorTStream&

operator TStream & () const

Interface Category:

API.

Purpose:

Returns the stream used to send the message.

Calling Context:

You do not need to call this function directly. The compiler should generate a stream conversion operator for you when you stream data in to this object.

Parameters:

Takes no parameters.

Return Value:

Returns the stream used to send the message.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

There might be times when you need to explicitly call this conversion operator directly (for example, if the compiler doesn't or cannot do it for you).

Click the icon to mail questions or corrections about this material to Taligent personnel.