MQDistributionList

 



java.lang.Object
   |
   *- com.ibm.mq.MQManagedObject
          |
          *- com.ibm.mq.MQDistributionList

public class MQDistributionList
extends MQManagedObject (See topic "MQManagedObject".)

Create an MQDistributionList using the MQDistributionList constructor or the accessDistributionList method for MQQueueManager.

A distribution list represents a set of open queues to which messages can be sent using a single call to the put() method. (See "Distribution lists" in the WebSphere MQ Application Programming Guide.)

 

Constructors

MQDistributionList
public MQDistributionList MQQueueManager(qMgr,
               MQDistributionListItem[] litems,
               int openOptions,
               String alternateUserId)
                          throws MQException

qMgr is the queue manager where the list is to be opened.

litems are the items to be included in the distribution list.

See accessDistributionList for details of the remaining parameters.

 

Methods

getFirstDistributionListItem
public MQDistributionListItem getFirstDistributionListItem()

Returns the first item in the distribution list, or null if the list is empty.

getInvalidDestinationCount
public int getInvalidDestinationCount()

Returns the number of items in the distribution list that failed to open successfully.

getValidDestinationCount
public int getValidDestinationCount()

Returns the number of items in the distribution list that were opened successfully.

put
public synchronized void put MQMessage(message,
              MQPutMessageOptions putMessageOptions )
                            throws MQException

Puts a message to the queues on the distribution list.

Parameters

message
An input/output parameter containing the message descriptor information and the returned message data.

putMessageOptions
Options that control the action of MQPUT. (See MQPutMessageOptions for details.)

Throws MQException if the put fails.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.