MQeOutput ノード

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

目的

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

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

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

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

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

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

  • MQReply
  • MQOutput
  • SCADAOutput
  • Publication

ワークベンチでは、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 Web page) にある WebSphere MQ Everyplace 資料を参照してください。

MQeOutput ノードの構成

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

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

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

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

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

ターミナルの接続

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

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

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

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

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

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

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

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

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

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

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

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

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

プロパティー M C デフォルト 説明
簡略説明 (Short Description) いいえ いいえ   ノードの簡単な説明
詳細説明 (Long Description) いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

関連概念
WebSphere MQ Mobile Transport
メッセージ・フロー
メッセージ・フロー・アプリケーションのデプロイメント

関連タスク
WebSphere MQ Everyplace シナリオ例の処理
使用するノードの決定
入出力に WebSphere MQ クラスター・キューを使用する
入出力に WebSphere MQ 共用キューを使用する (z/OS)
メッセージ・フローのエラー処理
構成可能プロパティーの編集

関連資料
WebSphere MQ Mobile Transport
MQeInput ノード
MQOutput ノード
MQReply ノード
SCADAOutput ノード
Output ノード