このトピックには、以下のセクションが含まれています。
WebSphere MQ Enterprise Transport を使用してブローカーに接続し、MQI および AMI アプリケーション・プログラミング・インターフェースを使用するクライアントへメッセージを送信するには、MQOutput ノードを使用します。
MQOutput ノードは、出力メッセージをメッセージ・フローから WebSphere MQ キューに送達します。 このノードは、MQPUT を使用して、指定する宛先キュー (複数も可) にメッセージを書き込みます。
MQOutput ノードを構成して、ブローカーのキュー・マネージャーからアクセス可能な任意のキュー・マネージャーに定義された特定の WebSphere MQ キューに、またはメッセージに関連付けられた LocalEnvironment (DestinationList としても知られる) で識別される宛先に、メッセージを書き込むことができます。
ほかのプロパティーを設定すると、適切な MQPUT オプションを設定できるので、メッセージを受け取る方法を制御できます。 たとえば、メッセージをトランザクション制御下で処理するように要求できます。 さらに WebSphere MQ が必要に応じて、メッセージをキュー・マネージャーでいくつかのセグメントに分けるように指定できます。
サブフローとして使用するメッセージ・フローを作成する場合には、標準出力ノードを使用することはできず、出力ノードのインスタンスを使用して、メッセージを伝搬するサブフロー用の out ターミナルを作成する必要があります。
メッセージ・フローでメッセージを WebSphere MQ キューに送信したくない場合には、サポートされる別の出力ノードを選択できます。
ワークベンチでは、MQOutput ノードは次のアイコンで表されます。
このノードが使用される方法に関しては、次のサンプルを参照してください。
このノードの使用方法を示す例として、定期的に株価の更新をパブリッシュするようなパブリッシング・アプリケーションを作成したと仮定します。 アプリケーションは MQInput ノード上のブローカーにメッセージを送信し、メッセージ・フローは Publication ノードを通して、パブリケーションを複数のサブスクライバーに対して使用可能にします。 特定の株式に変更が生じるたびに新しい出力メッセージを作成するよう Compute ノードを構成し、これを MQOutput ノードに接続して、この株式の価格に変動が生じるたびにこれを記録します。
MQOutput ノードのインスタンスをメッセージ・フローに入れると、MQOutput ノードを構成することができます。 エディター・ビューでノードを右マウス・ボタンでクリックし、「プロパティー (Properties)」をクリックします。 ノードの基本プロパティーが表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。
以下のように、MQOutput ノードを構成します。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、「WebSphere MQアプリケーション・プログラミング・リファレンス」を参照してください。
「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。
in ターミナルを、ルーティングされるアウトバウンド・メッセージの元になるノードに接続します。
メッセージをさらに処理したい場合、エラーを処理したい場合、あるいはメッセージを追加の宛先に送信したい場合は、このノードの out ターミナルまたは failure ターミナルをこのメッセージ・フローの別のノードに接続します。
これらの出力ターミナルの 1 つをメッセージ・フロー内の別のノードに接続すると、メッセージに関連した LocalEnvironment は拡張され、このノードによってメッセージが送られた宛先ごとに以下の情報が追加されます。
これらの値は、LocalEnvironment ツリー構造内の WrittenDestination に書き込まれます。
いずれかのターミナルを接続しないと、LocalEnvironment ツリーは変更されません。
メッセージ・フローで集約を使用する場合には、out ターミナルを使用する必要があります。
MQOutput ノードを定義するときに、「トランザクション・モード (Transaction Mode)」プロパティーに選択する次のようなオプションで、メッセージを同期点下に書き込むかどうかを定義します。
MQOutput ノードのもう 1 つのプロパティー「持続モード (Persistence Mode)」は、出力キューに出力メッセージを書き込むときに持続のマークを付けるかどうかを定義します。
MQOutput ノード・ターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
Failure | メッセージの出力キューへの書き込みに失敗した場合にメッセージがルーティングされる出力ターミナル。 |
Out | 出力キューに正常に書き込まれた場合に、またはこのメッセージ・フロー内でさらに処理が必要な場合にメッセージがルーティングされる出力ターミナル。 |
以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。
MQOutput ノードの「基本 (Basic)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
キュー・マネージャー名 (Queue Manager Name) | いいえ | はい | 「キュー名 (Queue Name)」に指定された出力キューを定義する WebSphere MQ キュー・マネージャーの名前。 | |
キュー名 (Queue Name) | いいえ | はい | このノードがメッセージを書き込む (MQPUT を使用して) WebSphere MQ 出力キューの名前。 |
MQOutput ノードの「拡張 (Advanced)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
宛先モード (Destination Mode) | はい | いいえ | キュー名 (Queue Name) | 出力メッセージの送信先のキュー。有効な値は、「キュー名 (Queue Name)」、「宛先リスト (Destination List)」、 および「キューへ応答 (Reply To Queue)」です。 |
トランザクション・モード (Transaction Mode) | はい | いいえ | 自動 (Automatic) | メッセージをトランザクションとして書き込むかどうか。 有効な値は、「自動 (Automatic)」、「はい (Yes)」、および「いいえ (No)」です。 |
持続モード (Persistence Mode) | はい | いいえ | 自動 (Automatic) | メッセージを持続的に書き込むかどうか。 有効な値は、「自動 (Automatic)」、「はい (Yes)」、「いいえ (No)」および「キューの定義どおり (As Defined for Queue)」です。 |
新規メッセージ ID (New Message ID) | はい | いいえ | 選択されていない | WebSphere MQ が新しいメッセージ ID を生成して、MQMD の MsgId フィールドの内容を置き換えるかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。 |
新規相関 ID (New Correlation ID) | はい | いいえ | 選択されていない | WebSphere MQ が新しい相関 ID を生成して、MQMD の CorrelId フィールドの内容を置き換えるかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。 |
セグメント化可能 (Segmentation Allowed) | はい | いいえ | 選択されていない | WebSphere MQ が必要に応じて、メッセージをキュー・マネージャーでいくつかのセグメントに分けます。 チェック・ボックスを選択すると、このアクションが実行されます。 |
メッセージ・コンテキスト (Message Context) | はい | いいえ | すべて渡す (Pass All) | 元のコンテキストの処理方法。 有効な値は、「すべて渡す (Pass All)」、「ID を渡す (Pass Identity)」、「すべてを設定する (Set All)」、「ID を設定する (Set Identity)」および「デフォルト (Default)」です。 |
代替ユーザー・セキュリティー (Alternate User Authority) | はい | いいえ | 選択されていない | 出力メッセージを書き込む時に代替権限を使用するかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。 |
MQOutput ノードの「要求 (Request)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
要求 (Request) | はい | いいえ | 選択されていない | 要求メッセージとしてそれぞれの出力メッセージを生成するかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。 |
応答先キュー・マネージャー (Reply-to queue manager) | いいえ | はい | 「応答先キュー (Reply-to-queue)」に指定された出力キューを定義する WebSphere MQ キュー・マネージャーの名前。 | |
応答先キュー (Reply-to queue) | いいえ | はい | この要求に対する応答が置かれる WebSphere MQ 応答キューの名前。 |
MQOutput ノードの「説明 (Description)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
簡略説明 (Short Description) | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 (Long Description) | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
関連概念
WebSphere MQ Enterprise Transport
メッセージ・フロー
LocalEnvironment ツリー
ユーザー定義拡張機能
メッセージ・フロー・アプリケーションのデプロイメント
関連タスク
使用するノードの決定
整合されたメッセージ・フローの構成
メッセージ・フローのエラー処理
入出力に WebSphere MQ クラスター・キューを使用する
入出力に WebSphere MQ 共用キューを使用する (z/OS)
宛先リストの作成
集約フローの構成
構成可能プロパティーの編集
関連資料
MQeOutput ノード
MQInput ノード
MQReply ノード
Output ノード
SCADAOutput ノード
注意 |
商標 |
ダウンロード |
ライブラリー |
技術サポート |
フィードバック
![]() ![]() |
ac04570_ |