このトピックには、以下のセクションが含まれています。
WebSphere MQ Mobile Transport プロトコルを使用してブローカーに接続するクライアントへメッセージを送信するには、MQeOutput ノードを使用します。
MQeOutput ノードは、WebSphere MQ Everyplace キュー・マネージャーにメッセージを転送します。 非ローカルの宛先キュー・マネージャーが指定される場合、キュー・マネージャーへの経路があるか、またはもしあればキュー・マネージャーを提供している蓄積交換キューがあるかどうかを確かめてください。
MQeOutput ノードを使用して、メッセージ・フローのトランザクション特性を変更することはできません。 メッセージ・フローの入力ノードによって設定されるトランザクション特性が、フローのトランザクション動作を決定します。
z/OS システム上にデプロイするメッセージ・フローで、MQeOutput ノードを使用することはできません。
サブフローとして使用するメッセージ・フローを作成する場合には、標準出力ノードを使用することはできず、出力ノードのインスタンスを使用して、メッセージを伝搬するサブフロー用の out ターミナルを作成する必要があります。
メッセージ・フローでメッセージを WebSphere MQ Everyplace キューに送信したくない場合には、サポートされる別の出力ノードを選択できます。
ワークベンチでは、MQeOutput ノードは次のアイコンで表されます。
このノードの使用方法の例として、自分の畑に十分に水がまかれているかをチェックする農場主について考慮します。 農場主は、WebSphere MQ Everyplace がインストールされている PDA を持ち歩いています。 畑に水がまかれていないことが分かると、PDA および Global Satellite Navigation リンクを使用して、水流を調整するバルブをチェックし、異常を発見します。 この情報を利用できたのは、ブローカーによって検索され、MQeOutput ノードとこの PDA 上の WebSphere MQ Everyplace クライアントに転送された診断メッセージを、バルブの制御を行うリモート SCADA 装置がパブリッシュしたからです。
WebSphere MQ Everyplace とそのノードのプロパティーについて詳しくは、WebSphere MQ Web ページ にある WebSphere MQ Everyplace 資料を参照してください。
MQeOutput ノードのインスタンスをメッセージ・フローに入れると、MQeOutput ノードを構成することができます。 エディター・ビューでノードを右クリックし、「プロパティー」をクリックします。 ノードの基本プロパティーが表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。
以下のように、MQeOutput ノードを構成します。
「キャンセル」をクリックすると、ダイアログを閉じてプロパティーに対して行った変更をすべて破棄します。
in ターミナルを、ルーティングされるアウトバウンド・メッセージの元になるノードに接続します。
メッセージをさらに処理したい場合、エラーを処理したい場合、あるいはメッセージを追加の宛先に送信したい場合は、このノードの out ターミナルまたは failure ターミナルをこのメッセージ・フローの別のノードに接続します。
そのようにする場合、メッセージに関連した LocalEnvironment は拡張され、このノードによってメッセージが送られた宛先ごとに以下の情報が追加されます。
これらの値は、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 | デフォルト | 説明 |
---|---|---|---|---|
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |