名称

create-jdbc-datasource - JDBCデータソースの登録

形式

create-jdbc-datasource [ --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 ] --dataSourceType type_name [ --jdbcMajorVersion number ] [ --jdbcMinorVersion number ] [ --minPoolSize size ] [ --maxPoolSize size ] [ --initialPoolSize size ] [ --useJTA=true ] [ --dataSourceName name ] [ --jdbcUserName jdbc_user_name ] [ --jdbcPassword jdbc_password ] [ --serverName name ] [ --portNumber number ] [ --loginTimeout seconds ] [ --maxIdleTime seconds ] [ --maxStatements size ] [ --propertyCycle seconds ] [ --connectRetryMax times ] [ --connectRetryInterval seconds ] [ --defaultAutoCommit=true|false ] [ --resetAllConnectionsOnFailure=true|false ] [ --checkServerOption option ] [ --checkServerInterval seconds ] [ --checkServerCommand cmd ] [ --checkGarbageOption option ] [ --checkGarbageInterval seconds ] [ --useOneConnectionPerTransaction=true|false ] [ --useDatabaseCluster=true|false ] [ --shrinkDelayTime seconds ] [ --iPXdaConfigDirectoryName name ] [ --iPXdaConfigFileName name ] [ --iPXdaInvokeConfigFileName name ] [ --iPXdaOptionConfigFileName name ] [ --useMultiUsersPerTransaction=true|false ] [ --reconnectInitialPool=true|false ] [ --clusterPoolOption option ] [ --clusterPoolNames names ] [ --validAllClusterConnectionsOnFailure=true|false ] [ --description text ] [ --property name=value [:name=value]* ] jdbc_datasource_name

説明

JDBCデータソースを登録します。JDBCデータソースのプロパティの 値を変更した場合、アプリケーションで、JNDIサーバからJDBCデー タソースを再取得した際に、変更内容が動作に反映されます。ただ し、 java:comp/env指定で、アプリケーション固有の名前空間から JDBCデータソースを取得する場合に、変更内容を動作に反映するた めには、プロセス(JavaVM)の再起動が必要です。コネクションに関 連するプ ロ パ ティ （dataSourceType や jdbcMajorVersion、 dataSourceName、 serverName、 networkProtocol、 portNumber、 userName、password、 loginTimeout、 jdbcDriverName、 cursor- Mode、 characterEncoding、 maxStatements、useJTA、useOneCon- nectionPerTransaction、 useDatabaseCluster、 checkGarbageOp- tion）を変更する場合は、プロパティ置換までの待機時間(proper- tyCycle)が経過した後で、そのプールに存在するコネクション全て が消滅し、新しいコネクションが作成されます。プロパティを変更 するにはsetコマンドを使用してください。このコマンドはリ モー トモードでのみ使用できます。

オプション

-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

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

--dataSourceType

WODataSourceで使用する、JDBCドライバベンダが提供するイ ン タ フェー ス の 種別を表わす文字列です。 例) JDBC, JDBCEX_Oracle, JDBCEX_DB2

--jdbcMajorVersion

JDBCのメジャーバージョン番号。2, 3, 4 の、いずれかを指 定します。

--jdbcMinorVersion

JDBCのマイナーバージョン番号

--minPoolSize

プールが持つコネクションの最小値

--maxPoolSize

作成されるコネクションの最大値

--initialPoolSize

プールが持つコネクションの初期値

--useJTA

JTAと連携するかどうかを表わすブール値。既定値はtrue で す。

--dataSourcecName

データベースとの接続文字列かデータベース名、またはデー タソース名

--jdbcUserName

データベースとの接続時に使用するユーザ名

--jdbcPassword

データベースとの接続時に使用するパスワード

--serverName

データベースサーバ側のサーバ名（TCP/IPホスト名）

--portNumber

データベースサーバ側のポート番号

--loginTimeout

JDBCコネクション接続時のタイムアウト値（単位：秒）

--maxIdleTime

JDBCコネクションが未使用状態のままプールされ続ける時間 (単位：秒)

--maxStatements

ステートメントの最大プール数

--propertyCycle

動作中のJDBCデータソースが使用するプロパティ値を強制的 に変更するまでの待ち時間（単位：秒）

--connectRetryMax

JDBCコネクションの接続リトライ回数

--connectRetryInterval

JDBCコネクションの接続リトライ間隔（単位：秒）

--defaultAutoCommit

autoCommitモードのデフォルト値

--resetAllConnectionsOnFailure

コネクション障害を検出した際にプール内の全コネクション を切断するかどうかを表わすブール値

--checkServerOption

データベースサーバの状態監視オプション。次のいずれかを 指定します。(monitor, method, none)

--checkServerInterval

checkServerOptionにmonitorを指定した時の監視間 隔 （単 位：秒）

--checkServerCommand

データベースサーバの状態監視を行うために使用するSQL 命 令

--checkGarbageOption

Connectionオブジェクトのガベージコレクト機能における動 作 オプション。次のいずれかを指定します。(close, roll- back, debug, none)

--checkGarbageInterval

java.lang.System.gc()を呼び出す間隔（単位:秒）

--useOneConnectionPerTransaction

JTAのトランザクション毎に１つの物理コネクションを使 用 するかどうかを表わすブール値

--useDatabaseCluster

データベースのクラスタ構成サポート機能の使用有無を表わ すブール値

--shrinkDelayTime

コネクション解放までの待ち合わせ時間（単位:秒）

--iPXdaConfigDirectoryName

ACOS Access Toolkitが使用する定義ファイルの格納ディ レ クトリ名

--iPXdaConfigFileName

ACOS Access Toolkitが使用する動作環境定義ファイル名

--iPXdaInvokeConfigFileName

ACOS Access Toolkitが使用するトランザクション定義 ファ イル名

--iPXdaOptionConfigFileName

ACOS Access Toolkitが使用するオプション定義ファイル名

--useMultiUsersPerTransaction

Java EEのトランザクション内で、接続先が同じデータ ベー スの、複数ユーザのJDBCコネクションを使用するかどうかの ブール値

--reconnectInitialPool

初期接続の再接続処理を行うかどうかのブール値

--clusterPoolOption

コネクションプールのクラスタ動作オプション。次のいずれ かを指定します。(roundrobin, standby, none)

--clusterPoolNames

コネクションプールのクラスタ対象のJDBCデータソース名リ スト。(ex. jdbc/Oracle2,jdbc/Oracle3)

--validAllClusterConnectionsOnFailure

障害時に全てのデータベースと再接続を試みるかどう か の ブール値

--description

JDBCデータソースのテキスト記述

--property

属性よりも利用頻度の低い、JDBCデータソースを構成するた めの名前と値の組み合わせ networkProtocol データベースとの通信プロトコル jdbcDriverName JDBCドライバのクラス名 useStaticPool JDBCコネクションの共有範囲を表わすブール値 databaseName Transactionサービスが使用するDB情報の定義名 （省 略 可 能） autoRecoveryOnOnePhaseCommit 2フェーズコミットトランザクションで最初のコミットが 失 敗した場合に、トランザクション全体を自動的にロールバッ クするかどうかを表すブール値（dataSourceTypeの値がJDBC の場合にだけ指定可能） characterEncoding 文字列引数を送信する際の変換方法 cursorMode データベースカーソルの利用有無。次のいずれかを指定しま す。(cursor, direct) logLevel JDBCデータソースのログ出力内容。次のいずれかを指定しま す。(error, notice, info, debug, trace, none)

オペランド

jdbc_datasource_name

作成されるJDBCデータソースの名称

使用例

例1: create-jdbc-datasourceの使用法
otxadmin> create-jdbc-datasource --user admin --password adminadmin --host localhost --port 6212 --dataSourceType JDBCEX_Oracle --jdbcMajorVersion 3 --jdbcUserName scott --jdbcPassword tiger --dataSourceName jdbc:oracle:thin:@localhost:1521:ORCL jdbc/Oracle
Command create-jdbc-datasource executed successfully. jdbc/Oracleが作成されます。

終了ステータス

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

関連事項

list-jdbc-datasources(1) ping-jdbc-datasource(1) connect-jdbc-datasource(1) reset-jdbc-datasource(1) enable-jdbc-datasource(1) disable-jdbc-datasource(1) delete-jdbc-datasource(1) connect-all-jdbc-datasources(1) reset-all-jdbc-datasources(1)