このセクションでは、以下について説明します。
JDBCODA をインストールするには、IBM WebSphere Business Integration Server Express および Express Plus のインストーラーを使用し、Windows 版、OS/400 版、または Linux 版の「WebSphere Business Integration Server Express インストール・ガイド」の指示に従って操作します。インストールが完了すると、この製品のインストール先のディレクトリーに以下のファイルがインストールされます。
JDBCODA を使用するには、以下を実行する必要があります。
表 13. Windows の場合のシェルおよびバッチ・ファイルの構成変数
変数 | 説明 | 例 |
---|---|---|
AGENTNAME | ODA の名前。 |
set AGENTNAME=JDBCODA
|
AGENT | ODA の JAR ファイルの名前。 |
set AGENT= %CROSSWORLDS%¥ODA¥JDBC¥JDBCODA.jar
|
DRIVERPATH | JDBC ドライバー・ライブラリーのパス。JDBCODA は、ドライバー・クラスを使用して、特定のデータベースへの接続を確立します。 |
set DRIVERPATH=%CROSSWORLDS%¥ /
lib¥xwutil.jar;%CROSSWORLDS%¥lib¥ /
xwbase.jar;%CROSSWORLDS%¥lib¥ /
xwsqlserver.jar;%CROSSWORLDS%¥lib¥ /
spy¥lib¥spy.jar
|
DRIVERLIB | JDBC ドライバーによって使用されるネイティブ・ライブラリーのパス。 |
DRIVERLIB=%CROSSWORLDS%¥bin¥db2jdbc.dll
|
表 14. Linux の場合のシェルおよびバッチ・ファイルの構成変数
変数 | 説明 | 例 |
---|---|---|
AGENTNAME | ODA の名前。 | set AGENTNAME=JDBCODA |
AGENT | ODA の JAR ファイルの名前。 | set AGENT= ${CROSSWORLDS}/ODA/JDBC/JDBCODA.jar |
DRIVERPATH | JDBC ドライバー・ライブラリーのパス。JDBCODA は、ドライバー・クラスを使用して、特定のデータベースへの接続を確立します。 | set DRIVERPATH=${CROSSWORLDS}/ lib/xwutil.jar:${CROSSWORLDS}/lib/ xwbase.jar:${CROSSWORLDS}/lib/ xwsqlserver.jar:${CROSSWORLDS}/lib/ xworacle.jar:${CROSSWORLDS}/lib/ spy/lib/spy.jar:${CROSSWORLDS}/lib/ db2java.zip |
DRIVERLIB | JDBC ドライバーによって使用されるネイティブ・ライブラリーのパス。 | DRIVERLIB=${CROSSWORLDS}/bin |
JDBC ドライバーのインストールと、シェル・ファイルまたはバッチ・ファイルの構成値の設定を完了したら、以下の手順を実行して、ビジネス・オブジェクトを生成します。
このステップについては、以下のセクションで詳しく説明します。
JDBCODA を起動するには、ご使用のオペレーティング・システムに応じた始動スクリプトを使用します。
Windows での ODA の起動
start_JDBCODA.bat
OS/400 を始動するには、以下の方法のいずれかを使用します。
pathToODAStartScript jobDescriptionName
ここで、pathToODAStartScript は ODA 始動スクリプトへの絶対パス、jobDescriptionName は QWBISVR43 ライブラリーで使用するジョブ記述の名前です。
start_ODAName.sh
OS/400 での ODA の停止
OS/400 での ODA の停止方法は、始動方法によって異なります。OS/400 での ODA の起動のオプション 1 または 2 を使用した場合は、次のように操作します。
OS/400 での ODA の起動 のオプション 3 を使用して ODA を始動した場合は、start_ODAName.sh スクリプトを実行した QSHELL コマンド入力から F3 を押します。
Linux:
start_JDBCODA.sh
JDBCODA を構成して実行するには、Business Object Designer Express を使用します。Business Object Designer Express は、各スクリプト・ファイルまたはバッチ・ファイルの AGENTNAME 変数に指定された名前に基づいて、各 ODA を探し出します。このコネクターのデフォルト ODA の名前は、JDBCODA です。
ODA のインスタンスを複数実行する場合には、ODA の名前を変更することを推奨します。一意的に命名された追加の JDBCODA インスタンスを作成するには、次のようにします。
複数の ODA インスタンスを複数の異なるマシン上で実行する場合には、それらの名前の先頭にホスト・マシン名を付けることを推奨します。
ODA の選択は、実行する ODA の選択方法を示しています。
エラー・メッセージおよびトレース・メッセージ用のファイル (デフォルトは JDBCODAAgent.txt) は ¥ODA¥messages¥ にあります。このディレクトリーは製品ディレクトリーの下にあります。このファイルには、次の命名規則が適用されます。
AgentNameAgent.txt
ODA スクリプト・ファイルまたはバッチ・ファイルのインスタンスを複数作成し、表現される ODA のそれぞれに固有の名前を与える場合、ODA インスタンスのそれぞれにメッセージ・ファイルを 1 つずつ用意することができます。あるいは、名前の異なる複数の ODA に、同一のメッセージ・ファイルを使用させることもできます。有効なメッセージ・ファイルを指定する方法は、次の 2 つです。
構成処理では、次のものを指定します。
表 15 にこれらの値を示します。
トレース・レベル | 説明 |
---|---|
0 | すべてのエラーを記録します。 |
1 | すべてのメソッド開始/終了メッセージをトレースします。 |
2 | ODA のプロパティーとその値をトレースします。 |
3 | すべてのビジネス・オブジェクトの名前をトレースします。 |
4 | 作成されたスレッドすべての詳細をトレースします。 |
5 | * すべてのプロパティーの ODA 初期化値を示します。* JDBCODA が作成した各スレッドの詳細な状況をトレースします。* ビジネス・オブジェクト定義ダンプをトレースします。 |
これらの値をどこで構成するかについては、"初期化プロパティーの構成"を参照してください。