DB Connector for Cosminexus RMとCosminexus RMは，共にJDBCコネクションを利用します。同一トランザクション内でJDBCとJMSのアクセスを行う場合は，JDBCコネクションを共有できます。

DB Connector for Cosminexus RMとCosminexus RMの間でコネクションを共有するには，次の条件を満たす必要があります。

• DB Connector for Cosminexus RMとCosminexus RMが使用するDBが同一であること。
• Cosminexus RMのRMAssociateJDBCFlagプロパティにtrueが指定されていること。
• アプリケーションのリソースアダプタリファレンスの解決時に，データソースとキューコネクションファクトリのSession Bean属性ファイル，Entity Bean属性ファイル，WAR属性ファイル，またはMessageDrivenBean属性ファイルの<res-sharing-scope>タグに"Shareable"を指定していること（各属性ファイルについては，マニュアル「Cosminexus リファレンス 定義編」を参照してください）。
• 認証情報（ユーザ名，パスワード）が同一であること。
• 認証方法（コンテナ認証またはアプリケーション認証）が同一であること。
• Cosminexus RMのQueueSessionが，すべてAutoAcknowledgeモードであること（AutoAcknowledgeモード以外のQueueSessionとの間でコネクションを共有しようとすると，論理コネクション（java.sql.Connection, QueueSession）の取得に失敗します）。

コネクション共有の条件を満たさない場合は，別のJDBCコネクションが取得されます。この場合も，トランザクションマネジャでのトランザクション内では最初にトランザクションに参加したJDBCコネクションが常に利用されます。つまり，2番目以降のJDBCコネクションに対する処理も，最初のJDBCコネクションを利用して行われるので注意が必要です。

なお，コネクション共有を利用するかどうかに関係なく，JDBCコネクションはCosminexus RMのコネクションとしてプール管理されます。一方，DB Connector for Cosminexus RMのコネクションはプール管理されません。コネクション取得時にはCosminexus RMのコネクションプールからJDBCコネクションを取得します。

DB Connector for Cosminexus RMと連携する場合，実行中のSQL処理が返ってこない状態でトランザクションのタイムアウトが発生すると，ステートメントがキャンセルされます。

Cosminexus RMのステートメントキャンセルで注意する点を次に示します。

• ステートメントキャンセルは，ユーザがJDBCを利用して行う処理に対してだけ有効です。ユーザがJMS，またはJDBCとJMSとの間でコネクションシェアリングを利用する場合，ステートメントキャンセルはJDBCの処理に対してだけ有効となります。このとき，JMSを通して行われる処理に対しては，ステートメントがキャンセルされません。
• トランザクションのサポートレベルがXATransactionでDABrokerを利用してHiRDBと接続する場合，ステートメントはキャンセルされません。

デッドロックやスローダウンなどの障害が発生した場合，発行したSQLが障害の要因となった可能性があります。そこで，発行したSQLをログに出力することによって，障害要因の解析が容易になります。ログに出力されるSQLの情報を障害調査用SQLと呼びます。障害調査用SQLの詳細については，マニュアル「Cosminexus 機能解説」を参照してください。

Cosminexus RMの障害調査用SQLの出力で注意する点を次に示します。

• 障害調査用SQLの出力は，ユーザがJDBCを利用して行う処理に対してだけ有効です。ただし，ユーザがリソースアダプタ管理のトランザクション（リソース固有のAPIによって，ユーザが直接トランザクションを管理する方法）でJDBCとJMSとの間でコネクションシェアリングを利用する場合，JMSを通して行われる処理に対しての障害調査用SQLが出力されることがあります。
• ステートメントキャンセルと障害調査用SQLの出力は，まず障害調査用SQLの出力が実行され，そのあとにステートメントキャンセルが実行されます。
• 障害調査用SQLは，DB Connector for Cosminexus RMの稼働ログ，および性能解析トレースに出力されます。
  

  DB Connector for Cosminexus RMの稼働ログ

  <Cosminexusのログディレクトリ>\connectors

  性能解析トレース

  <Cosminexusのインストールディレクトリ>\PRF\spool\utt\prf\PRF_ID\dcopltrc

コネクション利用時に発生したエラーが，テーブルの一意性に違反したSQLの発行など軽微な障害の場合，コネクションを再利用します。

Cosminexus RMの軽微な障害時のコネクション再利用で注意する点を次に示します。

• 軽微な障害時のコネクション再利用は，ローカルトランザクションの場合だけ有効です。トランザクションを使用していない，またはトランザクションのサポートレベルがXATransactionの場合，コネクションは破棄されます。

DB Connector for Cosminexus RMと連携した場合，接続先DBのコネクションIDを取得できます。コネクションIDとは，DBとの接続に使用しているコネクションを一意に識別するための接続情報です。コネクションIDの取得の詳細については，マニュアル「Cosminexus システム運用ガイド」を参照してください。

Cosminexus RMのコネクションIDの取得で注意する点を次に示します。

• Cosminexus RMは，一つのトランザクション内の場合，アプリケーションは同じDB Connector for Cosminexus RMのコネクションを利用します。そのため，一つのトランザクション内で複数のコネクションを利用しているときにcjlistpoolコマンドを実行すると，同じコネクションIDが二つあるように見えます。

Cosminexus Component Containerが提供するCosminexus RMの接続テストを行うには，連携するDB Connector for Cosminexus RMが稼働中であることが前提となります。また，DB Connector for Cosminexus RMの接続テストでは，Cosminexus RMとDB Connector for Cosminexus RMの両方が稼働中であることを前提とします。

接続テストに失敗した場合は，メッセージの内容に応じて要因を取り除いてください。