コネクション取得リトライは，使用できるコネクションがコネクションプールにない場合や，物理コネクションの確立に失敗した場合に，自動的にコネクションの取得をリトライする機能です。コネクション取得リトライ機能を使用することで，コネクション取得に失敗した場合に，ユーザプログラムでリトライをする必要がなくなります。

コネクション取得をリトライできる条件は次のとおりです。

• コネクションの取得要求時に，コネクションプールに未使用状態のコネクションがない場合で，コネクションプールのコネクション総数がプーリングするコネクションの最大数に達しているとき
• 物理コネクションの確立に失敗した場合

なお，リトライしてもコネクションが取得できない場合は，アプリケーションプログラムに例外が通知され，コネクションの取得は失敗します。

コネクションプールが枯渇したときの動作は，「9.11.2　コネクション枯渇時のコネクション取得待ち」に従います。

コネクション取得リトライを実施する場合には，リソースアダプタのプロパティとして，次の二つの内容を設定する必要があります。

• リトライの回数
  リトライする回数を設定します。
  
• リトライまでの間隔
  次のリトライまでの間隔を秒単位で設定します。
  

なお，リトライの回数，およびリトライまでの間隔を大きくすると，コネクション取得処理が重なった場合に，待ちが発生するおそれがあります。

リソースアダプタの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

＜この項の構成＞

(1)　前提条件