com.ibm.mq

クラス MQDistributionList

java.lang.Object

com.ibm.mq.jmqi.JmqiObject

com.ibm.mq.MQManagedObject

com.ibm.mq.MQDistributionList

公開クラス MQDistributionList
MQManagedObject を継承します。

MQDistributionList コンストラクターまたは MQQueueManager.accessDistributionList() メソッドを使用して、配布リストを作成します。 配布リストは、put メソッドへの単一の呼び出しを使用してメッセージを送信できるオープン・キューのセットを表します。

フィールドの要約

クラス com.ibm.mq.MQManagedObject から継承されたフィールド

alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions

クラス com.ibm.mq.jmqi.JmqiObject から継承されるフィールド

COMP_JM, COMP_JN, COMP_JO

コンストラクターの要約

コンストラクター

コンストラクターおよび説明
MQDistributionList(MQQueueManager qMgr, MQDistributionListItem[] litems, int openOptions, java.lang.String alternateUserId) 新しい配布リストを作成し、キューを開きます。

メソッドの要約

修飾子と型	メソッドおよび説明
void	close() 配布リストをクローズします。
MQDistributionListItem	getFirstDistributionListItem() 配布リストの最初のアイテムを取得します。リストが空の場合は null を取得します。
int	getInvalidDestinationCount() 配布リスト内の、正常に開くことができなかった項目の数を取得します。
int	getValidDestinationCount() 配布リスト内で正常に開かれた項目の数を取得します。
void	put(MQMessage message, MQPutMessageOptions putMessageOptions) 配布リスト上のキューにメッセージを書き込みます。

クラス com.ibm.mqから継承されたメソッド。MQManagedObject

getAlternateUserId, getAttributeString, getCloseOptions, getConnectionReference, getDescription, getName, getOpenOptions, getResolvedObjectString, getResolvedQName, getResolvedType, inquire, inquire, isOpen, set, setAttributeString, setCloseOptions

クラス com.ibm.mq.jmqi.JmqiObject から継承されたメソッド

getJmqiEnvironment

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクターの詳細

MQDistributionList

public MQDistributionList(MQQueueManager qMgr,
                          MQDistributionListItem[] litems、
                          int openOptions、
                          java.lang.String alternateUserId)
                   MQException をスローします。

新しい配布リストを作成し、キューを開きます。

パラメーター:

qMgr -リストのオープン先のキュー・マネージャー。

litems -配布リストに組み込まれるアイテム。

openOptions -配布リストのオープンを制御するオプション。

alternateUserId - openOptionsで MQOO_ALTERNATE_USER_AUTHORITY が指定されている場合に、キューをオープンするための権限を検査するために使用される代替ユーザー ID。 そうでない場合、このパラメーターはブランク (またはヌル) のままにすることができます。

スロー:

MQException -呼び出しが完全に失敗した場合にのみスローされます。 少なくとも 1 つのキューが正常にオープンすると、コンストラクターは完了します。

メソッドの詳細

put

public void put (MQMessage メッセージ、
                MQPutMessageオプション putMessageオプション)
         MQException をスローします。

配布リスト上のキューにメッセージを書き込みます。

パラメーター:

message -メッセージ記述子情報および戻されたメッセージ・データ。

putMessageOptions -MQPUT のアクションを制御します。

スロー:

MQException -書き込みが失敗した場合。

close

public void close()
           MQException をスローします。

配布リストをクローズします。

オーバーライド:

closeクラス内MQManagedObject

スロー:

MQException -クローズが失敗した場合。

getValidDestinationCount

public int getValidDestinationCount()

配布リスト内で正常に開かれた項目の数を取得します。

戻り値:

項目数。

getInvalidDestinationCount

public int getInvalidDestinationCount()

配布リスト内の、正常に開くことができなかった項目の数を取得します。

戻り値:

項目数。

getFirstDistributionListアイテム

public MQDistributionListItem getFirstDistributionListItem ()

配布リストの最初のアイテムを取得します。リストが空の場合は null を取得します。

戻り値:

最初の項目。