コネクタ接続プールに関する管理コンソールタスク

• 「EIS アクセスを設定する」

• 「コネクタ接続プールを作成する」

• 「コネクタ接続プールを編集する」

• 「コネクタ接続プールを削除する」

EIS アクセスを設定する

手順

1. コネクタを配備 (インストール) します。「コネクタモジュールを配備する」を参照してください。

2. コネクタの接続プールを作成します。「コネクタ接続プールを作成する」を参照してください。

3. 接続プールに関連付けられたコネクタリソースを作成します。「コネクタリソースを作成する」を参照してください。

コネクタ接続プールを作成する

始める前に

プールを作成する前に、プールに関連付けられたコネクタモジュール (リソースアダプタ) を配備します。新しいプールに指定する値は、配備したコネクタモジュールにより異なります。

手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを選択します。

3. 「コネクタ接続プール」ページで、「新規」をクリックします。

4. 最初の「コネクタ接続プールを作成」ページで、次の設定値を指定します。

   1. 「名前」フィールドで、プールの論理名を入力します。

      コネクタリソースの作成時にこの名前を指定します。

   2. 「リソースアダプタ」コンボボックスからエントリを選択します。

      コンボボックスには配備したリソースアダプタ (コネクタモジュール) のリストが表示されます。

5. 「次へ」をクリックします。

6. 次の「コネクタ接続プールを作成」ページで、「接続の定義」コンボボックスから値を選択します。

   コンボボックスの選択はリソースアダプタにより異なります。通常は、ConnectionFactory のタイプとして EIS に接続するファクトリインスタンスを指定します。

7. 「次へ」をクリックします。

8. 最後に 3 番目の「コネクタ接続プールを作成」ページで、次のタスクを実行します。

   1. 「一般設定」セクションでその値が正しいことを確認します。

   2. 「プール設定」セクションのフィールドに、デフォルト値を保持できます。

      これらの設定はあとで変更できます。「コネクタ接続プールの編集」を参照してください。

   3. 「追加プロパティー」テーブルで、必要なプロパティーを追加します。

      前の「コネクタ接続プールを作成」ページでは、「接続の定義」コンボボックスから値を選択しました。このクラスはサーバーのクラスパス内にあり、「追加プロパティー」テーブルにはデフォルトプロパティーが表示されます。

9. 「完了」をクリックします。

同機能を持つ asadmin コマンド

create-connector-connection-pool

コネクタ接続プールを編集する

手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを開きます。

3. 編集するプールのノードを選択します。

4. 「コネクタ接続プールを編集」ページで、プールに含まれる接続の数を制御する設定を変更できます。次の表を参照してください。

   パラメータ	説明
   初期および最小プールサイズ	プール内の接続の最小数。この値は、プールを最初に作成したり、Application Server を起動したりするときの、プールに含まれる接続の数も指定します。
   最大プールサイズ	プールに含まれる接続の最大数。
   プールサイズ変更量	プールのサイズが最小プールサイズに近づくと、プールサイズが一括処理で変更されます。この値は一括処理での接続の数を指定します。過大な値を設定すると接続の再利用が遅れ、過小な値を設定すると効率が落ちます。
   アイドルタイムアウト	プールで接続がアイドル状態のままでいられる最長時間を指定します。この時間を過ぎると、接続はプールから削除されます。
   最大待ち時間	接続タイムアウトになる前に接続を要求したアプリケーションが待つ時間。デフォルトの待ち時間は長いので、アプリケーションがハングアップしているように見える可能性があります。
   すべて障害で	「すべての接続を閉じる」のチェックボックスを選択してある場合、1 つの接続が失敗すると、アプリケーションサーバーはプールに含まれるすべての接続を閉じ、それらを再確立します。そのチェックボックスを選択していない場合は、使用されるときにだけ個々の接続が再確立されます。
   トランザクションサポート	トランザクションサポートのリストを使用して、接続プールのトランザクションサポートのタイプを選択します。選択したトランザクションサポートは、この接続プールに下位互換性があるように関連付けられたリソースアダプタのトランザクションサポート属性をオーバーライドします。つまり、リソースアダプタに指定したレベルより低いトランザクションレベルまたはリソースアダプタに指定したレベルと同じトランザクションレベルをサポートし、それより高いレベルを指定することはできません。  トランザクションサポートオプションには次のものが含まれます。  「トランザクションサポート」メニューから「なし」を選択すると、リソースアダプタがローカルのリソースマネージャーまたは JTA トランザクションをサポートせず、XAResource または LocalTransaction インタフェースを実装しないことを示します。 ローカルトランザクションサポートは、リソースアダプタが LocalTransaction インタフェースを実装することにより、ローカルトランザクションをサポートすることを意味します。ローカルトランザクションはリソースマネージャーの内部で管理され、外部トランザクションマネージャーは一切関与しません。 XA トランザクションサポートは、リソースアダプタが LocalTransaction および XAResource インタフェースを実装することにより、ローカルのリソースマネージャーと JTA トランザクションをサポートすることを意味します。XA トランザクションは、リソースマネージャーの外部にあるトランザクションマネージャーによって制御され、協調動作します。ローカルトランザクションはリソースマネージャーの内部で管理され、外部トランザクションマネージャーは一切関与しません。

5. 「追加プロパティー」テーブルで、名前と値のペアを指定します。

   指定するプロパティーは、プールが使用するリソースアダプタにより異なります。配備担当者がこのテーブルを使用して指定した名前と値のペアは、リソースアダプタベンダーが定義したプロパティーのデフォルト値をオーバーライドするために使用できます。

6. 「セキュリティーマップ」タブ付き区画で、接続プールのセキュリティーマップを作成または変更します。

   セキュリティーマップの作成方法の詳細については、「セキュリティーマップについて」を参照してください。

7. 「保存」をクリックします。

コネクタ接続プールを削除する

手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを選択します。

3. 「コネクタ接続プール」ページで、削除するプールのチェックボックスにチェックマークを付けます。

4. 「削除」をクリックします。

同機能を持つ asadmin コマンド

delete-connector-connection-pool