cjclearpool（コネクションプール内のコネクション削除）

〈このページの構成〉

形式
機能
引数
入力例
戻り値
注意事項

形式

データソース（JDBC）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-type jdbc] [-mode {normal｜plan}]
            -resname <データソース表示名>
            [-resname <データソース表示名> ...]

リソースアダプタ（J2EEリソースアダプタとしてデプロイして使用）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type connector [-mode {normal｜plan}]
            -resname <リソースアダプタ表示名>
            [-resname <リソースアダプタ表示名> ...]

リソースアダプタ（J2EEアプリケーションに含めて使用）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type connector [-mode {normal｜plan}]
            -name <アプリケーション名>
            -resname <リソースアダプタ表示名>
            [-resname <リソースアダプタ表示名> ...]

すべてのデータソース（JDBC）およびリソースアダプタの場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-mode {normal｜plan}] -resall

ページの先頭へ

機能

指定されたデータソース（JDBC）またはリソースアダプタのコネクションをクリアします。一度に複数のデータソース（JDBC）またはリソースアダプタのコネクションを削除できます。

ページの先頭へ

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {jdbc|connector}

コネクションプールの種別を指定します。省略した場合はjdbcが設定されます。

jdbc：JDBC用のプール
connector：リソースアダプタ用のプール

-mode {normal|plan}

使用中のコネクションに対するクリア動作種別を指定します。未使用のコネクションはすべてクリア対象になります。省略した場合はnormalが設定されます。

normal（通常モード）

ユーザが使用中のコネクションはプールの外へ移して，プール内からはクリアされます。ただし，データベースとの接続はそのままで再利用はできません。
plan（計画モード）

ユーザが使用中のコネクションはクリアしません。ただし，再利用できません。

-name <アプリケーション名>

リソースアダプタがデプロイされているアプリケーション名を指定します。

コネクションプール種別がconnectorの場合に指定できます。省略した場合は，J2EEリソースアダプタとしてデプロイして使用したリソースアダプタのコネクションを削除します。

-resname <データソース表示名>または<リソースアダプタ表示名>

クリア対象となるデータソース（JDBC）またはリソースアダプタの表示名を指定します。

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって次のように異なります。

Connector 1.0の場合

<リソースアダプタの表示名>
Connector 1.5の場合

<リソースアダプタの表示名>!<コネクション定義識別子>

-resall

すべてのデータソース（JDBC）およびリソースアダプタを削除対象にする場合に指定します。

なお，-type，-name，または-resnameと同時に指定できません。

ページの先頭へ

入力例

データソース（JDBC）の場合（通常モード）

cjclearpool MyServer -resname JdbcConnection

リソースアダプタ（J2EEリソースアダプタとしてデプロイして使用）の場合

cjclearpool MyServer -type connector -mode plan -resname RarConnection

リソースアダプタ（J2EEアプリケーションに含めて使用）の場合

cjclearpool MyServer -type connector -mode plan -name App1 -resname RarConnection

すべてのデータソース（JDBC）およびリソースアダプタの場合（計画モード）

cjclearpool MyServer -mode plan -resall

ページの先頭へ

戻り値

0：: 正常終了しました。
1：: 異常終了しました。
2：: 排他エラーによってコマンドを実行できません。
3：: タイムアウトが発生しました。
9：: 管理者特権がないため，コマンドが実行できません（Windowsの場合）。

ページの先頭へ

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データソース表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <データソース表示名> -resname <プロバイダURL>）はできません。
コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
一度に複数のデータソース（JDBC）またはリソースアダプタを削除した場合，削除できないデータソース（JDBC）またはリソースアダプタがあったときでも，すべてのデータソース（JDBC）またはリソースアダプタに対して削除を試みます。
通常モードの場合，コネクションプールから取り除いた使用中コネクションは，コネクション数としてカウントされません。そのため，コネクションプール内のコネクションとコネクションプールから取り除いた使用中コネクションの合計がコネクションプールの最大値を超える場合があります。

ページの先頭へ