ここでは，DABrokerをインストールする操作について説明します。

(a)　DABrokerをインストールするマシン

DABrokerは，EUR Developer，EUR Print ServiceまたはEUR Print Service Enterpriseと同じマシンにインストールしてください。DABrokerはリレーショナルデータベースのクライアントアプリケーションとなるため，データベースと接続するためにリレーショナルデータベースのサーバプログラム，またはリレーショナルデータベースのクライアントプログラムが必要です。

なお，次のような場合は，あらかじめインストールするマシンに次のような設定をしてください。

DABrokerとOracleを別のマシンに配置する場合

Oracleのクライアントの設定をしてください。そこで設定したサービス（リスナー）名称は，EURが使用する接続情報ファイルで指定してください。帳票設計時はEUR ODBC Driverで指定してください。

クライアントの設定については，Oracleのマニュアルを参照してください。

Microsoft SQL Serverを使用する場合

ODBCデータソースアドミニストレータを使用してMicrosoft SQL ServerのODBCドライバをシステムDSNで設定しておく必要があります。その際，ログインIDの権限の確認方法は「ユーザが入力するSQL Server用のログインIDとパスワードを使う」を選択してください。

そこで設定したSQLサーバのデータソース名称は，EURが使用する接続情報ファイルで指定してください。帳票設計時はEUR ODBC Driverで指定してください。

(b)　インストール

DABrokerをインストールするには，「DABroker.msi」を実行してください。

「DABroker.msi」は，EUR Developer，EUR Print Service，またはEUR Print Service Enterpriseのインストール先フォルダ\Bundle\DABroker\下にあります。

インストールしたあと，次のように設定してください。

環境変数を設定する

DABrokerをインストールしたあと，システム環境変数のPathに「DABrokerインストールディレクトリ\lib」を必ず設定してください。環境変数を設定し，マシンを再起動すると，DABrokerを使用できるようになります。

(c)　インストール時に作成されるディレクトリ

DABrokerのインストール時に作成されるディレクトリを次の表に示します。これらのディレクトリは，DABrokerのインストール先に指定したディレクトリの下に作成されます。

なお，DABrokerのインストール先に指定したディレクトリを，これ以降DABroker運用ディレクトリと呼びます。

表B-1　DABrokerのディレクトリ

ディレクトリ		説明
DABroker	−	DABrokerのインストール先ディレクトリ （＝DABroker運用ディレクトリ）
	\bin	実行ファイル格納ディレクトリ
	\lib	ライブラリ格納用ディレクトリ
	\AGT	エージェント処理用ディレクトリ
	\AGTGRP	グループ管理用ディレクトリ
	\msg	メッセージ用ディレクトリ
	\conf	DABroker動作環境定義ファイル格納ディレクトリ
	\spool	DABrokerスプールディレクトリ
	\tmp	DABroker標準作業ディレクトリ

（凡例）

−：該当するディレクトリはありません。

TCP/IP環境でのDABrokerのサービス名およびポート番号として，「Windowsインストールフォルダ\system32\drivers\etc\services」ファイルに次の記述を追加してください。DABrokerのサービス名の指定は省略できません。

DABROKER_SV　40179/tcp

DABROKER_SV：DABrokerのサービス名です。

40179：ポート番号です。

tcp：プロトコル名です。TCP/IPを使用することを示します。

注意

• servicesファイルでの設定で，40179がほかのサービス名で使用されている場合は，5001〜65535の範囲内で任意の番号を指定してください。ただし，ポート番号はクライアント側と同じ番号を指定してください。
• NIS（Network Information Service）を使用している場合，ネットワーク環境をNISのサーバで設定してください。NISのサーバを使用している場合，ネットワーク環境の設定は，NISのサーバでの設定が有効になります。
• クライアント側では，使用する通信ドライバに，DABrokerの組み込まれたサーバのホスト名，IPアドレスおよびポート番号を登録してください。

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

(a)　環境設定の方法

DABroker動作環境は，「DABroker動作環境定義ファイル」を設定して定義します。このファイルの定義にはDABrokerが提供する環境設定ユティリティを使用します。環境設定ユティリティは，プログラムフォルダに登録された［DABroker環境設定］から起動します。

(b)　操作できるユーザ

環境設定ユティリティを実行して，DABroker動作環境定義ファイルを操作できるのは，Windowsの管理者グループまたはAdministratorsグループに属するユーザです。

(c)　操作方法

環境設定ユティリティは，DABrokerが終了している状態で使用します。環境設定後にDABrokerを起動すると，変更したDABroker動作環境定義ファイルの内容が有効になります。

操作方法を次に示します。EURに関連する項目について次にに説明します。

1. プログラムフォルダに登録された［環境設定］を起動する
   環境設定ユティリティが起動し，［DABroker動作環境設定］ダイアログが表示されます。
   
2. ［共通設定］タブ，および［リモートアクセス設定］タブの項目を設定する
3. 設定内容を確認して［OK］ボタンを選択する
   設定した内容が登録され，環境設定ユティリティは終了します。
   

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

記載のない項目については，次の図に示す標準値のままで使用してください。

図B-2　［共通設定］タブの設定内容

1. 作業ディレクトリ名（DABTMP）
   

   標準値

   DABroker運用ディレクトリ\tmp

   指定範囲

   任意のディレクトリ（ただし，パーティションを圧迫しないところ）。ただし，ネットワークドライブ上のディレクトリは指定できません。また，指定したディレクトリのアクセス権限として，システムにフルコントロールを指定してください。

   説明

   DABrokerの作業ディレクトリを指定します。このディレクトリは，予約処理用のSQLの格納や，処理途中で作成される一時ファイルの格納などに使用されます。

   ［...］ボタンを押すと，［ディレクトリ選択］ダイアログが表示されます。

2. ログファイルサイズ［dabsv.log］（DABSVLOGSIZE）
   

   標準値

   64（キロバイト）

   指定範囲

   0，または64〜32,767（キロバイト）

   説明

   DABrokerのログを取得するファイルの容量を設定します。ログはDABroker運用ディレクトリ\spool\dabsv.logに取得されます。

   0を設定した場合

   ファイルの容量は無限大になります。

   64〜32,767を設定した場合

   設定した値がファイルの容量になります。

   注意

   ログファイルが満杯になったら，ラップアラウンドでログを取得します。ラップアラウンドした場合，1世代前のバックアップファイル（dabsv.logold）を作成し，1世代だけを管理します。

3. 使用するORACLEのバージョン（DABORACLE_TYPE）
   

   標準値

   Oracle9i

   指定範囲

   Oracle9i，Oracle 10g，またはOracle 11g

   説明

   使用するOracleのバージョンを設定します。

4. HiRDBのディクショナリ表のデータ属性（DABSQL_HiRDB_DICTIONARY_DATATYPE）
   

   標準値

   C：VARCHAR

   指定範囲

   MまたはC

   説明

   HiRDBのディクショナリ表の列属性を指定します。

   Mを設定した場合

   混在文字データ（MVARCHAR）として処理します。

   Cを設定した場合

   文字データ（VARCHAR）として処理します。

   注意

   ここでの指定とHiRDBで使用されているディクショナリ表のデータ属性が異なる場合は，結果不正やSQLエラーになる場合があります。

5. HiRDB環境変数区切り文字（DAB_HIRDB_DBINF_ESC）
   

   標準値

   @

   指定範囲

   @　!　$　%　&　*　+　-　/　:　?　\　|

   説明

   HiRDB環境変数区切り文字を指定します。

   注意

   特に問題がない場合，区切り文字には@を使用してください。

   区切り文字は必ず半角1文字で指定してください。全角文字は指定できません。

   DABroker Driver for Java^TM TechnologyからHiRDBクライアント環境変数グループを指定してデータベースと接続する場合は，標準値「@」を指定してください。

6. データベースアクセストレースを取得する（DABSQL_TRCSIZE）
   

   標準値

   OFF（取得しません）

   指定範囲

   OFF（チェックなし），またはON（チェックあり）

   （OFF：取得しません　ON：取得します）

   説明

   データベースアクセストレースを取得するかどうかを設定します。アクセストレースの出力については，「付録B.3(2)　DABrokerトレース出力ユティリティ」を参照してください。

   ［データベースアクセストレース設定］ボタンを押すと［アクセストレース設定］ダイアログが表示され，アクセストレースで出力する項目を選択できます。

   取得するを設定した場合

   次に示すファイル名ですべてのアクセストレースを取得するファイルが，DABroker運用ディレクトリ\spool\db_accessの下に作成されます（データベースアクセストレースはDABrokerトレース出力ユティリティで出力します）。

   db_XXXXX

   XXXXX：システム任意の番号

   ハードディスクの空き容量がなくなった場合，それ以降のアクセストレースは取得しません。なお，格納する領域のサイズは設定できません。

   クライアントからの要求量が多い場合は，トレースのファイル容量も多く必要です。ハードディスクの容量に余裕をもたせてください。必要容量の概算方法については，「付録B.3(2)　DABrokerトレース出力ユティリティ」のデータベースアクセストレースの出力の注意事項を参照してください。また，クライアントからの要求量が多ければ，DABrokerを終了するまでに時間が掛かります。ご注意ください。

   取得しないを設定した場合

   データベースアクセストレースを取得しません。

7. 拡張データベースアクセストレースを取得する（DABEXSQL_TRC_LINE）
   

   標準値

   OFF（取得しません）

   指定範囲

   OFF（チェックなし），またはON（チェックあり）

   （OFF：取得しません　ON：取得します）

   説明

   拡張データベースアクセストレースを取得するかどうかを設定します。

   OFF（チェックなし）を設定した場合

   拡張データベースアクセストレースを取得しません。

   ON（チェックあり）を設定した場合

   拡張データベースアクセストレースを取得します。

   拡張データベースアクセストレースの詳細については，「付録B.3(3)　拡張データベースアクセストレースユーティリティ」を参照してください。

8. トレースファイルサイズ
   

   標準値

   1,024（行）

   指定範囲

   0（トレース取得行数を無限大にします），または1,024〜32,767（行）

   説明

   「7.拡張データベースアクセストレースを取得する（DABEXSQL_TRC_LINE）」でONを設定した場合に，拡張データベースアクセストレースのトレースファイルサイズを指定します。

   0を設定した場合

   出力行数は，無限大となります。

   1,024〜32,767を設定した場合

   拡張データベースアクセストレースを取得します。出力行数は，設定した数値分となります。

   拡張データベースアクセストレースのファイルは，1行に134バイトまで出力されます。拡張データベースアクセストレースのファイルの出力行数は，ここでの設定値に従います。ただし，ヘッダは行数に含まれません。

   拡張データベースアクセストレースの詳細については，「付録B.3(3)　拡張データベースアクセストレースユーティリティ」を参照してください。

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

図B-3　［リモートアクセス設定］タブの設定内容

1. クライアントからの要求待ちタイムアウト（DABCLIENT_TIMEOUT）
   

   標準値

   3,600（秒）

   指定範囲

   0，または1〜65,535（秒）

   説明

   クライアントからの要求待ちタイムアウトを監視するかどうかを設定します。

   1〜65,535（秒）を設定した場合

   DABrokerがアクセス要求に対する応答をクライアントに返してから，次のアクセス要求を受けるまでの時間を監視します。

   ここで設定した時間を超えてクライアントからのアクセス要求がない場合，DABrokerは次の処理をします。

   クライアントに対しては，要求待ちタイムアウトの発生を通知して，コネクションを解放します。処理を続ける場合，クライアントは一度終了して再起動する必要があります。

   データベースに対しては，このタイムアウトが発生したクライアントの処理がデータベースで実行中の場合は，トランザクションのロールバックを要求し，データベースを切り離します。

   0を設定した場合

   クライアントからの要求待ちタイムアウトを監視しません。

2. 最大接続ユーザ数（DABMAXUSERS）
   

   標準値

   10（ユーザ）

   指定範囲

   1〜100,000（ユーザ）

   説明

   コネクションを確立できる最大ユーザ数を設定します。ここで設定した値を超えるユーザが接続しようとした場合，DABrokerは，クライアントにエラーメッセージを返してコネクションを確立しません。

   EURから同時にデータベースをアクセスするユーザ数以上の値を指定してください。

3. 同時実行可能なデータベースアクセス数（DABDBANUMBER）
   

   標準値

   20（データベース接続数）

   指定範囲

   1〜100,000（データベース接続数）

   説明

   DABrokerが一度に受け付けられる，複数のクライアントからのデータベースアクセス要求（同期アクセス処理要求）の合計数を設定します。ここで設定した値を超える要求があった場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

   EURで使用する場合は，最大接続ユーザ数以上の値を指定してください。

4. 1プロセス当たりの実行ユーザ数（DABMAXBLOCKUSERS）
   

   標準値

   1（ユーザ数）

   指定範囲

   1〜100（ユーザ数）

   説明

   一つのプロセスで処理する最大ユーザ数を設定します。ここで設定した値を超えた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

   EURで使用する場合は，1を指定してください。

5. 最大処理プロセス数（DABMAXPROCESS）
   

   標準値

   10（プロセス数）

   指定範囲

   1〜1,000（プロセス数）

   説明

   DABrokerで起動する最大プロセス数を設定します。ここで設定した値を超えた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

   （1プロセス当たりの実行ユーザ数×最大処理プロセス数）が最大接続ユーザ数以上となるように指定してください。

6. 漢字コードセット（DABLANGMODE）
   

   標準値

   SJIS（シフトJISモード）

   指定範囲

   SJIS（シフトJISモード），UTF-8（UTF-8モード），またはASCII（ASCIIモード）

   説明

   DABrokerが稼働する言語モードを設定します。

   各言語モードで操作できるデータベースを次の表に示します。

   表B-2　各言語モードで操作できるデータベース

   データベース	DABrokerでの設定
   	シフトJISモード	UTF-8モード	ASCIIモード
   HiRDB	○	○	○
   Oracle	○	○	○
   SQL Server	○	○※	○
   VOS3 XDM/RD E2	○	×	○

   （凡例）

   ○：操作できる

   ×：操作できない

   注※

   SQL Server 2000の場合は操作できません。

   
   

   各データベースで使用する言語モードは，必ずDABrokerの言語モードと合わせてください。データベースとDABrokerの言語モードが異なっている場合は動作を保証しません。

   SQL Server 2005以降でUTF-16を使用する場合は，DABrokerの言語モードにUTF-8を指定してください。

   DABrokerを日本語EUCモード，ASCIIモード，またはUTF-8モードで動作させた場合，メッセージは英文で出力されます。

7. TCP/IP通信時キープアライブを監視する（DABKEEPALIVE）
   

   標準値

   OFF（キープアライブによる監視を行いません）

   指定範囲

   OFF（チェックなし），またはON（チェックあり）

   （OFF：キープアライブによる監視を行いません　ON：キープアライブによる監視を行います）

   説明

   キープアライブによる監視を行うかどうかを設定します。キープアライブとは，クライアントとの通信経路が確立されているかどうかを常に監視するTCP/IPの機能です。

   ONを設定した場合

   キープアライブによる監視が行われます（クライアントとの通信径路を監視する）。

   OFFを設定した場合

   キープアライブによる監視は行われません（クライアントとの通信径路を監視しない）。

8. IPアドレスからホスト名へ変換する（DABIPCONVERT）
   

   標準値

   ON（変換します）

   指定範囲

   OFF（チェックなし），またはON（チェックあり）

   （OFF：変換しません　ON：変換します）

   説明

   メッセージおよびユティリティで表示されるIPアドレスをホスト名に変換するかどうかを設定します。

   ONを設定した場合

   表示されるIPアドレスをホスト名に変換します。

   動作環境によってこの変換処理に時間が掛かり，接続処理が遅くなることがあります。

   OFFを設定した場合

   表示されるIPアドレスをホスト名に変換しません。

9. 通信トレースの取得をする（DABTCP_TRCSIZE）
   

   標準値

   OFF（取得しません）

   指定範囲

   OFF（チェックなし），またはON（チェックあり）

   （OFF：取得しません　ON：取得します）

   説明

   クライアントとの通信トレースを取得するかどうかを設定します。通信トレースの出力については，「付録B.3(2)　DABrokerトレース出力ユティリティ」を参照してください。

   「取得する」を設定した場合

   次に示すファイル名ですべての通信トレースを取得するファイルがDABroker運用ディレクトリ\spool\dabcltrcの下に作成されます（通信トレースはDABrokerトレース出力ユティリティで出力します）。

   XXXXXXXX.cmt

   XXXXXXXX.cmt_AA〜AA

   XXXXXXXX：任意の文字列

   AA〜AA：任意の文字列

   ハードディスクの空き容量がなくなった場合，それ以降の通信トレースは取得しません。なお，格納するファイルサイズは設定できません。

   クライアントからの要求量が多い場合は，トレースのファイルの容量も多く必要です。ハードディスクの容量は余裕を持たせてください。必要容量の概算方法については，マニュアル「DABroker」を参照してください。また，クライアントからの要求量が多ければ，DABrokerを終了するまでに時間が掛かります。ご注意ください。

   「取得しない」を設定した場合

   クライアントとの通信トレースを取得しません。