ここでは，コネクション定義に指定できる要素と指定個所について説明します。

●DDでの指定個所とコネクション定義に指定できる要素

コネクション定義は，Connector 1.5仕様に対応したDDの，<connection-definition>下に指定します。<connection-definition>の下に指定する要素を次に示します。

• <managedconnectionfactory-class>
• <config-property>
• <connectionfactory-interface>
• <connectionfactory-impl-class>
• <connection-interface>
• <connection-impl-class>

●Connector属性ファイルの階層構造とコネクション定義の対応

DD（ra.xml）の階層構造の変更に合わせて，属性ファイルにもコネクション定義に対応する階層が追加されます。

J2EEサーバにインポート済みのリソースアダプタの場合，リソースアダプタのプロパティの変更には，Connector属性ファイルを使用します。Connector属性ファイルに定義した値は，サーバ管理コマンドを使用してJ2EEサーバ上のリソースアダプタに反映します。属性ファイルによるプロパティの設定手順については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

なお，リソースアダプタの動作に関連するプロパティには，コネクション定義ごとに定義する項目と，リソースアダプタ全体に定義する項目があります。コネクション定義ごとに指定する項目については，Connector属性ファイルの<outbound-resourceadapter>-<connection-definition>下に指定します。リソースアダプタ全体に対して指定する項目については，<resourceadapter-runtime>-<property>下に指定します。

それぞれの項目の指定方法の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

●J2EEアプリケーションでのリンク解決の定義方法（<resource-ref>-<linked-to>，<cmp-map>-<datasource-name>またはmappedNameでの指定方法）

Connector 1.5仕様に準拠したリソースアダプタを参照するJ2EEアプリケーションでは，リンク解決のために，J2EEアプリケーションがどのコネクション定義を参照するかを定義する必要があります。

定義は，次のどれかの方法で指定します。

• J2EEアプリケーションの属性ファイル（WAR属性ファイル，Session Bean属性ファイル，Entity Bean属性ファイルまたはMessageDrivenBean属性ファイル）の<resource-ref>-<linked-to>
• J2EEアプリケーションの属性ファイル（Entity Bean属性ファイル）の<cmp-map>-<datasource-name>
• アノテーション@ResourceのmappedName属性
  

  注意

  参照先のリソースがConnector 1.5仕様に準拠したリソースアダプタの場合は，必ずコネクション定義識別子を指定してください。指定を省略した場合，リンク解決に失敗します。また，参照先のリソースがConnector 1.0仕様に準拠したリソースアダプタの場合は，コネクション定義識別子を指定しないでください。指定した場合，リンク解決に失敗します。

コネクション定義識別子を含む参照先のリソースは，次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

指定内容について説明します。

<リソースアダプタの表示名>

参照先のリソースアダプタのDD（ra.xml）の<connector>-<display-name>要素の値です。

<コネクション定義識別子>

参照先のリソースアダプタのDD（ra.xml）の<connector>-<resourceadapter>-<outbound-resourceadapter>-<connection-definition>-<connectionfactory-interface>要素の値です。

なお，リソースアダプタの表示名およびコネクション定義識別子は，次のサーバ管理コマンドでも確認できます。

• cjlistappコマンド（アプリケーションに含まれるRARファイルの場合）
• cjlistresコマンド
• cjlistrarコマンド

複数のコネクション定義が指定されているリソースアダプタでは，コネクションプールをコネクション定義単位で管理できます。コネクションプールについての定義は，Connector属性ファイルの<outbound-resourceadapter>-<connection-definition>-<connector-runtime>-<property>下の要素で指定して設定してください。

次に，コネクションプールが複数になる場合の留意事項について説明します。

●コネクションプールを対象にしたコマンドの実行

コネクションプールを対象にしたサーバ管理コマンドを実行するときには，どのコネクションプールを対象にするかを指定する必要があります。

次のコマンドを実行する場合には，コネクション定義識別子の指定が必要です。コネクション定義識別子は，これらのコマンドのオプションで指定します。

• cjclearpoolコマンド
• cjlistpoolコマンド

コマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

参考

コネクションプールのクラスタ化で使用するコマンドについては，対象になりません。コネクションプールのクラスタ化で使用するコマンドは，Cosminexusが提供しているリソースアダプタだけで実行できます。

●コネクションプールのウォーミングアップ処理

コネクションプールのウォーミングアップ処理は，コネクション定義ごとに実行されます。

コネクションプールのウォーミングアップ処理が実行される場合に，特定のコネクション定義に対応するコネクションプールのウォーミングアップに失敗しても，それ以外のコネクションプールに対するウォーミングアップ処理は継続されます。

トランザクションリカバリは，コネクション定義ごとに実行されます。このため，コネクション定義を複数指定した場合，OTSにはコネクション定義ごとにリソースが登録されます。

リソースアダプタの接続テストを実行する場合，特定のコネクション定義に対する接続テストでエラーが発生した場合も，処理は中止されません。すべてのコネクション定義に対して接続テストが実行されます。ただし，どれかのコネクション定義でエラーが発生した場合，コマンドの戻り値は異常終了を示す戻り値になります。

コネクション定義が複数指定されている場合，稼働情報およびリソース枯渇監視情報は次のように出力されます。

稼働情報（稼働情報ファイルに出力される情報）

一つ目のコネクション定義についての情報だけが出力されます。一つ目のコネクション定義とは，DD（ra.xml）で最初に定義されているコネクション定義です。

稼働情報（運用管理コマンドを使用して出力する情報）

出力できません。Connector 1.5仕様に準拠したリソースアダプタについての稼働情報を出力しようとした場合，出力内容は保証されません。

リソース枯渇監視情報

リソースアダプタに指定されているすべてのコネクション定義の情報が出力されます。

Connector 1.5仕様に準拠したリソースアダプタの稼働ログを出力する場合，出力ファイルのファイル名は，次の形式になります。

<リソースアダプタの表示名>_<コネクション定義の並び順>_<ログファイルの通番>.log

<コネクション定義の並び順>は，DD（ra.xml）内で，対応する<connection-definition>が出現した順番（1，2，...）に対応します。

cjrarupdate（リソースアダプタのバージョンアップ）を実行しても，Connector 1.0仕様のリソースアダプタのDDは，Connector 1.5仕様のリソースアダプタのDDには書き換えられません。