JMS ゲートウェイの設定

JMS ゲートウェイを作成するには、以下の手順を実行します。

  1. 「アカウント管理」>「プロファイル」>「コミュニティー参加者」をクリックします。
  2. 検索条件を入力し、「検索」をクリックするか、または検索条件を入力せずに「検索」をクリックして、すべての参加者のリストを表示します。
  3. 「詳細の表示」アイコンをクリックして、参加者のプロファイルを表示します。
  4. 「ゲートウェイ」をクリックします。
  5. 「作成」をクリックします。

ゲートウェイの詳細

「ゲートウェイ・リスト」ページから、以下のステップを実行します。

  1. ゲートウェイを識別する名前を入力します。このフィールドは必須です。
  2. (オプション) ゲートウェイの状況を指定します。デフォルトは「使用可能」です。使用可能状態のゲートウェイは、文書を送信することができます。使用不可状態のゲートウェイは、文書を送信できません。
  3. (オプション) ゲートウェイがオンラインかオフラインかを指定します。デフォルトは「オンライン」です。
  4. (オプション) ゲートウェイの説明を入力します。

ゲートウェイの構成

このページの「ゲートウェイ構成」セクションで、以下のステップを実行します。

  1. 「トランスポート」リストから、「JMS」を選択します。
  2. 「アドレス」フィールドに、文書の配信先となる URI を入力します。このフィールドは必須です。

    WebSphere MQ JMS の場合、ターゲット URI の形式は以下のようになります。

    file:///<user_defined_MQ_JNDI_bindings_path>

    以下に例を示します。

    file:///opt/JNDI-Directory

    このディレクトリーには、ファイル・ベースの JNDI の「.bindings」ファイルが含まれています。このファイルは、WebSphere Partner Gateway が目的の宛先に文書をルーティングする方法を示します。

    このフィールドは必須です。

  3. (オプション) JMS キューへのアクセスにユーザー名とパスワードが必要な場合は、ユーザー名とパスワードを入力します。
  4. 「再試行カウント」フィールドに、ゲートウェイが文書の送信を試行する回数を入力します。この回数を超えると送信エラーとなります。デフォルトは 3 です。
  5. 「再試行間隔」フィールドに、ゲートウェイが文書の再送信を試行するまでの待ち時間を入力します。デフォルトは 300 秒です。
  6. 「スレッド数」フィールドに、同時に処理可能な文書の数を入力します。デフォルトは 3 です。
  7. 文書を処理する前に送信者の IP アドレスを検証するには、「クライアント IP の検証」 フィールドで「はい」を選択します。それ以外の場合は、「いいえ」を選択します。デフォルトは「いいえ」です。
  8. 指定した回数の再試行が終わって配信エラーになりそうな場合に、ゲートウェイを自動的にオフラインにするには、「自動キュー」フィールドで「はい」を選択します。それ以外の場合は、「いいえ」を選択します。デフォルトは「いいえ」です。

    「自動キュー」を選択した場合は、ゲートウェイを手動でオンラインにするまで、すべての文書がキューに入ったままになります。

  9. 「認証が必要」フィールドで、文書にユーザー名とパスワードが必要かどうかを指定します。デフォルトは「いいえ」です。
  10. 「JMS ファクトリー名」フィールドに、JMS プロバイダーが JMS キューへの接続に使用する Java クラスの名前を入力します。このフィールドは必須です。

    内部 JMS ゲートウェイの場合、この名前は、バインディング・ファイルの作成時 (ステップ 4) に define qcf コマンドで指定した名前と一致していなければなりません。

    ステップ 2 で JMS コンテキストのサブフォルダーを入力した場合、ここではファクトリー名だけを入力します (例えば、Hub)。 「アドレス」フィールドに JMS コンテキストのサブフォルダーを入力しなかった場合は、ファクトリー名の前にサブフォルダーを指定してください (例えば、JMS/Hub )。

  11. 「JMS メッセージ・クラス」フィールドにメッセージ・クラスを入力する入力します。 TextMessage や BytesMessage など、有効な JMS メッセージ・クラスを入力します。このフィールドは必須です。
  12. 「JMS メッセージ・タイプ」フィールドに、メッセージのタイプを入力します。これはオプションのフィールドです。
  13. 「プロバイダー URL パッケージ」フィールドに、Java で JMS コンテキスト URL を認識するために使用するクラス (または JAR ファイル) の名前を入力します。このフィールドはオプションです。 値を指定しなかった場合は、バインディング・ファイルのファイル・システム・パスが使用されます。
  14. 「JMS キュー名」フィールドに、文書を送信する JMS キューの名前を入力します。このフィールドは必須です。

    内部 JMS ゲートウェイの場合、この名前は、バインディング・ファイルの作成時 (ステップ 4) に define q コマンドで指定した名前と一致していなければなりません。

    ステップ 2 で JMS コンテキストのサブフォルダーを入力した場合、ここではキュー名だけを入力します (例えば、outQ)。JMS プロバイダー URL に JMS コンテキストのサブフォルダーを入力しなかった場合は、キュー名の前にサブフォルダーを指定してください (例えば、JMS/outQ)。

  15. 「JMS JNDI ファクトリー名」フィールドに、ネーム・サービスへの接続に使用するファクトリー名を入力します。このフィールドは必須です。JMS トランスポート・プロトコル用のハブの構成の説明に従って独自の JMS 構成を設定した場合、使用する値は、おそらく com.sun.jndi.fscontext.RefFSContextFactory です。
  16. ゲートウェイの前処理または後処理ステップを構成する場合は、ハンドラーの構成を参照して ください。それ以外の場合は、「保管」をクリックします。

Copyright IBM Corp. 2003, 2005