名称

create-connector-connection-pool - 指定されたコネクションプール名によるコネクションプールの作成

形式

create-connector-connection-pool --user admin_user [--password admin_password] [--host host_name] [--port port_number] [--passwordfile filename] [--terse=true|false] [--echo=true|false] [--interactive=true|false] [--steadypoolsize steady_pool_size] [--maxpoolsize max_pool_size] [--maxwait max_wait_time_in_millis] [--poolresize pool_resize_quantity] [--idletimeout idle_timeout_in_seconds] [--failconnection=true|false] --raname resource_adapter_name --connectiondefinition connection-definition_name [--property name=value [:name=value]*] pool_name

説明

新しいコネクタコネクションプールを作成します。新しいコネクタ コ ネクションプールを作成する前に、関連するRARファイルを配備 してください。 このコマンドはリモートモードでのみ使用できます。

オプション

--user

ドメインアプリケーションサーバの管理ユーザ名

--password

ドメインアプリケーションサーバの管理ユーザのパスワード

--host

ドメインアプリケーションサーバが起動しているマシン名

--port

ドメインアプリケーションサーバのポート番号(既定値：6212)

--passwordfile

ドメインアプリケーションサーバの管理ユーザのパスワードを含むファイル

--terse

trueを指定すると、出力データがスクリプトによる処理のための簡潔なデータとなります。既定値はfalseです。

--echo

trueを指定すると、標準出力でコマンドライン文が表示されます。既定値はfalseです。

--interactive

true(既定値)を指定すると、パスワードオプション入力用のプロンプトを表示します。

--steadypoolsize

プールに保持されるコネクションの最小及び初期値(既定値:8)

--maxpoolsize

クライアント要求を受けるために作成されるコネクションの最大値(既定値:32)

--maxwait

コネクションが利用できない場合に、コネクションが作成されるまで呼び出し側が待たなければならないミリ秒単位の時間。0に設定されている場合、リソースが利用できるようになるかエラーが発生するまで無限待ちになります(既定値:60000)。

--poolresize

idletimeout時間経過後に削除されるコネクションの数。タイムアウト時間より長い間使用されていないコネクションが削除の対象になります。プールサイズがsteadypoolsizeになった時、コネクション削除は止まります。

--idletimeout

コネクションがプール内で使用されない状態でいる最大時間。この時間経過後、プールはこのコネクションを閉じます(既定値:300)。

--failconnection

trueの場合、1つの有効化チェックが失敗した時にプール内のコネクション全てを閉じます。このパラメータはis-connection-validation-requiredがtrueで設定されている時のみ必須です。有効な値はon,off,yes,no,1,0,trueまたはfalse(既定値false)です。

--raname

配備されたリソースアダプタのモジュール名。アプリケーションに埋め込まれたリソースアダプタの場合、ranameはappname#ranameとなります。

--connectiondefinition

リソースアダプタの配備ディスクリプタの中のコネクション定義の1つを指定します。connection-definition設定のconnectionfactory-interfaceのサブ設定の値です。

--property

プールが作成されているconnectiondefinitionのmanagedconnectionfactory-classの構成プロパティの名称/値。UserNameとPasswordは全てのプールに対してデフォルトで受け入れられます。コロン(:)とバックスラッシュ(/)を区別するためにこの--propertyオプションの中でエスケープキー(\)が使用されます。

オペランド

pool_name

作成されるコネクションプールの名称

使用例

例1: create-connector-connection-poolの使用法
アプリケーションサーバにあらかじめパッケージされているJMSリソースアダプタがこの例で使われます。新しいコネクタコネクションプールを作成する前に、関連するRARファイルを配備してください。
RARファイルを配備するには:
otxadmin> deploy --user admin --password adminadmin jmsra.rar
Command deploy executed successfully
otxadmin> create-connector-connection-pool --user admin --password adminadmin --steadypoolsize 20 --maxpoolsize 100 --poolresize 2 --maxwait 60000 --raname jmsra --connectiondefinition javax.jms.QueueConnectionFactory --property UserName=guest:Password=guest jms/qConnPool
Command create-connector-connection-pool executed successfully

終了ステータス

0 :	コマンド実行成功
1 :	コマンド実行失敗

関連事項

deploy(1) delete-connector-connection-pool(1) list-connector-connection-pools(1)