製品のインストールには，日立総合インストーラを使用します。

なお，Windowsの場合には，すべての構成製品のインストールが終わると，再起動を促すダイアログが表示されます。ただし，Cosminexus DABroker Libraryの設定後にも再起動が必要になるため，Cosminexus DABroker Libraryの設定が終了したあとに再起動することをお勧めします。

Windowsの場合のインストール後のCosminexus DABroker Libraryのディレクトリ構成を次の表に示します。これらのディレクトリは，<Cosminexusのインストールディレクトリ>下に作成されます。

表11-3　Cosminexus DABroker Libraryのディレクトリ構成（Windowsの場合）

（凡例）−：該当しません。

Cosminexus DABroker Libraryの動作環境は，環境設定ユティリティで設定します。

環境設定ユティリティにはオンラインヘルプがありますので，設定内容の詳細については，オンラインヘルプを参照してください。［スタート］メニューの［プログラム］から［Cosminexus^※］−［DABrokerLibrary］−［ヘルプ］を選択すると，Cosminexus DABroker Libraryのオンラインヘルプが表示されます。

注※

プログラムフォルダ名を変更している場合，任意のプログラムフォルダから，選択してください。

また，環境設定ユティリティでは，トレース取得の設定ができます。Cosminexus DABroker Libraryで取得できるトレースについては，「11.5.3　Cosminexus DABroker Libraryで取得できるトレース」を参照してください。

ここでは，Cosminexus DABroker Libraryの動作環境の設定について説明します。

(a)　Cosminexus DABroker Libraryの動作環境の設定手順

Cosminexus DABroker Libraryの動作環境の設定手順を次に示します。

1. 環境変数を設定します。
   システム環境変数のPATHに「<Cosminexusのインストールディレクトリ>\DAB\lib」を設定してください。設定されていない場合，環境設定ユティリティは起動できません。
   
2. ［スタート］メニューの［プログラム］から［Cosminexus］−［DABrokerLibrary］−［環境設定］を選択します。
   ［DABroker動作環境設定］ダイアログが表示されます。
   

   

3. ［DABroker動作環境設定］ダイアログで必要事項を設定して，［適用］ボタンをクリックします。
   ［DABroker動作環境設定］ダイアログには次の三つのタブがあります。
   
   • ［共通設定］タブ
   • ［リモートアクセス設定］タブ
   • ［for C++設定］タブ
   各タブの設定内容については，以降で説明します。
   
4. ［DABroker動作環境設定］ダイアログでの必要事項の設定が終わったら，［OK］ボタンをクリックしてダイアログを閉じます。
5. システムを再起動します。

(b)　［共通設定］タブの設定内容

ここでは，［共通設定］タブの設定内容について説明します。Cosminexus DABroker Libraryを使用する場合の［共通設定］タブの設定内容を次に示します。

1. 「作業ディレクトリ」に，作業ディレクトリ（例：「C:\Program Files\Hitachi\Cosminexus\DAB\tmp」）が表示されていることを確認します。
2. 「使用するORACLEのバージョン」に，Oracleのバージョン（例：ORACLE9i）を指定します。
3. 拡張データベースアクセストレースを取得する場合は，［拡張データベースアクセストレースを取得する］チェックボックスをチェックします。
4. 拡張データベースアクセストレースを取得する場合は，［データベースアクセストレース設定］ボタンをクリックします。
   ［アクセストレース設定］ダイアログが表示されます。
   
5. ［アクセストレース設定］ダイアログで，取得しない情報の項目のチェックを外して，［OK］ボタンをクリックします。
   ［DABroker動作環境設定］ダイアログに戻ります。
   
6. XAトレースを取得する場合は，［XAトレースを取得する］チェックボックスをチェックします。
7. ［適用］ボタンをクリックします。

(c)　［リモートアクセス設定］タブの設定内容

ここでは，［リモートアクセス設定］タブの設定内容について説明します。Cosminexus DABroker Libraryを使用する場合の［リモートアクセス設定］タブの設定内容を次に示します。

1. 次の項目を設定します。
   
   • HiRDBのBLOB型データ受取バッファサイズ
   • ORACLEのLONG型データ受取バッファサイズ
   • 漢字コードセット
2. ［適用］ボタンをクリックします。

(d)　［for C++設定］タブの設定内容

ここでは，［for C++設定］タブの設定内容について説明します。Cosminexus DABroker Libraryがインストールされている環境で，DABroker for C++をインストールし，DABroker for C++を使用してデータベースにアクセスする場合の設定です。

［for C++設定］タブでは，DABroker for C++を使用して開発したJ2EEアプリケーションからのアクセスでエラーが発生した場合の，DABroker for C++のイベントトレースの取得について設定します。エラーが発生した場合にイベントトレースを取得しておくことで，トレースを参照してエラーに対処できるようになります。

Cosminexus DABroker Libraryを使用する場合の［for C++設定］タブの設定内容を次に示します。

1. イベントトレースの取得の有無，取得する場合のトレース取得サイズやトレース取得レベルを設定します。
2. 取得するトレースの種別を設定します。
3. ［適用］ボタンをクリックします。

DABroker for C++のイベントトレースの詳細については，マニュアル「DABroker for C++」を参照してください。

(e)　環境設定ユティリティとファイルとの対応

環境設定ユティリティで設定した内容は，Cosminexus DABroker Library動作環境定義ファイルに反映されます。環境設定ユティリティとCosminexus DABroker Library動作環境定義ファイルの対応を次の表に示します。

表11-4　環境設定ユティリティとCosminexus DABroker Library動作環境定義ファイルの対応

環境設定ユティリティの［アクセストレース設定］ダイアログの項目とCosminexus DABroker Library動作環境定義ファイルの対応を次の表に示します。

表11-5　［アクセストレース設定］ダイアログの項目とCosminexus DABroker Library動作環境定義ファイルの対応

Cosminexus DABroker Library動作環境定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「17.2　Cosminexus DABroker Library動作環境定義ファイル」を参照してください。

Cosminexus DABroker Libraryがインストールされている環境で，DABroker for C++をインストールし，DABroker for C++を使用してデータベースに接続する場合には，接続先データベースの定義が必要です。

DABroker for C++を使用してデータベースに接続する場合は，接続先データベース定義ユティリティで設定したデータベース種別名，およびデータベース名を使用してデータベースにアクセスします。接続先データベース定義ユティリティで設定した情報を使用すると，接続条件などが変更されてもアプリケーションを変更する必要がありません。ただし，OTS機能，またはJTS機能を使用する場合は，接続先データベース定義ユティリティで設定した情報を使用できません。

(a)　接続先データベース定義の設定

接続先データベース定義ユティリティは，プログラムフォルダに登録された「DABroker接続先データベース定義」から起動します。「DABroker接続先データベース定義」は，すべてのユーザが操作できます。

接続先データベース定義ユティリティで設定した内容は，接続先データベース定義ファイル（<Cosminexus DABroker Library運用ディレクトリ>\conf\dabenv）に出力されます。なお，Cosminexus DABroker Library運用ディレクトリは，Cosminexus DABroker Libraryのインストールディレクトリ（<Cosminexusのインストールディレクトリ>\DAB）です。

接続先データベース定義の設定手順を次に示します。

1. プログラムフォルダに登録された［接続先データベース定義］を起動します。
   ［DABroker接続先データベース定義］ダイアログが表示されます。
   

   

2. 使用するデータベースの製品名が記載されたタブを選択し，接続情報を設定します。
   次の情報を定義します。
   
   • データベース種別名
     使用するデータベースに対して付ける任意の名称です。
     
   • データベース名
     データベースごとに異なる情報の集まりに対して付ける任意の名称です。
     
   • データベース名のグループに定義する情報
     データベース名のグループに定義する情報は，データベースごとに異なります。詳細については，「(b)　データベース名のグループに定義する情報」を参照してください。
     
3. ［接続先データベース定義］ダイアログでの必要事項の設定が終わったら，［OK］ボタンをクリックしてダイアログを閉じます。

なお，［接続先データベース定義］ダイアログで設定する，データベース種別名，データベース名，およびデータベース名のグループに定義する情報は，次のような親子関係になります。

この例で示すように，データベース名は，同一データベース種別名に対して，複数定義できます。例えば，ホスト名が異なる二つのHiRDBを，一つのデータベース種別として定義し，アプリケーションでは，データベース名でホストの異なるHiRDBを使い分けられます。このような場合の［接続先データベース定義］ダイアログでの設定方法を次に示します。

• データベース種別名，データベース名を新規登録する場合
  設定後，［追加］ボタンを選択します。
  
• 同一データベース種別名に対して，別のデータベース名を登録する場合
  設定後，［追加］ボタンを選択します。
  
• 登録されている情報を変更する場合
  登録内容を変更したあと，［追加］ボタンを選択します。
  
• データベース種別名またはデータベース名を削除する場合
  削除するデータベース種別またはデータベース名を選択して［削除］ボタンを選択してください。
  

(b)　データベース名のグループに定義する情報

データベース名のグループに定義する情報について，データベースごとに説明します。

●HiRDBまたはXDM/RD E2を使用する場合

HiRDBまたはXDM/RD E2を使用する場合に，データベース名のグループに定義する情報を次の表に示します。

表11-6　データベース名のグループに定義する情報（HiRDBまたはXDM/RD E2を使用する場合）

注※

J2EEアプリケーションでユーザIDとパスワードを指定していない場合は，ここで指定したユーザID，パスワードを使用してデータベースにアクセスします。Cosminexus DABroker Libraryでは，接続先データベース定義ファイルの出力時にパスワードを暗号化していないため，パスワードはJ2EEアプリケーション側で指定するようにしてください。

なお，接続先データベース定義ユティリティで複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

●Oracleを使用する場合

Oracleを使用する場合に，データベース名のグループに定義する情報を次の表に示します。

表11-7　データベース名のグループに定義する情報（Oracleを使用する場合）

注※

J2EEアプリケーションでユーザIDとパスワードを指定していない場合は，ここで指定したユーザID，パスワードを使用してデータベースにアクセスします。Cosminexus DABroker Libraryでは，接続先データベース定義ファイルの出力時にパスワードを暗号化していないため，パスワードはJ2EEアプリケーション側で指定するようにしてください。

なお，接続先データベース定義ユティリティで複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

J2EEアプリケーションを運用する前に，次の設定をしてください。

• J2EEアプリケーションの組み込み
• J2EEアプリケーションのインタフェースの定義
• サーバで動作するJ2EEアプリケーションの動作環境の設定

(a)　J2EEアプリケーションの組み込み

Cosminexus DABroker Libraryが組み込まれたサーバにJ2EEアプリケーションを格納します。また，次に示すクラスパスを指定します。

• <Cosminexusのインストールディレクトリ>\DABJ\JdbcDbpsv.jar
• <Cosminexusのインストールディレクトリ>\DABJ\JdbcDbpsvEx.jar^※
  

  注※

  Cosminexus DABroker LibraryでJDBC2.0拡張機能を使用する場合に，このパスを指定してください。

ここでは，例として，「<Cosminexusのインストールディレクトリ>\DABJ\JdbcDbpsvEx.jar」をクラスパスとして指定します。

簡易構築定義ファイルでは，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにクラスパスの設定を追加します。なお，指定するパラメタの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6.2　簡易構築定義ファイルの指定内容」を参照してください。

 
<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <!-- Webシステムの属性定義 -->
  <web-system>
    <name>MyWebSystem</name>
      :
    <!-- 物理ティア(combined-tier)の定義 -->
    <tier>
      <tier-type>combined-tier</tier-type>
      <!-- J2EEアプリケーションの組み込みの設定 -->
      <configuration>
        <logical-server-type>j2ee-server</logical-server-type>
        <param>
           <param-name>add.class.path</param-name>
           <param-value><Cosminexusのインストールディレクトリ>\DABJ\JdbcDbpsvEx.jar</param-value>
        </param>
      </configuration>
    </tier>
      :
  </web-system>
  <host>
    :
</model-definition>
 

注　太字の部分が編集部分です。

(b)　J2EEアプリケーションのインタフェースの定義

J2EEアプリケーションのインタフェースを定義します。

(c)　サーバで動作するJ2EEアプリケーションの動作環境の設定

Cosminexus DABroker Libraryでは，JNIを使ってDABrokerの提供するネイティブライブラリを使用します。Cosminexus DABroker Libraryをサーバで動作するJavaアプリケーションとして動作させるときは，次の設定が必要です。

• ネイティブライブラリの動作環境の設定
• データベースクライアントライブラリの動作環境の設定

●ネイティブライブラリの動作環境の設定

ネイティブライブラリはJDBCドライバを実行する（呼び出す）プロセス上で読み込まれて動作するので，ネイティブライブラリ実行のための動作環境を設定する必要があります。

設定内容

システム環境変数のPATHに「<Cosminexus DABroker Library運用ディレクトリ>\lib」を設定します。

●データベースクライアントライブラリの動作環境の設定

ネイティブライブラリは，データベースにアクセスする場合に，各データベースが提供するクライアントライブラリを呼び出します。データベースクライアントライブラリの動作環境の設定を次に示します。

1. データベースライブラリのパスを設定します。
   特別な設定は必要ありません。ただし，接続するデータベースによっては動作環境の設定が必要な場合があります。詳細については，接続するデータベースのマニュアルなどを参照してください。
   PATHに，次の値を設定します。
   
   • HiRDB，またはXDM/RD E2の場合：HiRDBクライアントライブラリのパス名
   • Oracleの場合：Oracleライブラリ（libclntsh）のパス名
2. データベースの提供する環境変数を設定します。
   JDBCドライバを実行する（呼び出す）プロセス上で有効な環境変数として，各データベースの提供する環境変数を設定する必要があります。
   詳細については，「11.2.3　データベースの設定」，接続するデータベースのマニュアルなどを参照してください。