create-jdbc-datasource.tmp(1)

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

形式: create-jdbc-datasource --user admin_user [--password admin_password] [--port port_number] [--host host_name] [--passwordfile file_name] [--terse=true|false] [--echo=true|false] [--interactive=true|false] --dataSourceType type_name [--jdbcMajorVersion number] [--jdbcMinorVersion number] [--minPoolSize size] [--maxPoolSize size] [--initialPoolSize size] [--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] [--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コマンドを使用してください。このコマンドはリモートモードでのみ使用できます。

オプション

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

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

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

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

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

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

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

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

--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: J2EEのトランザクション内で、接続先が同じデータベースの、複数ユーザのJDBCコネクションを使用するかどうかのブール値

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

--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 :	コマンド実行失敗

関連事項: delete-jdbc-datasource(1) list-jdbc-datasources(1) ping-jdbc-datasource(1) reset-jdbc-datasource(1) reset-all-jdbc-datasources(1)