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

接続設定

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

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

トピック接続設定

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

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

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

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

キュー接続設定

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

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

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

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

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

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

セキュリティ

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

初期設定

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

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

ネーミングサービスに渡す[初期コンテキストファクトリ名]、[プロバイダURL]の設定はJMSプロバイダによって異なりますので、各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プロバイダが起動しているか、または接続設定の内容を確認してください。

注意事項