JMSOutput ノード

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

目的

JMSOutput ノードを使用して、JMS 宛先にメッセージを送信します。 JMSOutput ノードは JMS メッセージ・プロデューサーと同じように機能して、 Java Message Service Specification、バージョン 1.1 (Java Message Service Specification, version 1.1) で定義された 6 つのメッセージ・タイプのすべてをパブリッシュすることができます。 メッセージは、JMS 仕様で説明されているメソッド呼び出しを使用してパブリッシュされます。

ワークベンチでは、JMSOutput ノードは次のアイコンで表されます。

JMSOutput ノード・アイコン

メッセージ・フロー内での JMSOutput ノードの使用

JMS Nodes サンプルのサンプルには、JMSOutput ノードが使用されるメッセージ・フローが含まれています。 JMSOutput ノードの使用方法を示す例については、このサンプルを参照してください。

JMS プロバイダーへの接続から受け取ったメッセージを処理するメッセージ・フローは、 常に JMSInput ノードで開始する必要があります。 JMSOutput ノードをメッセージ・フロー内に含める場合、JMSInput ノードを含める必要はありませんが、JMSInput ノードを組み込まない場合、MQJMSTransform ノードを組み込んで、JMSOutput ノードが予期する形式にメッセージを変換する必要があります。

JMS メッセージを伝搬させてサブフローとして使用するメッセージ・フローを作成する場合には、 JMSOutput ノードのインスタンスを最後のノードとして使用して、サブフロー用の out ターミナルを作成する必要があります。

JMS プロバイダーのクライアントを JMS ノードで使用可能にする

分散システムでは、java .jar ファイルおよび JMS プロバイダー・クライアントのネイティブ・ライブラリーをブローカー共用クラス・ディレクトリーにコピーします。 たとえば、Windows では、C:¥Documents and Settings¥All Users¥Application Data¥IBM¥MQSI¥shared-classes などです。 これにより、JMS ノードの java クラスが正しく設定されることを確認できます。

z/OS では、共用クラスのディレクトリーはありません。 代わりに、以下の手順を実行します。
  1. それぞれの JMS プロバイダー java .jar ファイルを、 ブローカーの区分データ・セット (PDS) の BIPPROF メンバー内にあるクラス・パスに指定する必要があります。
  2. LIBPATH を任意のネイティブ・ライブラリーで更新します。
  3. BIPGEN JCL ジョブをサブミットしてブローカー ENVFILE を更新します。
変更の始まり

メッセージ宛先モードの使用

JMSOutput ノードはメッセージ・プロデューサーと同じように機能して、以下のメッセージ・シナリオをサポートします。

データグラム・メッセージの送信

データグラム とは、内蔵タイプの、他に依存しないデータのエンティティーです。データグラムは、事前に行われるソースおよび宛先コンピューターの間の交換やトランスポート・ネットワークに依存せずに、ソースから宛先コンピューターにルーティングされるために十分な情報を備えています。 以下では、データグラム・メッセージを送信する方法について説明します。
  1. Request フォルダーの「宛先モード」属性を「宛先名」に設定します。
  2. 使用するメッセージ・モデルに応じてメッセージの宛先を設定します。 以下の属性の 1 つを有効な JNDI 管理対象オブジェクト名に設定します。
    • Pub/Sub フォルダーの「パブリケーション・トピック
    • Point to Point フォルダーの「宛先キュー
  3. Request フォルダーの下の「宛先に応答」属性の値をブランクに設定します。
ノードは JNDI 管理対象オブジェクトの名前 (「パブリケーション・トピック」または「宛先キュー」のどちらかに指定したもの) を解決し、その JMS 宛先にメッセージを送信します。

応答メッセージの送信

メッセージ・プロデューサーが、メッセージに対するコンシューマーの応答を希望する場合があります。 その場合、JMSOutput メッセージは出力メッセージを応答として扱い、要求メッセージの JMSReplyTo プロパティーから得られた値に応じてそれをルーティングします。 以下では、応答メッセージを送信する方法について説明します。
  1. Request フォルダーの「宛先モード」属性を「宛先に応答」に設定します。
  2. インスタンスの MbMessage の JMSReplyTo プロパティーの値を、Compute ノードまたは JavaCompute ノードを使って変更することができます。 これにより、JMSOutput ノードからのメッセージの動的ルーティングが可能になります。
ノードは、MbMessage ツリーの JMSReplyTo フィールドに設定される JMS 宛先名にメッセージを送信します。
MbMessage ツリーの JMSReplyTo 値は、JNDI から解決される JMS 宛先の名前を表します。 例えば、以下のようになります。
queue://QM_mn2/myJMSQueue4
この場合の値は、WMQSeries JMS プロバイダーの JMS 宛先の、JMS プロバイダー固有の表記になります。
解決済みの JMS 宛先名を指定することを望まない場合、JMSOutput ノードは、JMSReplyTo フィールドに JNDI 管理対象オブジェクト名を受け入れることもできます。 ただし、JNDI を通して管理対象オブジェクト名を解決しておかないと、ノードは基礎を成す JMS 宛先にメッセージをルーティングできるようになりません。 この場合、JMSReplyTo フィールドの値の接頭部にストリング jndi:¥¥ を付ける必要があります。たとえば、次のようにします。
jndi:¥¥jmsQ4
jmsQ4 は、JNDI 管理対象オブジェクトの名前です。

この方式を使用すると、JNDI で管理対象オブジェクトを検索する必要が生じるため、パフォーマンスに若干のオーバーヘッドがかかります。

要求メッセージの送信

JMSOutput ノードは、要求を処理するメッセージ・コンシューマーからの応答を期待して、JMS 宛先にメッセージを送信することがあります。 以下では、要求メッセージを送信する方法について説明します。
  1. 使用するメッセージ・モデルに応じてメッセージの宛先を設定します。 以下の属性の 1 つを有効な JNDI 管理対象オブジェクト名に設定します。
    • Pub/Sub フォルダーの「パブリケーション・トピック
    • Point to Point フォルダーの「宛先キュー
  2. Request フォルダーの「宛先モード」属性を「宛先名」に設定します。
  3. 出力メッセージの JMSReplyTo 宛先は、ノードに渡される MbMessage ツリーの JMSReplyTo フィールドから取り込めます。 あるいは、「宛先に応答」ノード属性に設定する JNDI 管理対象オブジェクト名によってこの値をオーバーライドすることもできます。

    出力メッセージの JMSReplyTo プロパティーを JMSOutput ノードが動的に設定できるようにしたい場合、「宛先に応答」属性をブランクのままとし、Compute ノードまたは JavaCompute ノードを使って MbMessage の JMSReplyTo 値を設定します。

ノードはまず、値を求めて MbMessage の JMSReplyTo フィールドを探します。 見つかる場合、その値が出力メッセージの JMSReplyTo フィールドに渡されます。 しかし、Request フォルダーの「名前に応答」フィールドが指定されている場合、出力メッセージの JMSReplyTo プロパティーにあらかじめ設定されていたものがこの値でオーバーライドされます。これは、まず JNDI 管理対象オブジェクトの名前を解決した後で行われます。

ノードは JNDI 管理対象オブジェクトの名前 (「パブリケーション・トピック」または「宛先キュー」のどちらかに指定したもの) を解決し、その JMS 宛先にメッセージを送信します。

変更の終わり

JMSOutput ノードの構成

JMSOutput ノードのインスタンスをメッセージ・フローに入れる際、 エディター・ビューでノードを右クリックし、「プロパティー」をクリックすることによって JMSOutput ノードを構成することができます。 ノードの基本プロパティーが、プロパティー・ダイアログに表示されます。

デフォルト値が定義されていないすべての必須プロパティーには、プロパティー・ダイアログ・ボックスでアスタリスクのマークが付きます。

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

  1. プロパティー・ダイアログ・ナビゲーターで「基本」を選択して、 次のプロパティーを完成させます。
    • 初期コンテキスト・ファクトリー」値を入力します。 JMS アプリケーションは初期コンテキストを使用して、JMS プロバイダーの JNDI 管理対象オブジェクトを取得および検索します。

      デフォルト値は com.sun.jndi.fscontext.RefFSContextFactory であり、 これは WebSphere MQ JMS プロバイダー用の、ファイル・ベースの初期コンテキスト・ファクトリーを定義します。

      JMS プロバイダーの初期コンテキスト・ファクトリーの名前を識別するには、JMS プロバイダーの資料を参照してください。

    • 変更の始まりロケーション JNDI バインディング」の値を入力します。 この値は、バインディング・ファイルのファイル・システム・パスまたは LDAP ロケーションのどちらかを指定します。 バインディング・ファイルには、JMSOutput ノードで使用される JNDI 管理対象オブジェクトの定義が含まれています。

      ロケーション JNDI バインディング」の値を入力するとき、 それが以下の指示に従っていることを確認してください。

      • JMSOutput ノードを含むメッセージ・フローをデプロイする前に、バインディング・ファイルを作成します。
      • このフィールドには、バインディング・ファイルのファイル名を入力しないでください。
      • 認証の必要な LDAP ロケーションを指定した場合、LDAP プリンシパル (ユーザー ID) および LDAP 信任状 (パスワード) の両方を個別に構成する必要があります。 これらの値は、ブローカー・レベルで構成されます。 これらの値の構成方法については、mqsicreatebroker コマンドおよび mqsichangebroker コマンドを参照してください。
      • ストリング値には、先行キーワードを含める必要があります。 これは、file:/iiop:/、または ldap:/ のいずれかです。

      JNDI 管理対象オブジェクトのバインディング・ファイルの作成方法については、 JMS プロバイダーに付属の資料を参照してください。

      変更の終わり
    • 接続ファクトリー名」を入力します。 接続ファクトリー名は、JMSOutput ノードによって JMS プロバイダーへの接続を作成するために使用されます。この名前は、バインディング・ファイル内にすでに存在している必要があります。
  2. 変更の始まりJMSOutput ノードを使用してトピックをパブリッシュする予定であれば、プロパティー・ダイアログ・ナビゲーターで「Pub/Sub」を選択します。
    • パブリッシャー・トピック」の名前を入力します。
      • このプロパティーが構成されている場合、 ノードはパブリッシュ/サブスクライブ・メッセージ・ドメイン内でのみ作動します。
      • このプロパティーは、「Point to Point」プロパティー・セクションにある「宛先キュー」と、相互に排他的です。
      • パブリッシャー・トピック」名は、ノードによって使用されている JMS プロバイダーの規格に準拠している必要があります。
    変更の終わり
  3. Point-to-Point メッセージを送信するために JMSOutput ノードを使用する場合は、 プロパティー・ダイアログ・ナビゲーターで「Point to Point」を選択します。
    • バインディング・ファイルにリストされた JMS キュー名の「宛先キュー」の名前を入力します。
  4. プロパティー・ダイアログ・ナビゲーターで「要求」を選択して、 次のプロパティーを完成させます。
    • 宛先モード」ドロップダウン・リストからオプションを選択します。
      • デフォルト値は、「宛先名」です。 これが選択された場合、メッセージはデータグラムの要求として取り扱われて、 「パブリケーション・トピック」または「宛先キュー」のどちらかがその宛先となります。
      • メッセージを応答として扱う場合、「応答宛先名」を選択します。 JMS プロバイダーには、メッセージ・ツリーの JMSTransport_Header_values セクションから JMSReplyTo 値が供給されます。
    • 宛先に応答」の値を入力します。 JMS 宛先として、サブスクリプション・キューまたは宛先トピックを入力できます。 「宛先に応答」は、 受信アプリケーションが応答メッセージを送る必要のある JMS 宛先の名前です。 応答メッセージがこの JMS 宛先に戻されるようにするには、 この JMS 宛先名が、受信クライアントが使用する JMS プロバイダーのドメインに知られている必要があります。

      デフォルト値はブランクで、この場合は JMS 出力メッセージをデータグラムとして扱うことができます。 フィールドがブランクの場合、JMSOutput ノードは受信 JMS クライアントからの応答を予期しません。

  5. プロパティー・ダイアログ・ナビゲーターで、「拡張」を選択します。
    • 新規相関 ID」が必要な場合、チェック・ボックスを選択します。
    • メッセージの処理方法を指定するトランザクション特性を定義するには、 「トランザクション・モード」を選択します。
      • 出力メッセージを非持続として扱う場合は、「なし」を選択します。 この値を選択する場合、メッセージは Session.AUTO_ACKNOWLEDGE フラグを使用して作成された未トランザクションの JMS セッションを使用して送信されます。
      • メッセージを受信した入力ノードが、JMSOutput ノードによって送信された JMS メッセージのコミットまたはロールバックを、メッセージ・フロー内で作業を行う DB2WebSphere MQ などの他のリソースとの間で調整する必要がある場合、「ローカル」を選択します。 この値を選択する場合、ノードはトランザクションの JMS セッションを使用します。
      • JMSOutput ノードがブローカーの外部同期点コーディネーターによって管理される グローバル・メッセージ・フロー・トランザクションに参加するようにするには、 「グローバル」を選択します。 外部同期点コーディネーターは、ブローカーの分散プラットフォーム上のキュー・マネージャー、 および z/OS 上の RRS (リソース・リカバリー・サービス) です。 この値を選択する場合、ノードによって受信されたすべてのメッセージは XA JMS セッションを使用してグローバルに調整されます。
    • デリバリー・モード」プロパティーを使用して、 出力 JMS メッセージの持続性を設定できます。 ドロップダウン・リストからオプションを選択してください。
      • 非持続」は、メッセージを非持続として扱う必要があることを JMS プロバイダーに指示します。
      • 持続」はメッセージにマークを付けて、JMS プロバイダーに対しそれらのメッセージが持続するものであること、 およびそれらが受信 JMS クライアント・アプリケーションに正常に配信されるまで保存する必要があることを示します。
    • JMS プロバイダーが出力 JMS メッセージを指定の時間保持するように要求するには、 「メッセージ有効期限」の値を入力します。

      この値をミリ秒で入力すると、メッセージが JMS プロバイダーによって保持される期間が指定されます。 デフォルト値の 0 は、メッセージの有効期限が切れないことを示します。

    • メッセージに相対重要度を割り当てるには、 「メッセージ優先順位」ドロップダウン・リストからオプションを選択します。 この値は受信 JMS クライアント・アプリケーションまたは JMSOutput ノードにより、メッセージ選択に使用できます。

      値を入力します。 メッセージ優先順位の有効な値は、0 (最低) から 9 (最高) までです。 デフォルト値は、中間の優先順位を示す 4 です。 0 から 4 までの範囲の優先順位は、通常の配信に関連したものです。 5 から 9 までの範囲の優先順位は、急ぎの配信のための目盛りです。

  6. プロパティー・ダイアログ・ナビゲーターで「妥当性検査」を選択して、 出力メッセージの妥当性検査に関連したノード・プロパティーを設定します。
    • 妥当性検査」ドロップダウン・リストからオプションを選択します。
      • なし
      • 内容と値
      • 内容
      • 継承
      「内容と値」または 「内容」を選択した場合は、「障害 アクション」をドロップダウン・リストから選択します。
      • ユーザー・トレース
      • ローカル・エラー・ログ
      • 例外 (デフォルト値)
      • 例外リスト

    詳細については、メッセージの妥当性検査およびMRM ドメインのメッセージの妥当性検査プロパティーを参照してください。

  7. 簡略説明または詳細説明 (あるいはその両方) を入力するには、 プロパティー・ダイアログ・ナビゲーターの「説明」を選択します。
  8. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに JMSOutput ノードが変更されます。 「OK」をクリックすると、 変更を適用してプロパティー・ダイアログを閉じます。

    「キャンセル」をクリックすると、ダイアログ・ボックスを閉じてプロパティーに対して行った変更をすべて破棄します。

ターミナルの接続

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

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

整合トランザクションの構成

変更の始まり

メッセージ・フローに JMSOutput ノードを組み込む場合、 「トランザクション・モード」で設定した値が、 メッセージを同期点下で送信するかどうかを定義します。

  • 「トランザクション・モード」「グローバル」に設定した場合、 メッセージは外部同期点調整の下 (WebSphere MQ 作業単位内) で送信されます。 メッセージ・フローと同じインスタンスの出力ノードによってその後に送信されるメッセージは、出力ノードがこれを明示的にオーバーライドしない限り、同期点の下に置かれます。
  • 「トランザクション・モード」「ローカル」に設定した場合、 メッセージは JMSOutput ノードのローカル同期点制御の下で送信されます。 フロー内の出力ノードによってその後に送信されるメッセージは、 個々の出力ノードがメッセージをローカル同期点の下に置くように指定しない限り、 ローカル同期点の下には置かれません。
  • 「トランザクション・モード」「なし」に設定した場合、メッセージは同期点下で送信されません。 フロー内の出力ノードによってその後に送信されるメッセージは、個々の出力ノードがメッセージを同期点の下に置くように指定しない限り、同期点の下には置かれません。

JMS プロバイダーは、トランザクション・サポートに必要な追加の jar ファイルを提供できます。 JMS プロバイダーの資料を参照してください。 例えば、分散システムで、WebSphere MQ JMS プロバイダーは追加の jar ファイル com.ibm,mqetclient.jar を提供します。これはブローカー shared_classes ディレクトリーにも追加する必要があります。 このトピック内の『JMS プロバイダーのクライアントを JMS ノードで使用可能にする』を参照してください。

メッセージを外部同期点下で受信するためには、以下の追加の構成ステップが必要となります。 これらのステップを適用する必要があるのは、 特定の JMS プロバイダーのブローカーに JMSOutput または JMSInput が最初にデプロイされたときだけです。
  • 分散システムで、ブローカーの外部同期点コーディネーターは WebSphere MQ です。 「トランザクション調整」が「グローバル」に設定されたメッセージ・フローをデプロイする前に、キュー・マネージャーの .ini ファイルを変更して、グローバルに調整されたトランザクションに加わる各 JMS プロバイダーのリソース・マネージャーに関する追加の定義を含めてください。
    • Windows の場合:
      • WebSphere MQ バージョン 5.0 をインストールしている場合、WebSphere MQ Services を開始して、キュー・マネージャー名を右クリックします。 「プロパティー」を選択し、「リソース」プロパティー・タブをクリックします。
      • WebSphere MQ バージョン 6.0 をインストールしている場合、WebSphere MQ Explorer を開始し、左側のペインのキュー・マネージャー名を右クリックします。 「プロパティー」を選択し、左側のペインの 「XA リソース・マネージャー」を選択します。 詳しくは、「WebSphere MQシステム管理ガイド」を参照してください。
        SwitchFile」プロパティーを以下の値に設定します。
        install_dir/bin/ JMSSwitch.dll
        XAOpenString=Initial Context,location JNDI,Optional_parms
        ThreadOfControl=THREAD
    • Linux および UNIX システムでは、JMS プロバイダーごとにスタンザをキュー・マネージャー ini ファイルに追加します。 詳しくは、「WebSphere MQシステム管理ガイド」を参照してください。
      例えば、以下のようになります。
      XAResourceManager:
      Name=Jms_Provider_Name 
      SwitchFile=/install_dir/bin/ JMSSwitch.so
      XAOpenString=Initial Context,location JNDI,Optional_parms
      ThreadOfControl=THREAD
      ここで、

      Name は、 JMS プロバイダーのリソース・マネージャーを識別する、インストール済み環境によって定義された名前です。

      SwitchFile は、ブローカーの bin ディレクトリーで提供される、JMSSwitch ライブラリーへのファイル・システム・パスです。

      XAOpenString の値は、以下のとおりです。
      • Initial Context は、JMSInput ノードの基本プロパティー「初期コンテキスト・ファクトリー」に設定される値です。
      • location JNDI は、JMSInput ノードの基本プロパティー「JNDI のロケーション」に設定される値です。 この値は、先行キーワードの file:/iiop:/、または ldap:/ を含む必要があります。
      以下のパラメーターはオプションです。
      • LDAP プリンシパル」は、mqsicreatebroker または mqsichangebroker コマンドを使用してブローカーに設定された値と一致します。
      • LDAP 信任状」は、mqsicreatebroker または mqsichangebroker コマンドを使用してブローカーに設定された値と一致します。
      • リカバリー接続ファクトリー名」は、 バインディング・ファイルで定義された JNDI 管理の接続ファクトリーです。 値が指定されていない場合、recoverXAQCF のデフォルト値をバインディング・ファイルに追加する必要があります。 どちらの場合も、リカバリー接続ファクトリーを初期コンテキスト・ファクトリーに関連した JMS プロバイダーの XA キュー接続ファクトリーとして定義する必要があります。

      オプション・パラメーターは、コンマ区切りで定位置です。 そのため、存在しないパラメーターはコンマで表す必要があります。

      1. ブローカーのキュー・マネージャーの Java CLASSPATH 環境変数を更新して、 xarecovery.jar への参照が含まれるようにします。 例えば、
        <Broker Installation Path>/classes/xarecovery.jar
      2. ブローカーのキュー・マネージャーの Java PATH 環境変数を更新して、 スイッチ・ファイルが存在する bin ディレクトリーを指定するようにします。 例えば、
        <Broker Installation Path>/bin

      XA は、WebSphere MQ バージョン 5.3、CSD12、および WebSphere MQ バージョン 6.0 フィックスパック 1 まで、 ブローカーおよびプロバイダーに同じキュー・マネージャーを使用できません。

    • z/OS では、外部同期点マネージャーはリソース・リカバリー・サービス (RRS) です。 z/OS 上でサポートされる唯一の JMS プロバイダーは、WebSphere MQ JMS です。 z/OS 上で WebSphere MQ JMS に対してサポートされる唯一の「トランスポート」オプションは、「バインド」オプションです。

      JMS プロバイダーの同期点制御は、ブローカーのキュー・マネージャーの RRS 同期点調整によって管理されます。 .ini ファイルを変更する必要はありません。

変更の終わり

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

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

ターミナル 説明
Failure エラーが発生した場合にメッセージがルーティングされる出力ターミナル。 「妥当性検査」プロパティーが設定されている場合でも、このターミナルに伝搬されるメッセージは妥当性検査が行われません。
Out WebSphere MQ キューからメッセージが正常に取り出された場合に、 メッセージがルーティングされる出力ターミナル。
Catch 例外がダウンストリームでスローされ、ノードによってキャッチされた場合に、メッセージがルーティングされる出力ターミナル。

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

JMSOutput ノードの基本プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
初期コンテキスト・ファクトリー はい   com.sun.jndi.fscontext.RefFSContextFactory これが JNDI ネーム・スペースの開始点です。 JMS アプリケーションは初期コンテキストを使用して、JMS プロバイダーの接続ファクトリーおよびキューまたはトピック・オブジェクトを取得および検索します。

デフォルト値は、WebSphere MQ Java が JMS プロバイダーとして使用されるときのものと同じです。

ロケーション JNDI バインディング いいえ     バインディング・ファイルのシステム・パスまたは LDAP ロケーション。
接続ファクトリー名 いいえ     JMSOutput ノードによって JMS プロバイダーへの接続を作成するために使用される、接続ファクトリーの名前。

JMSOutput ノードのパブリッシュ/サブスクライブ・プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
パブリッシャー・トピック いいえ     ノードがパブリッシュされたメッセージを受け取るトピックの名前。

JMSOutput ノードの Point to Point プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
宛先キュー いいえ     ノードが出力メッセージをパブリッシュするキューの名前。

JMSOutput ノードの要求プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
宛先モード いいえ   宛先名 このプロパティーは、着信メッセージをデータグラムの要求として扱うか、 または応答として扱うかを決めるために使用されます。
宛先に応答 いいえ     この値は、受信アプリケーションが応答メッセージを送る必要のある JMS 宛先の名前です。 応答メッセージがこの JMS 宛先に戻されるようにするには、 この JMS 宛先名が、受信クライアントが使用する JMS プロバイダーのドメインに知られている必要があります。

JMSOutput ノードの拡張プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
新規相関 ID いいえ     このプロパティーは、「新規相関 ID」が必要な場合に選択されます。
トランザクション・モード はい いいえ 「なし」 このプロパティーは、着信メッセージを同期点下で受信するかどうかを決めるためのものです。有効な値は、「なし」「ローカル」、および「グローバル」です。
デリバリー・モード いいえ   非持続 メッセージ・デリバリー・モードに応じてメッセージをフィルターに掛けるメッセージ・セレクター。
メッセージ有効期限 いいえ   0 このプロパティー値は、JMS プロバイダーが出力 JMS メッセージを指定の時間保持するように要求するためのものです。

値はミリ秒で指定し、デフォルト値の 0 は、メッセージの有効期限が切れないことを示します。

メッセージ優先順位 いいえ   4 このプロパティー値は、メッセージに相対的な重要度を割り当てます。 この値は受信 JMS クライアント・アプリケーションまたは JMSOutput ノードにより、メッセージ選択に使用できます。

JMSOutput ノードの妥当性検査プロパティーについては、次の表に説明されています。

これらのプロパティーの詳細については、MRM ドメインのメッセージの妥当性検査プロパティーを参照してください。
プロパティー M C デフォルト 説明
妥当性検査 はい はい 「なし」 このプロパティーは、妥当性検査を行うかどうかを決めます。 有効な値は、「なし」「内容」、および「内容と値」です。
失敗処置 はい いいえ 例外 このプロパティーは、妥当性検査が失敗した場合の動作を決めます。 「妥当性検査」を「内容」または「内容と 値」に設定した場合にのみ、このプロパティーを設定できます。 有効な値は、「ユーザー・トレース」「ローカル・エラー・ログ」「例外」、および「例外リスト」です。
すべての値制約を含める はい いいえ 選択されている このプロパティーは編集できません。 チェック・ボックスが選択されていることにより示されるデフォルトのアクションは、基本値制約検査が「内容と値」妥当性検査に含まれるということです。
修正 はい いいえ 「なし」 このプロパティーは編集できません。

JMSOutput ノードの説明プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ac24830_