MQeOutput ノード

重要: MQeInput および MQeOutput ノードを含むメッセージ・フローを WebSphere Message Broker バージョン 6.0 で使用することは推奨されていません。ここで説明されている動作は、バージョン 6.0 から前のバージョンにデプロイする場合のみを対象としており、マイグレーションの経路を提供することを意図しています。フローを再設計して、MQe ノードを除去し、独自の仕様に構成され MQe ゲートウェイ構成で調整された MQ ノードに置き換えてください。 詳細については、WebSphere MQ Everyplace ノードを含むメッセージ・フローのマイグレーションを参照してください。

このトピックには、以下のセクションが含まれています。

目的

WebSphere MQ Mobile Transport プロトコルを使用してブローカーに接続するクライアントへメッセージを送信するには、MQeOutput ノードを使用します。

MQeOutput ノードは、WebSphere MQ Everyplace キュー・マネージャーにメッセージを転送します。 非ローカルの宛先キュー・マネージャーが指定される場合、キュー・マネージャーへの経路があるか、またはもしあればキュー・マネージャーを提供している蓄積交換キューがあるかどうかを確かめてください。

MQeOutput ノードを使用して、メッセージ・フローのトランザクション特性を変更することはできません。 メッセージ・フローの入力ノードによって設定されるトランザクション特性が、フローのトランザクション動作を決定します。

z/OS システム上にデプロイするメッセージ・フローで、MQeOutput ノードを使用することはできません。

サブフローとして使用するメッセージ・フローを作成する場合には、標準出力ノードを使用することはできず、出力ノードのインスタンスを使用して、メッセージを伝搬するサブフロー用の out ターミナルを作成する必要があります。

メッセージ・フローでメッセージを WebSphere MQ Everyplace キューに送信したくない場合には、サポートされる別の出力ノードを選択できます。

ワークベンチでは、MQeOutput ノードは次のアイコンで表されます。

MQeOutput ノード・アイコン

メッセージ・フロー内でのこのノードの使用

このノードの使用方法の例として、自分の畑に十分に水がまかれているかをチェックする農場主について考慮します。 農場主は、WebSphere MQ Everyplace がインストールされている PDA を持ち歩いています。 畑に水がまかれていないことが分かると、PDA および Global Satellite Navigation リンクを使用して、水流を調整するバルブをチェックし、異常を発見します。 この情報を利用できたのは、ブローカーによって検索され、MQeOutput ノードとこの PDA 上の WebSphere MQ Everyplace クライアントに転送された診断メッセージを、バルブの制御を行うリモート SCADA 装置がパブリッシュしたからです。

WebSphere MQ Everyplace 資料

WebSphere MQ Everyplace とそのノードのプロパティーについて詳しくは、WebSphere MQ Web ページ にある WebSphere MQ Everyplace 資料を参照してください。

MQeOutput ノードの構成

MQeOutput ノードのインスタンスをメッセージ・フローに入れると、MQeOutput ノードを構成することができます。 エディター・ビューでノードを右クリックし、「プロパティー」をクリックします。 ノードの基本プロパティーが表示されます。

値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。

以下のように、MQeOutput ノードを構成します。

  1. 宛先モード」(後述) で「キュー名」を選択する場合は、出力メッセージの宛先を指定する「キュー・マネージャー名」および「キュー名」を入力します。 「宛先モード」で別のオプションを選択する場合、これらのプロパティーを設定する必要はありません。
  2. プロパティー・ダイアログ・ナビゲーターで「拡張」を選択し、ドロップダウン・リストから「宛先モード」を選択します。これにより、出力メッセージが送達されるキューが示されます。
    • 「キュー名」。 メッセージは、「キュー名」プロパティーで指定されたキューに送信されます。 このオプションを選択した場合は、「キュー・マネージャー名」プロパティーと「キュー名」プロパティー (「基本」タブ上) を指定する必要があります。これはデフォルトです。
    • 「キューへの応答」。 メッセージは、MQMD の「ReplyToQ」フィールドで指定されたキューに送信されます。
    • 「宛先リスト」。 メッセージは、そのメッセージに関連付けられている LocalEnvironment (DestinationList とも呼ばれる) に指定されたキューのリストへ送られます。
  3. プロパティー・ダイアログ・ナビゲーターで「要求」を選択し、プロパティーを設定して、生成された各出力メッセージの特性を定義します。
    1. 各出力メッセージに MQMD 内で要求メッセージ (MQMD_REQUEST) のマークを付け、WebSphere MQ が新しい ID を 確実に生成するようにメッセージ ID フィールドをクリアする (MQMI_NONE に設定する) ように指示するには、「要求」チェック・ボックスを選択します。すべての出力メッセージが要求メッセージとしてマークされないように指示するには、このチェック・ボックスのチェックを外します。 「キューへ応答」の「宛先モード」を選択した場合は、このチェック・ボックスを選択できません。
    2. 応答先キュー・マネージャー」に WebSphere MQ Everyplace キュー・マネージャー名を入力します。 これは、それぞれの出力メッセージの MQMD に応答先キュー・マネージャーとして挿入されます。 この新しい値は、MQMD の現行値をオーバーライドします。
    3. 応答先キュー」に WebSphere MQ Everyplace キュー名を入力します。 これは、それぞれの出力メッセージの MQMD に応答先キューとして挿入されます。 この新しい値は、MQMD の現行値をオーバーライドします。
  4. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明」を選択します。
  5. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに MQeOutput ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。

    「キャンセル」をクリックすると、ダイアログを閉じてプロパティーに対して行った変更をすべて破棄します。

ターミナルの接続

in ターミナルを、ルーティングされるアウトバウンド・メッセージの元になるノードに接続します。

メッセージをさらに処理したい場合、エラーを処理したい場合、あるいはメッセージを追加の宛先に送信したい場合は、このノードの out ターミナルまたは failure ターミナルをこのメッセージ・フローの別のノードに接続します。

そのようにする場合、メッセージに関連した LocalEnvironment は拡張され、このノードによってメッセージが送られた宛先ごとに以下の情報が追加されます。

  • キュー名
  • キュー・マネージャー名
  • メッセージ応答 ID (これはメッセージ ID と同じ値に設定されます)
  • メッセージ ID (MQMD から)
  • 相関 ID (MQMD から)

これらの値は、LocalEnvironment ツリー構造内の WrittenDestination に書き込まれます。

いずれかのターミナルを接続しないと、LocalEnvironment ツリーは変更されません。

メッセージ・フローで集約を使用する場合には、これらのターミナルを使用する必要があります。

ターミナルおよびプロパティー

MQeOutput ノード・ターミナルについては、次の表に説明されています。

ターミナル 説明
In ノードが処理するメッセージを受け入れる入力ターミナル。
Failure メッセージの出力キューへの書き込みに失敗した場合にメッセージがルーティングされる出力ターミナル。
Out 出力キューに正常に書き込まれた場合に、またはこのメッセージ・フロー内でさらに処理が必要な場合にメッセージがルーティングされる出力ターミナル。

以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。

MQeOutput ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
キュー・マネージャー名 いいえ はい   キュー名」に指定された出力キューを定義する WebSphere MQ Everyplace キュー・マネージャーの名前。
キュー名 いいえ はい   このノードがメッセージを書き込む WebSphere MQ Everyplace 出力キューの名前。

MQeOutput ノードの「拡張」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
宛先モード はい いいえ 宛先リスト 出力メッセージの送信先のキュー。 有効な値は、「キュー名」「キューへ応答」、および「宛先リスト」です。

MQeOutput ノードの「要求」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
要求 はい いいえ 選択されていない すべての出力メッセージが要求メッセージとして生成されるかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。
応答先キュー・マネージャー いいえ はい   応答先キュー」に指定された出力キューを定義するキュー・マネージャーの名前。
応答先キュー いいえ はい   この要求に対する応答が置かれる応答キューの名前。

MQeOutput ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ac04610_