名称
create-jdbc-datasource - JDBCデータソースの登録
形式
create-jdbc-datasource [ --user admin_user ] [ --password
admin_password ] [ --host host_name ] [ --port port_number
] [ --protocol=rmi|jmxmp ] [ --passwordfile filename ] [
--encrypted=true|false ] [ --terse=true|false ] [ --
echo=true|false ] [ --interactive=true|false ] [ --
secure=true|false ] [ --legacy=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 ] [ --
maxSqlRankingCount count ] [ --maxSqlTraceLength length ]
[ --wrapStatement=true|false ] [ --queryTimeout timeout ]
[ --readTimeout seconds ] [ --waitFreeConnTimeout seconds ]
[ --customizeTemplate template_name ] [ --
driverVenderProperties name=value[,name=value]* ] [ --
clusterPoolWeight weight ] [ --transactionIsolationLevel
level ] [ --description text ] [ --property
name=value[:name=value]* ] jdbc_datasource_name
説明
JDBCデータソースを登録します。JDBCデータソースの属性やプロパ
ティの値を変更した場合、統合運用管理ツールまたはotxadminコマ
ンドでJDBCデータソースへの設定変更内容の反映を行った際に、変
更内容が動作に反映されます。または、アプリケーションで、JNDI
サーバからJDBCデータソースを再取得した際に、変更内容を動作に
反 映することができます。ただし、java:comp/env指定で、アプリ
ケーション固有の名前空間からJDBCデータソースを取得する 場 合
に、変更内容を動作に反映するためには、プロセス(JavaVM)の再起
動が必要です。コネクションに関連す る 属 性 や プ ロ パ ティ
（dataSourceType や jdbcMajorVersion、 dataSourceName、
serverName、networkProtocol、 portNumber、 userName 、
password、 loginTimeout、jdbcDriverName、cursorMode、charac-
terEncoding、maxStatements、useJTA、useOneConnectionPerTran-
saction、 useDatabaseCluster、 checkGarbageOption、
clusterPoolOption、 jndiProviderUrl、 wrapStatement、 read-
Timeout、transactionIsolationLevel、driverVenderProperties）
を変更する場合は、プロパティ置換までの待機時 間 (propertyCy-
cle)が経過した後で、そのプールに存在するコネクション全てが消
滅し、新しいコネクションが作成されます。プロパティを変更する
に は set コマンドを使用してください。このコマンドはリモート
モードでのみ使用できます。
オプション
-u --user
ドメインの運用管理エージェントの管理ユーザ名。
既にotxadmin loginコマンドでログインしている場 合 は、
--userオプションの指定は不要です。
-w --password
ドメインの運用管理エージェントの管理ユーザのパ ス ワー
ド。
-H --host
ドメインの運用管理エージェントが起動しているマシン名。
-p --port
ドメインの運用管理エージェントのポート番号。既定 値 は
6212です。
--protocol
ドメインの運用管理エージェントとの接続プロトコルを選択
します。指定できるプロトコルは、rmi、jmxmpです。既定値
はrmiです。
-W --passwordfile
ドメインの運用管理エージェントのパスワードを含むファイ
ル。
--encrypted
ドメインの運用管理エージェントのパスワードに暗号化され
た パスワードを利用する場合に指定します。既定値はfalse
です。暗号化されたパスワードの生成にはencryptコマン ド
を 使 用してください。このオプションはpasswordfileオプ
ションが指定されている場合のみ有効です。
-t --terse
trueを指定すると、出力データがスクリプトによる処理のた
めの簡潔なデータとなります。既定値はfalseです。
-e --echo
trueを指定すると、標準出力でコマンドライン文が表示され
ます。既定値はfalseです。
-I --interactive
true(既定値)を指定すると、パスワードオプション入力用の
プロンプトを表示します。
-s --secure
trueを指定すると、ドメインの運用管理エージェントとの通
信にSSL/TLSを利用します。既定値はfalseです。
--legacy
trueを指定すると、コマンドの接続先のサーバがV8か、V9か
確認します。確認後V8であれば旧互換動作を行い、V9であれ
ばV9の動作を行います。falseの場合は接続先のサーバを 確
認せずにV9の動作を行います。既定値はfalseです。
--help
コマンドのヘルプを表示します。
--dataSourceType
WODataSourceで使用する、JDBCドライバベンダが提供するイ
ン タ フェー ス の 種別を表わす文字列です。 例) JDBC,
JDBCEX_Oracle, JDBCEX_DB2
--jdbcMajorVersion
JDBCのメジャーバージョン番号。2, 3, 4 の、いずれかを指
定します。
--jdbcMinorVersion
JDBCのマイナーバージョン番号。JDBCのメジャーバージョン
が4の場合は、0, 1を指定します。
--minPoolSize
プールが持つコネクションの最小値
--maxPoolSize
作成されるコネクションの最大値
--initialPoolSize
プールが持つコネクションの初期値
--useJTA
JTAと連携するかどうかを表わすブール値。既定値はtrue で
す。
--dataSourceName
データベースとの接続文字列かデータベース名、またはデー
タソース名
--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
障害時に全てのデータベースと再接続を試みるかどう か の
ブール値
--maxSqlRankingCount
SQLランキング情報で、ログに出力するランキングの数の 上
限を指定します。
--maxSqlTraceLength
SQLランキング情報で、ログに出力するSQL文字列の長さの上
限（単位：バイト）を指定します。
--wrapStatement
java.sql.StatementクラスをWebOTXの実装クラスでラップす
るかどうかを指定します。
--queryTimeout
java.sql.Statementに指定するクエリのタイムアウト 時 間
（単位：秒）を指定します。
--readTimeout
ソケットの読み取りタイムアウト時間（単位：秒）を指定し
ます。
--waitFreeConnTimeout
最大プール数のJDBCコネクションが全て使用中の場合に、空
きコネクションを取得できるまで待ち合わせる時間（単位：
秒）を指定します。
--customizeTemplate
JDBCデータソースをカスタマイズするために使用するテンプ
レー ト 名を指定します。ただし、プールサイズは、アプリ
ケーションの動作スレッド数に応じて調整してください。次
の い ず れ かを指定します。(Performance, Reliability,
PerformanceAndReliability, none)
--driverVenderProperties
JDBCドライバ の プ ロ パ ティ を 指 定 し ま す。 例：
property1=value1,property2=value2
--clusterPoolWeight
クラスタ機能のラウンドロビン呼び出しで、データ ベー ス
サーバを連続して呼び出す回数を指定します。
--transactionIsolationLevel
トランザクション遮断のレベルを指定します。
--description
JDBCデータソースのテキスト記述
--property
属性よりも利用頻度の低い、JDBCデータソースを構成するた
めの名前と値の組み合わせ
networkProtocol
データベースとの通信プロトコル
jdbcDriverName
JDBCドライバのクラス名
useStaticPool
JDBCコネクションの共有範囲を表わすブール値
databaseName
Transactionサービスが使用するDB情報の定義名 （省 略 可
能）
autoRecoveryOnOnePhaseCommit
2フェーズコミットトランザクションで最初のコミットが 失
敗した場合に、トランザクション全体を自動的にロールバッ
クするかどうかを表すブール値（dataSourceTypeの値がJDBC
の場合にだけ指定可能）
characterEncoding
文字列引数を送信する際の変換方法。(default: Unicode)
cursorMode
データベースカーソルの利用有無。次のいずれかを指定しま
す。(cursor, direct)
logLevel
JDBCデータソースのログ出力内容。次のいずれかを指定しま
す。(error, notice, info, debug, trace, none)
asyncCloseOnFailure
無応答障害など、復旧に時間がかかる障害発生時に、コネク
ショ ン を 非 同期にクローズするかどうかを指定します。
(default: true)
asyncCloseEnableTime
復旧に時間がかかる障害とみなす時間（単位：秒）を指定し
ます。
JndiProviderUrl
JNDIサーバと接続するためのURL。指定を省略した場合、 ド
メイン内のJNDIサーバに接続します。
オペランド
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) dump-all-jdbc-datasources(1) dump-jdbc-datasource(1) publish-jdbc-datasource(1)