JMSOutput ノードを使用して、JMS 宛先にメッセージを送信します。
JMSOutput ノードは JMS メッセージ・プロデューサーとして機能して、Java Message Service Specification、バージョン 1.1 で定義された 6 つのメッセージ・タイプのすべてをパブリッシュすることができます。 メッセージは、JMS 仕様で説明されているメソッド呼び出しを使用してパブリッシュされます。
JMSOutput ノードはパレットの JMS ドロワーに含まれていて、WebSphere® Message Broker Toolkit では次のアイコンによって表されます。

サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。
JMS プロバイダーへの接続から受け取ったメッセージを処理するメッセージ・フローは、常に JMSInput ノードで開始する必要があります。 JMSOutput ノードをメッセージ・フロー内に含める場合、JMSInput ノードを含める必要はありませんが、JMSInput ノードを組み込まない場合 MQJMSTransform ノードを組み込んで、JMSOutput ノードで規定されている形式にメッセージを変換する必要があります。
JMS メッセージを伝搬して、サブフローとして使用するメッセージ・フローを作成する場合、JMSOutput ノードのインスタンスを最終ノードとして使用して、そのサブフロー用の Out ターミナルを作成します。
SET OutputRoot.JMSTransport.Transport_Folders.Message_MetaData.PayloadType=Payload value
JMS メッセージ・ツリーおよびペイロード値について詳しくは、JMS トランスポートでのメッセージの表現を参照してください。
CREATE PROCEDURE CreateJMSDestinationList() BEGIN
SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[1] = 'jndi://TestDestQueue1';
SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[2] = 'jndi://TestDestQueue2';
SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[3] = 'jndi://TestDestQueue3';
END;
多数の JMS プロバイダー用の構成可能サービスが定義されています。 事前定義サービスのうちの 1 つを選択できますが、新規プロバイダーまたは既存プロバイダーのうちの 1 つのための新しいサービスを作成することもできます。 事前定義サービスは構成可能サービスのプロパティーにリストされています。
プロバイダーのプロパティーを表示するには mqsireportproperties コマンドを使用し、プロパティーを設定または変更するには mqsichangeproperties コマンドを使用します。
異なるバージョンの JMS プロバイダーに接続するには、JMS プロバイダーのバージョンごとに JMSProviders 構成可能サービスを作成した後、jarsURL プロパティーに固有のパスを設定します。
メッセージの送信側が受信側に対してメッセージへの応答を希望する場合があります。その場合、JMSOutput メッセージは出力メッセージを応答として扱い、要求メッセージの JMSReplyTo プロパティーから得られた値に応じてそれをルーティングすることができます。MbMessage の JMSReplyTo プロパティーの値を、例えば Compute ノードまたは JavaCompute ノードを使って変更することができます。このアクションにより、JMSOutput ノードからのメッセージの動的ルーティングが可能になります。 ノードは、MbMessage ツリーの JMSReplyTo フィールドに設定される JMS 宛先名にメッセージを送信します。
queue://QM_mn2/myJMSQueue4
この場合の値は、WebSphere MQ JMS プロバイダーの JMS 宛先の、JMS プロバイダー固有の表記になります。jndi://jmsQ4
jmsQ4 は、JNDI 管理対象オブジェクトの名前です。この方式を使用すると、JNDI で管理対象オブジェクトを検索する必要が生じるため、パフォーマンスに影響を及ぼす可能性があります。
JMSOutput ノードが出力メッセージに JMSReplyTo プロパティーを動的に設定できるようにするには、「基本」 タブの 「宛先の応答」 フィールドをブランクのままにし、Compute ノードまたは JavaCompute ノードを使って MbMessage に JMSReplyTo 値を設定します。
ノードは JNDI 管理対象オブジェクトの名前 (「パブリケーション・トピック」または「宛先キュー」のどちらかに指定したもの) を解決し、その JMS 宛先にメッセージを送信します。
cciOutputMessageCallback 関数は、コールバックとして登録することができ、メッセージが JMSOutput ノードから送信されるたびに呼び出されます。cciOutputMessageCallbackを参照してください。
ユーザー出口の状態がアクティブの場合、cciOutputMessageCallback 関数は、コールバックが登録されている JMSOutput ノードから正常に送信される出力メッセージごとに呼び出されます。
ノードが LocalEnvironment ツリーで WrittenDestination 情報を提供する場合、コールバックはこの情報が作成された後に呼び出されます。JMSOutput ノードと JMSReply ノードでの LocalEnvironment 変数の使用を参照してください。
Compute ノードを JMSOutput ノードの Out ターミナルに接続し、WrittenDestination リストを問い合わせます。詳しくは、トレース出力に論理メッセージ・ツリーを表示するを参照してください。
WrittenDestination = (
JMS = (
DestinationData = (
destinationName = 'queue://jmsQueue1'
initialContext = 'com.sun.jndi.fscontext.RefFSContextFactory'
JMSMessageID = ID:414d512054657374514d2020202020206ab98b4520017a02'
JMSCorrelationID = 'ABCDEFGHIJKLMNOPQRSTUVW'
)
)
)
メッセージ・フローに JMSOutput ノードを組み込む場合、「トランザクション・モード」で設定した値が、メッセージを同期点下で送信するかどうかを定義します。
Windows (x86) システムの場合: install_dir/bin/ JMSSwitch.dll
XAOpenString=Initial Context,location JNDI,Optional_parms
ThreadOfControl=THREAD
Windows (x86-64) システムの場合: JMSSwitch
XAOpenString=Initial Context,location JNDI,Optional_parms
ThreadOfControl=THREAD

Linux および UNIX システムでは、JMS プロバイダーごとにスタンザをキュー・マネージャーの .ini ファイルに追加します。
XAResourceManager:
Name=Jms_Provider_Name
SwitchFile=/install_dir/bin/JMSSwitch.so
XAOpenString=Initial Context,location JNDI,Optional_parms
ThreadOfControl=THREAD
ここで、オプション・パラメーターはコンマで区切られていて、定位置です。 そのため、存在しないパラメーターはコンマで表す必要があります。
install_dir/classes/xarecovery.jar
install_dir/bin
詳細については、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの『システム管理ガイド』セクションを参照してください。
z/OS® では、外部同期点マネージャーはリソース・リカバリー・サービス (RRS) です。
z/OS 上でサポートされる唯一の JMS プロバイダーは、WebSphere MQ JMS です。
z/OS 上で WebSphere MQ JMS に対してサポートされる唯一のトランスポート・オプションは、バインド・オプションです。
JMS プロバイダーの同期点制御は、ブローカーのキュー・マネージャーの RRS 同期点調整によって管理されます。.ini ファイルを変更する必要はありません。
JMSOutput ノードが BEA WebLogic を JMS プロバイダーとして使用し、整合済みのメッセージ・フローに参加する必要がある場合、JMS プロバイダーのクライアントを JMS ノードで使用可能にするを参照してください。
JMSOutput ノードの In ターミナルを、ルーティングされるアウトバウンド・メッセージの元になるノードに接続します。
メッセージをさらに処理する場合、エラーを処理する場合、あるいはメッセージを追加の宛先に送信する場合は、JMSOutput ノードの Out ターミナルをメッセージ・フローの別のノードに接続します。
JMSOutput ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。デフォルト値が定義されていないすべての必須プロパティーには、アスタリスクのマークが付きます。
| ターミナル | 説明 |
|---|---|
| In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
| Failure | エラーが発生した場合にメッセージがルーティングされる出力ターミナル。 「妥当性検査」プロパティーが設定されている場合でも、このターミナルに伝搬されるメッセージは妥当性検査が行われません。 |
| Out | メッセージが正常に出力宛先 (トピックまたはキュー) に入れられた場合に、メッセージがルーティングされる先の出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| ノード名 | いいえ | いいえ | ノード・タイプ、JMSOutput | ノードの名前。 |
| 簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
| 詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| 宛先キュー | いいえ | はい | ノードが出力メッセージをパブリッシュするキューの名前。 JMSOutput ノードを使用して Point-to-Point メッセージを送信する予定の場合、バインディング・ファイルにリストされている JMS キュー名の 「宛先キュー」 名を入力します。 | destinationQueueName | |
| パブリケーション・トピック | いいえ | はい | ノードがメッセージをパブリッシュするトピックの名前。
|
トピック (topic) | |
| 宛先に応答 | いいえ | はい | 受信アプリケーションが応答メッセージを送る必要のある JMS 宛先の名前です。
応答メッセージがこの JMS 宛先に戻されるようにするには、
この JMS 宛先名が、受信クライアントが使用する JMS プロバイダーのドメインに知られている必要があります。
JMS 宛先として、サブスクリプション・キューまたは宛先トピックを入力できます。
デフォルト値はブランクで、この場合は JMS 出力メッセージをデータグラムとして扱うことができます。 フィールドがブランクの場合、JMSOutput ノードは受信 JMS クライアントからの応答を予期しません。 |
replyToDestination | |
| ローカル環境にある宛先リストへ送信する | いいえ | はい | 選択されていない | ローカル環境に JMS 宛先のリスト作成した場合、このチェック・ボックスを選択して宛先リストを使用します。 このチェック・ボックスを選択しなかった場合、ノードは構成済みの JMS 宛先を使用します。 このチェック・ボックスを選択してもローカル環境に JMS 宛先のリストを作成しなかった場合、ノードは構成済みの JMS 宛先を使用します。 | useDistList |
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| JMS プロバイダー名 | はい | いいえ | WebSphere MQ | リストから JMS ベンダー名を選択するか、または独自に選択した名前を入力します。 リストから名前を選択すると、「初期コンテキスト・ファクトリー」プロパティーが、関連する Java クラスを使用して自動的に更新されます。 独自の JMS プロバイダー名を使用する場合、「初期コンテキスト・ファクトリー」の値も入力する必要があります。 その名前は、メッセージ・フローのデプロイ先のブローカーに対して定義されている構成可能サービスの名前に一致しなければなりません。あるいは、JMSProviders 構成可能サービスを指定することができます。 | |
| 初期コンテキスト・ファクトリー | いいえ | はい | com.sun.jndi.fscontext. RefFSContextFactory | このプロパティーが JNDI ネーム・スペースの開始点です。JMS アプリケーションは初期コンテキストを使用して、JMS プロバイダーの接続ファクトリーおよびキューまたはトピック・オブジェクトを取得および検索します。
「JMS プロバイダー名」のリストから JMS プロバイダー名を選択すると、関連する Java クラスに基づいて「初期コンテキスト・ファクトリー」プロパティーが自動的に更新されます。 独自の JMS プロバイダー名を使用する場合、「初期コンテキスト・ファクトリー」の値も入力する必要があります。 デフォルト値は com.sun.jndi.fscontext.RefFSContextFactory であり、これは WebSphere MQ JMS プロバイダー用の、ファイル・ベースの初期コンテキスト・ファクトリーを定義します。 独自の JMS プロバイダーを使用するようにノードが設定されていて、mqsichangeproperties 定義の対応する構成可能サービス・プロパティーに InitialContextFactory 属性が設定されている場合、ノードの設定はオーバーライドされます。 |
initialContextFactory |
| ロケーション JNDI バインディング | いいえ | はい | バインディング・ファイルのシステム・パスまたは LDAP ロケーション。
バインディング・ファイルには、JMSOutput ノードで使用される JNDI 管理対象オブジェクトの定義が含まれています。 「ロケーション JNDI バインディング」の値を入力するとき、
それが以下の指示に従っていることを確認してください。
JNDI 管理対象オブジェクトのバインディング・ファイルの作成方法については、JMS プロバイダーに付属の資料を参照してください。 独自の JMS プロバイダーを使用するようにノードが設定されていて、mqsichangeproperties 定義の対応する構成可能サービス・プロパティーに jndiBindingsLocation 属性が設定されている場合、ノードの設定はオーバーライドされます。 |
locationJndiBindings | |
| 接続ファクトリー名 | いいえ | はい | JMSOutput ノードによって JMS プロバイダーへの接続を作成するために使用される、接続ファクトリーの名前。この名前は、バインディング・ファイル内にすでに存在している必要があります。 接続ファクトリーは JMS QueueConnectionFactory または JMS TopicConnectionFactory にすることができますが、ノードによって使用されるメッセージ・モデルと一致している必要があります。あるいは、汎用の JMS ConnectionFactory を指定することができます。これは JMS キューまたは JMS トピック宛先の両方に対して使用できます。 | connectionFactoryName |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| 新規相関 ID | いいえ | はい | メッセージ用の新規の相関 ID を生成するのに JMSOutput ノードが必要な場合、「新規相関 ID」を選択します。 チェック・ボックスをクリアしたままにした場合は、メッセージ・ツリーの JMSTransport_Header_Values セクション内の JMSCorrelationID フィールドから、出力メッセージの相関 ID が取り込まれます。 | |
| トランザクション・モード | はい | いいえ | いいえ | このプロパティーは、メッセージを JMS トランザクション下で受信するかどうかを制御します。有効な値は Yes および No です。
|
| デリバリー・モード | いいえ | はい | 非持続 | このプロパティーは、JMS プロバイダーがメッセージに使用する持続モードを制御します。有効な値は以下のとおりです。
|
| メッセージ有効期限 (ms) | いいえ | はい | 0 | このプロパティーは、JMS プロバイダーが出力 JMS メッセージを保持する期間をミリ秒単位で制御します。デフォルト値の 0 は、メッセージの有効期限が切れないことを示します。 「ヘッダーから継承」を選択するか、ミリ秒数を表す整数を入力します。「ヘッダーから継承」を選択すると、プロパティーは JMS メッセージ中の JMSExpiry フィールドの値を継承します。この値は以下の場所にあります。
|
| メッセージ優先順位 | いいえ | はい | 4 | このプロパティーはメッセージに相対重要度を割り当て、受信 JMS クライアント・アプリケーションまたは JMSOutput ノードによるメッセージ選択に使用できます。 0 (最低優先順位) から 9 (最高優先順位) までの間の値を選択するか、「ヘッダーから継承」を選択します。 デフォルト値は、中間の優先順位を示す 4 です。
0 から 4 までの範囲の優先順位は、標準の配信に関連したものです。
5 から 9 までの範囲の優先順位は、急ぎの配信のための目盛りです。「ヘッダーから継承」を選択すると、プロパティーは JMS メッセージ中の JMSPriority フィールドの値を継承します。この値は以下の場所にあります。
|
| メッセージ・タイプ | いいえ | はい | JMS メッセージ・ツリーから出力メッセージ・タイプを決定する | リストから値を選択して、JMSOutput ノードによって作成された JMS メッセージのタイプを構成します。
このプロパティーの値を設定しない場合、ノードは JMS メッセージ・ツリーにあるメタデータ PayLoadType フィールドからの出力タイプを、デフォルト値である 「JMS メッセージ・ツリーから出力メッセージ・タイプを確定する」 によって示されたものとして受け入れます。有効な値は以下のとおりです。
|
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| 妥当性検査 | いいえ | はい | 継承 | このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は、「なし」、「内容」、「内容と値」、および「継承」です。 | validateMaster |
| 失敗時の処置 | いいえ | いいえ | 例外 | このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 「妥当性検査」を「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。有効な値は、「ユーザー・トレース」、「ローカル・エラー・ログ」、「例外」、および「例外リスト」です。 |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| イベント | なし | なし | なし | ノードに対して定義したイベントが、このタブに表示されます。デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |