このトピックには、以下のセクションが含まれています。
WebSphere MQ Enterprise Transport を使用してブローカーに接続し、MQI および AMI アプリケーション・プログラミング・インターフェースを使用するクライアントへメッセージを送信するには、MQOutput ノードを使用します。
MQOutput ノードは、出力メッセージをメッセージ・フローから WebSphere MQ キューに送達します。 このノードは、MQPUT を使用して、指定する宛先キュー にメッセージを書き込みます。
MQOutput ノードを構成して、ブローカーのキュー・マネージャー
ほかのプロパティーを設定すると、適切な MQPUT オプションを設定できるので、メッセージを受け取る方法を制御できます。 たとえば、メッセージをトランザクション制御下で処理するように要求できます。 さらに WebSphere MQ が必要に応じて、メッセージをキュー・マネージャーでいくつかのセグメントに分けるように指定できます。
サブフローとして使用するメッセージ・フローを作成する場合には、標準出力ノードを使用することはできず、出力ノードのインスタンスを使用して、メッセージを伝搬するサブフロー用の out ターミナルを作成する必要があります。
メッセージ・フローでメッセージを WebSphere MQ キューに送信したくない場合には、サポートされる別の出力ノードを選択できます。
ワークベンチでは、MQOutput ノードは次のアイコンで表されます。
このノードの使用方法を示す例として、定期的に株価の更新をパブリッシュするようなパブリッシング・アプリケーションを作成したと仮定します。 アプリケーションは MQInput ノード上のブローカーにメッセージを送信し、メッセージ・フローは Publication ノードを通して、パブリケーションを複数のサブスクライバーに対して使用可能にします。 価格に変動が生じるたびにこれを記録するアプリケーションへメッセージを送信するため、MQOutput ノードを組み込みます。
MQOutput ノードのインスタンスをメッセージ・フローに入れると、MQOutput ノードを構成することができます。 エディター・ビューでノードを右マウス・ボタンでクリックし、「プロパティー (Properties)」をクリックします。 ノードの基本プロパティーが表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。
以下のように、MQOutput ノードを構成します。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、WebSphere MQアプリケーション・プログラミング・リファレンス を参照してください。
このプロパティーのマップ先のオプションの詳細については、「WebSphere MQアプリケーション・プログラミング・リファレンス」を参照してください。
「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。
in ターミナルを、ルーティングされるアウトバウンド・メッセージの元になるノードに接続します。
メッセージを追加の宛先に送信したい場合は、このノードの out ターミナルまたは failure ターミナルをこのメッセージ・フローの別のノードに接続します。
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)」 および「キューへ応答 (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) | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
注意 |
商標 |
ダウンロード |
ライブラリー |
技術サポート |
フィードバック
![]() ![]() |
ac04570_ |