名称

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

形式

create-connector-connection-pool [ --user admin_user ] [ --password admin_password ] [ --host host_name ] [ --port port_number ] [ --protocol=rmi|jmxmp ] [ --passwordfile filename ] [ --terse=true|false ] [ --echo=true|false ] [ --interactive=true|false ] [ --secure=true|false ] [ --help ] [ --steadypoolsize 8 ] [ --maxpoolsize 32 ] [ --maxwait 60000 ] [ --poolresize 2 ] [ --idletimeout 300 ] [ --failconnection=false ] --raname resource_adapter_name --connectiondefinition connection_definition_name [ --transactionsupport transaction_support ] [ --isconnectvalidatereq=false ] [ --description text ] [ --property name=value [:name=value]* ] connector_connection_pool_name

説明

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

オプション

-u --user

ドメインの運用管理エージェントの管理ユーザ名。 既にotxadmin loginコマンドでログインしている場 合 は、 --userオプションの指定は不要です。

-w --password

ドメインの運用管理エージェントの管理ユーザのパ ス ワー ド。

-H --host

ドメインの運用管理エージェントが起動しているマシン名。

-p --port

ドメインの運用管理エージェントのポート番号。既定 値 は 6212です。

--protocol

ドメインの運用管理エージェントとの接続プロトコルを選択 します。指定できるプロトコルは、rmi、jmxmpです。既定値 はrmiです。

--passwordfile

ドメインの運用管理エージェントのパスワードを含むファイ ル。

-t --terse

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

-e --echo

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

-I --interactive

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

-s --secure

trueを指定すると、ドメインの運用管理エージェントとの通 信にSSL/TLSを利用します。既定値はfalseです。

--help

コマンドのヘルプを表示します。

--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)です。

--transactionsupport

このコネクションプールのトランザクションサポート レ ベ ル。 指定できる値は、XATransaction、LocalTransaction、 NoTransactionです。コネクタコネクションプールでは、 リ ソースアダプタのトランザクションサポートレベルに設定さ れたレベル以下の値を設定することができます。リソースア ダ プ タのトランザクションサポートレベルは、XATransac- tionが最も高いレベルで、NoTransactionが最も低いレベ ル になります。

--isconnectvalidatereq

trueの場合、アプリケーションに対してコネクションを払い 出 す 前 に 利 用 可 能かどうかをチェックします(既定値 :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)