ImqDistributionList

Figure 9. ImqDistributionList class

This class encapsulates a dynamic distribution list that references one or more queues for the purpose of sending a message or messages to multiple destinations.

Other relevant classes

ImqMessage (see ImqMessage)

ImqQueue (see ImqQueue)

Object attributes

first distributed queue

The first of one or more objects of class ImqQueue, in no particular order, in which the ImqQueue distribution list reference addresses this object.

Initially there are no such objects. To open an ImqDistributionList successfully, there must be at least one such object.

Note:

When an ImqDistributionList object is opened, any open ImqQueue objects that reference it are automatically closed.

Constructors

ImqDistributionList( );

The default constructor.

ImqDistributionList( const ImqDistributionList & list );

The copy constructor.

Object methods (public)

void operator = ( const ImqDistributionList & list );

All ImqQueue objects that reference this object are dereferenced prior to copying. No ImqQueue objects will reference this object after the invocation of this method.

ImqQueue * firstDistributedQueue( ) const ;

Returns the first distributed queue.

Object methods (protected)

void setFirstDistributedQueue( ImqQueue * queue = 0 );

Sets the first distributed queue.