wsadmin スクリプト・ツールを使用して、新規のデータ・ソースを構成することができます。
始める前に
このタスクを開始する前に、wsadmin ツールが稼働している必要があります。
詳しくは、『wsadmin スクリプト・クライアントの開始』を参照してください。
WebSphere® Application Server では、データベース・ベンダーが必要とするすべての JDBC ドライバー・プロパティーを、データ・ソース・プロパティーとして設定する必要があります。
の項目を参照して、JDBC プロバイダー・タイプで順序付けられたこれらのプロパティーおよび設定オプションのリストを表示してください。データベース・ベンダー文書を調べて、使用可能なオプションのデータ・ソース・プロパティーについて学習します。
データ・ソースを作成した後でカスタム・プロパティー としてデータ・ソース・プロパティーをスクリプトします。詳しくは、この項目の関連リンクのセクションで、リンク「スクリプトによる新規データ・ソース・カスタム・プロパティーの構成 (Configuring new data source custom properties using scripting)」をクリックします。
![[z/OS]](../images/ngzos.gif)
以下の JDBC プロバイダーの 1 つを使用する場合は、ご使用のバージョンの DB2® for z/OS® の「
Application Programming Guide and Reference for Java」で、オプションのデータ・ソース・プロパティーについて学習することもできます。
- DB2 for z/OS ローカル JDBC プロバイダー (RRS) JDBC プロバイダー (DB2 JDBC/SQLJ ドライバーを使用)
- DB2 Universal JDBC Driver プロバイダー
このタスクについて
このタスクを実行するには、2 つの方法があります。次の wsadmin スクリプト・オブジェクトのいずれかを使用してください。
- AdminTask オブジェクト
- AdminConfig オブジェクト
AdminConfig では AdminTask オブジェクトより多くの構成制御ができます。
AdminTask を使用してデータ・ソースを作成すると、データ・ソースの JNDI 名のように、ユニバーサルで必要なプロパティーのみを提供します。
(詳しくは、『AdminTask オブジェクトの JDBCProviderManagement コマンド・グループ』の項目を参照してください。)JDBC ドライバーが必要とするその他のプロパティーには、Application Server によってデフォルト値が割り当てられます。
AdminTask コマンドを使用してこれらのプロパティーを設定したり編集したりすることはできません。設定や編集には AdminConfig コマンドを使用する必要があります。
手順
- AdminConfig オブジェクトを使用して新規データ・ソースを構成します。
- 親 ID を識別します。親 ID は、データ・ソースをサポートする JDBC プロバイダーの名前とロケーションです。
出力例:
JDBC1(cells/mycell/nodes/mynode|resources.xml#JDBCProvider_1)
- 必須属性を取得します。
ファースト・パス: サポートされる JDBC ドライバーについては、管理コンソール・ロジックにより使用される、事前に構成された同じテンプレートに従ってデータ・ソースもスクリプトできます。
詳しくは、トピック『wsadmin スクリプト・ツールによる構成オブジェクトの作成』を参照してください。
出力例:
Attribute Type
name String
ヒント: データベース・ベンダーが必要とするプロパティー (トピック『ベンダーによる、データ・ソースの最小必要設定』で参照されている) が必須属性の結果リストに表示されていない場合は、データ・ソースを作成した後で、それらのプロパティーをデータ・ソース・カスタム・プロパティーとしてスクリプトします。
- 必須属性をセットアップします。
- データ・ソースを作成します。
Jacl を使用:
set newds [$AdminConfig create DataSource $newjdbc $dsAttrs]
Jython の使用:
newds = AdminConfig.create('DataSource', newjdbc, dsAttrs)
print newds
出力例:
DS1(cells/mycell/nodes/mynode|resources.xml#DataSource_1)
- AdminTask オブジェクトを使用して新規データ・ソースを構成します。
- 構成の変更を保存します。
詳しくは、『wsadmin ツールによる構成変更の保存』トピックを参照してください。
- ノードを同期します (Network Deployment 環境の場合のみ)。
詳しくは、トピック『wsadmin ツールによるノードの同期化 (Synchronizing nodes with the wsadmin tool)』を参照してください。
次のタスク
ご使用の JDBC ドライバーがサポートする追加プロパティーを設定するには、データ・ソース・カスタム・プロパティーとしてそれらをスクリプトします。