グローバルリソースのプロパティ

接続設定

グローバルリソースの接続設定は、各アダプタのプロパティ設定ダイアログ、コントロールパネルの「グローバルリソースの設定」、またはWebConsoleから行うことができます。

JMSアダプタは1つのアプリケーションへ送信を行うポイント・ツー・ポイント型の通信タイプ(キュー接続)と複数のアプリケーションに送信を行うパブリッシュ/サブスクライブ型の通信タイプ(トピック接続)、双方をサポートしています。

トピック接続設定

基本設定
項目名 必須/省略可 変数の使用 説明 備考
名前 必須 使用不可 接続先の設定の名前を入力します。  
種類 必須 使用不可 [トピック接続設定]を選択します。  
必須設定
項目名 必須/省略可 変数の使用 説明 備考
XAトランザクション 省略可 使用不可 XAトランザクションをサポートするかどうかを選択します。
  • [チェックあり]:
    XAトランザクションをサポートします。
    JMSプロバイダがXAトランザクションをサポートしている必要があります。
  • [チェックなし]:(デフォルト)
    XAトランザクションをサポートしません。
 
初期コンテキストファクトリ名 必須 環境変数のみ使用可 初期コンテキストを生成するためのファクトリの実装クラスを入力します。

クラス名は、$DATASPIDER_HOME/server/plugin/data_processing/modules/jms_adapterに格納した各JMSプロバイダのクラスライブラリによって異なります。

初期コンテキストファクトリの設定については、「初期設定」を参照してください。
クラスライブラリについては、「ライブラリのインストール」を参照してください。
 
プロバイダURL 必須 環境変数のみ使用可 ネーミングサービスを提供するプロバイダのURLを入力します。

設定方法は各プロバイダによって異なります。
詳細については、「初期設定」を参照してください。
 
ユーザ名 省略可 環境変数のみ使用可 ネーミングサービスを使用する際のユーザ名を入力します。  
パスワード 省略可 環境変数のみ使用可 ネーミングサービスを使用する際のパスワードを入力します。  
トピックファクトリ 必須 環境変数のみ使用可 トピックに接続するためのオブジェクトを生成するファクトリの名前を入力します。
  • ファクトリの名前は管理者によって作成されます。名前がわからない場合は管理者に問い合わせてください。
トピック名 必須 環境変数のみ使用可 トピックの名前を入力します。
  • トピックの名前は管理者によって作成されます。名前がわからない場合は管理者に問い合わせてください。
プロパティアクション
項目名 説明 備考
接続テスト ホストへの接続確認を行います。  

キュー接続設定

基本設定
項目名 必須/省略可 変数の使用 説明 備考
名前 必須 使用不可 接続先の設定の名前を入力します。  
種類 必須 使用不可 [キュー接続設定]を選択します。  
必須設定
項目名 必須/省略可 変数の使用 説明 備考
XAトランザクション 省略可 使用不可 XAトランザクションをサポートするかどうかを選択します。
  • [チェックあり]:
    XAトランザクションをサポートします。
    JMSプロバイダがXAトランザクションをサポートしている必要があります。
  • [チェックなし]:(デフォルト)
    XAトランザクションをサポートしません。
 
初期コンテキストファクトリ名 必須 環境変数のみ使用可 初期コンテキストを生成するためのファクトリの実装クラスを入力します。

クラス名は、$DATASPIDER_HOME/server/plugin/data_processing/modules/jms_adapterに格納した各JMSプロバイダのクラスライブラリによって異なります。

初期コンテキストファクトリの設定については、「初期設定」を参照してください。
クラスライブラリについては、「ライブラリのインストール」を参照してください。
 
プロバイダURL 必須 環境変数のみ使用可 ネーミングサービスを提供するプロバイダのURLを入力します。

設定方法は各プロバイダによって異なります。
詳細については、「初期設定」を参照してください。
 
ユーザ名 省略可 環境変数のみ使用可 ネーミングサービスを使用する際のユーザ名を入力します。  
パスワード 省略可 環境変数のみ使用可 ネーミングサービスを使用する際のパスワードを入力します。  
キューファクトリ 必須 環境変数のみ使用可 キューに接続するためのオブジェクトを生成するファクトリの名前を入力します。
  • ファクトリの名前は管理者によって作成されます。名前がわからない場合は管理者に問い合わせてください。
キュー名 必須 環境変数のみ使用可 キューの名前を入力します。
  • キューの名前は管理者によって作成されます。名前がわからない場合は管理者に問い合わせてください。
プロパティアクション
項目名 説明 備考
接続テスト ホストへの接続確認を行います。  

コンポーネントプールの設定

コンポーネントプールの設定は、コントロールパネルの「グローバルリソースの設定」、またはWebConsoleから行うことができます。

セキュリティ

セキュリティの設定は、コントロールパネルの「グローバルリソースの設定」、またはWebConsoleから行うことができます。

初期設定

JMSアダプタでは、さまざまなJMSベンダーの製品に対応するため、JNDI(Java Naming and Directory Interface)のネーミングサービスを使用して、JMSプロバイダへの接続を実現しています。

これにより、JMSプロバイダそれぞれに対して固有のMSアダプタを開発する事なく、データリソース設定プロパティのネーミング・サービスプロバイダのURL、およびQueueConnectionFactoryの初期バインド名(設定では[初期コンテキストファクトリ名]の部分)を変更するだけで、それぞれのJMSプロバイダへの接続が可能となっております。

ネーミングサービスに渡す[初期コンテキストファクトリ名][プロバイダURL]の設定はJMSプロバイダによって異なりますので、以下の設定を参考にして随時書き換えてください。

「myhost」にはそれぞれのJMSプロバイダが起動しているサーバのホスト名かIPアドレスを記述してください。
ネーミング・サービスプロバイダ 初期コンテキストファクトリ名 プロバイダURL
SwiftMQ JNDIサービス com.swiftmq.jndi.InitialContextFactoryImpl smqp://myhost:4001
IBM WebSphere JNDIサービス com.ibm.websphere.naming.WsnInitialContextFactory iiop://myhost:9001
iPlanet ディレクトリー・サーバ(LDAP) com.sun.jndi.ldap.LdapCtxFactory ldap://myhost:389
BEA WebLogic JNDIサービス weblogic.jndi.WLInitialContextFactory t3://myhost:7001
File System JNDIサービス com.sun.jndi.fscontext.RefFSContextFactory file:/tmp/stuff


サービスへの接続設定は、2002年10月31日現在のものです。
詳細については、JMSベンダー各社に問い合わせてください。

動作環境

仕様制限

特にありません。

主な例外

例外名 原因 対策
InvalidPropertyConfigurationException
リソースの必須項目が指定されていません。:<プロパティ名>
[接続先][<プロパティ名>]が指定されていません。 [接続先][<プロパティ名>]を指定してください。
javax.naming.NoInitialContextException:
Cannot instantiate class:
[初期コンテキストファクトリ名]が誤っている、またはクラスライブラリがコピーされていません。 [初期コンテキストファクトリ名]を確認してください。またはクラスライブラリがコピーされているかを確認してください。
javax.naming.ConfigurationException:
No scheme found in URI.
[プロバイダURL]が誤っています。 [プロバイダURL]を確認してください。
javax.naming.NameNotFoundException [トピックファクトリ]または[キューファクトリ]が誤っています。 [トピックファクトリ]または[キューファクトリ]を確認してください。
javax.naming.NameNotFoundException [トピック名]または[キュー名]が誤っています。 [トピック名]または[キュー名]を確認してください。
javax.naming.NamingException:
unable to connect, exception = javax.jms.JMSException: error creating socket connection tolocalhost:4001, message: Connection refused
JMSプロバイダが起動していない、または接続設定が誤っています。 JMSプロバイダが起動しているか、または接続設定の内容を確認してください。

注意事項