2.3.4 DABrokerの動作環境の設定
ここでは,DABrokerの動作環境を設定する操作について説明します。DABroker(64)を使用する場合も,必要な設定内容は同じです。
(1) 環境設定の方法
DABroker動作環境は,「DABroker動作環境定義ファイル」を設定して定義します。このファイルの定義にはDABrokerが提供する環境設定ユティリティを使用します。環境設定ユティリティは,プログラムフォルダに登録された[DABroker環境設定]から起動します。
- メモ
-
UNIX/Linux環境の場合,DABroker動作環境定義ファイルは,「DABroker運用ディレクトリ/conf」に格納されています。
(2) 操作できるユーザ
環境設定ユティリティを実行して,DABroker動作環境定義ファイルを操作できるのは,Windowsの管理者グループまたはAdministratorsグループに属するユーザです。
(3) 操作方法
環境設定ユティリティは,DABrokerが終了している状態で使用します。環境設定後にDABrokerを起動すると,変更したDABroker動作環境定義ファイルの内容が有効になります。
操作方法を次に示します。
-
プログラムフォルダに登録された[環境設定]を起動する
環境設定ユティリティが起動し,[DABroker動作環境設定]ダイアログが表示されます。
-
[共通設定]タブ,および[リモートアクセス設定]タブの項目を設定する
-
設定内容を確認して[OK]ボタンを選択する
設定した内容が登録され,環境設定ユティリティは終了します。
(4) [共通設定]タブの設定内容
記載のない項目については,次の図に示す標準値のままで使用してください。
-
作業ディレクトリ名(DABTMP)
- 標準値
-
DABroker運用ディレクトリ\tmp
- 指定範囲
-
任意のディレクトリ(ただし,パーティションを圧迫しないところ)。ただし,ネットワークドライブ上のディレクトリは指定できません。また,指定したディレクトリのアクセス権限として,システムにフルコントロールを指定してください。
- 説明
-
DABrokerの作業ディレクトリを指定します。このディレクトリは,予約処理用のSQLの格納や,処理途中で作成される一時ファイルの格納などに使用されます。
[...]ボタンを押すと,[ディレクトリ選択]ダイアログが表示されます。
-
ログファイルサイズ[dabsv.log](DABSVLOGSIZE)
- 標準値
-
64(キロバイト)
- 指定範囲
-
0,または64〜32,767(キロバイト)
- 説明
-
DABrokerのログを取得するファイルの容量を設定します。ログはDABroker運用ディレクトリ\spool\dabsv.logに取得されます。
0を設定した場合
ファイルの容量は無限大になります。
64〜32,767を設定した場合
設定した値がファイルの容量になります。
- 重要
-
ログファイルが満杯になったら,ラップアラウンドでログを取得します。ラップアラウンドした場合,1世代前のバックアップファイル(dabsv.logold)を作成し,1世代だけを管理します。
-
使用するORACLEのバージョン(DABORACLE_TYPE)
- 標準値
-
使用するDABrokerに依存します。
- 指定範囲
-
使用するDABrokerに依存します。
- 説明
-
使用するOracleのバージョンを設定します。
-
HiRDBのディクショナリ表のデータ属性(DABSQL_HiRDB_DICTIONARY_DATATYPE)
- 標準値
-
C:VARCHAR
- 指定範囲
-
MまたはC
- 説明
-
HiRDBのディクショナリ表の列属性を指定します。
Mを設定した場合
混在文字データ(MVARCHAR)として処理します。
Cを設定した場合
文字データ(VARCHAR)として処理します。
- 重要
-
ここでの指定とHiRDBで使用されているディクショナリ表のデータ属性が異なる場合は,結果不正やSQLエラーになる場合があります。
-
HiRDB環境変数区切り文字(DAB_HIRDB_DBINF_ESC)
- 標準値
-
@
- 指定範囲
-
@ ! $ % & * + - / : ? \ |
- 説明
-
HiRDB環境変数区切り文字を指定します。
- 重要
-
特に問題がない場合,区切り文字には@を使用してください。
区切り文字は必ず半角1文字で指定してください。全角文字は指定できません。
DABroker Driver for Java TechnologyからHiRDBクライアント環境変数グループを指定してデータベースと接続する場合は,標準値「@」を指定してください。
-
データベースアクセストレースを取得する(DABSQL_TRCSIZE)
- 標準値
-
OFF(取得しません)
- 指定範囲
-
OFF(チェックなし),またはON(チェックあり)
(OFF:取得しません ON:取得します)
- 説明
-
データベースアクセストレースを取得するかどうかを設定します。アクセストレースの出力については,「付録A.1(2) DABrokerトレース出力ユティリティ」を参照してください。
[データベースアクセストレース設定]ボタンを押すと[アクセストレース設定]ダイアログが表示され,アクセストレースで出力する項目を選択できます。
取得するを設定した場合
次に示すファイル名ですべてのアクセストレースを取得するファイルが,DABroker運用ディレクトリ\spool\db_accessの下に作成されます(データベースアクセストレースはDABrokerトレース出力ユティリティで出力します)。
db_XXXXX
XXXXX:システム任意の番号
ハードディスクの空き容量がなくなった場合,それ以降のアクセストレースは取得しません。なお,格納する領域のサイズは設定できません。
クライアントからの要求量が多い場合は,トレースのファイル容量も多く必要です。ハードディスクの容量に余裕をもたせてください。必要容量の概算方法については,「付録A.1(2) DABrokerトレース出力ユティリティ」のデータベースアクセストレースの出力の注意事項を参照してください。また,クライアントからの要求量が多ければ,DABrokerを終了するまでに時間が掛かります。ご注意ください。
取得しないを設定した場合
データベースアクセストレースを取得しません。
-
拡張データベースアクセストレースを取得する(DABEXSQL_TRC_LINE)
- 標準値
-
OFF(取得しません)
- 指定範囲
-
OFF(チェックなし),またはON(チェックあり)
(OFF:取得しません ON:取得します)
- 説明
-
拡張データベースアクセストレースを取得するかどうかを設定します。
OFF(チェックなし)を設定した場合
拡張データベースアクセストレースを取得しません。
ON(チェックあり)を設定した場合
拡張データベースアクセストレースを取得します。
拡張データベースアクセストレースの詳細については,「付録A.1(3) 拡張データベースアクセストレースユーティリティ」を参照してください。
-
トレースファイルサイズ
- 標準値
-
1,024(行)
- 指定範囲
-
0(トレース取得行数を無限大にします),または1,024〜32,767(行)
- 説明
-
「7.拡張データベースアクセストレースを取得する(DABEXSQL_TRC_LINE)」でONを設定した場合に,拡張データベースアクセストレースのトレースファイルサイズを指定します。
0を設定した場合
出力行数は,無限大となります。
1,024〜32,767を設定した場合
拡張データベースアクセストレースを取得します。出力行数は,設定した数値分となります。
拡張データベースアクセストレースのファイルは,1行に134バイトまで出力されます。拡張データベースアクセストレースのファイルの出力行数は,ここでの設定値に従います。ただし,ヘッダは行数に含まれません。
拡張データベースアクセストレースの詳細については,「付録A.1(3) 拡張データベースアクセストレースユーティリティ」を参照してください。
(5) [リモートアクセス設定]タブの設定内容
-
クライアントからの要求待ちタイムアウト(DABCLIENT_TIMEOUT)
- 標準値
-
3,600(秒)
- 指定範囲
-
0,または1〜65,535(秒)
- 説明
-
クライアントからの要求待ちタイムアウトを監視するかどうかを設定します。
1〜65,535(秒)を設定した場合
DABrokerがアクセス要求に対する応答をクライアントに返してから,次のアクセス要求を受けるまでの時間を監視します。
ここで設定した時間を超えてクライアントからのアクセス要求がない場合,DABrokerは次の処理をします。
クライアントに対しては,要求待ちタイムアウトの発生を通知して,コネクションを解放します。処理を続ける場合,クライアントは一度終了して再起動する必要があります。
データベースに対しては,このタイムアウトが発生したクライアントの処理がデータベースで実行中の場合は,トランザクションのロールバックを要求し,データベースを切り離します。
0を設定した場合
クライアントからの要求待ちタイムアウトを監視しません。
-
最大接続ユーザ数(DABMAXUSERS)
- 標準値
-
10(ユーザ)
- 指定範囲
-
1〜100,000(ユーザ)
- 説明
-
コネクションを確立できる最大ユーザ数を設定します。ここで設定した値を超えるユーザが接続しようとした場合,DABrokerは,クライアントにエラーメッセージを返してコネクションを確立しません。
EURから同時にデータベースをアクセスするユーザ数以上の値を指定してください。
-
同時実行可能なデータベースアクセス数(DABDBANUMBER)
- 標準値
-
20(データベース接続数)
- 指定範囲
-
1〜100,000(データベース接続数)
- 説明
-
DABrokerが一度に受け付けられる,複数のクライアントからのデータベースアクセス要求(同期アクセス処理要求)の合計数を設定します。ここで設定した値を超える要求があった場合は,クライアントにエラーメッセージを返し,処理を受け付けません。
EURで使用する場合は,最大接続ユーザ数以上の値を指定してください。
-
1プロセス当たりの実行ユーザ数(DABMAXBLOCKUSERS)
- 標準値
-
1(ユーザ数)
- 指定範囲
-
1〜100(ユーザ数)
- 説明
-
一つのプロセスで処理する最大ユーザ数を設定します。ここで設定した値を超えた場合は,クライアントにエラーメッセージを返し,処理を受け付けません。
EURで使用する場合は,1を指定してください。
-
最大処理プロセス数(DABMAXPROCESS)
- 標準値
-
10(プロセス数)
- 指定範囲
-
1〜1,000(プロセス数)
- 説明
-
DABrokerで起動する最大プロセス数を設定します。ここで設定した値を超えた場合は,クライアントにエラーメッセージを返し,処理を受け付けません。
(1プロセス当たりの実行ユーザ数×最大処理プロセス数)が最大接続ユーザ数以上となるように指定してください。
-
漢字コードセット(DABLANGMODE)
- 標準値
-
SJIS(シフトJISモード)
- 指定範囲
-
SJIS(シフトJISモード),UTF-8(UTF-8モード),またはASCII(ASCIIモード)
- 説明
-
DABrokerが稼働する言語モードを設定します。
各言語モードで操作できるデータベースを次の表に示します。
表2‒2 各言語モードで操作できるデータベース データベース
DABrokerでの設定
シフトJISモード
UTF-8モード
ASCIIモード
HiRDB
○
○
○
Oracle
○
○
○
SQL Server
○
○
○
各データベースで使用する言語モードは,必ずDABrokerの言語モードと合わせてください。データベースとDABrokerの言語モードが異なっている場合は動作を保証しません。
SQL ServerでUTF-16を使用する場合は,DABrokerの言語モードにUTF-8を指定してください。
DABrokerを日本語EUCモード,ASCIIモード,またはUTF-8モードで動作させた場合,メッセージは英文で出力されます。
DBPARTNER ODBC Driverを使用する場合,DABrokerの言語モードは,SJIS(シフトJISモード)を指定してください。
-
TCP/IP通信時キープアライブを監視する(DABKEEPALIVE)
- 標準値
-
OFF(キープアライブによる監視を行いません)
- 指定範囲
-
OFF(チェックなし),またはON(チェックあり)
(OFF:キープアライブによる監視を行いません ON:キープアライブによる監視を行います)
- 説明
-
キープアライブによる監視を行うかどうかを設定します。キープアライブとは,クライアントとの通信経路が確立されているかどうかを常に監視するTCP/IPの機能です。
ONを設定した場合
キープアライブによる監視が行われます(クライアントとの通信径路を監視する)。
OFFを設定した場合
キープアライブによる監視は行われません(クライアントとの通信径路を監視しない)。
-
IPアドレスからホスト名へ変換する(DABIPCONVERT)
- 標準値
-
ON(変換します)
- 指定範囲
-
OFF(チェックなし),またはON(チェックあり)
(OFF:変換しません ON:変換します)
- 説明
-
メッセージおよびユティリティで表示されるIPアドレスをホスト名に変換するかどうかを設定します。
ONを設定した場合
表示されるIPアドレスをホスト名に変換します。
動作環境によってこの変換処理に時間が掛かり,接続処理が遅くなることがあります。
OFFを設定した場合
表示されるIPアドレスをホスト名に変換しません。
-
通信トレースの取得をする(DABTCP_TRCSIZE)
- 標準値
-
OFF(取得しません)
- 指定範囲
-
OFF(チェックなし),またはON(チェックあり)
(OFF:取得しません ON:取得します)
- 説明
-
クライアントとの通信トレースを取得するかどうかを設定します。通信トレースの出力については,「付録A.1(2) DABrokerトレース出力ユティリティ」を参照してください。
「取得する」を設定した場合
次に示すファイル名ですべての通信トレースを取得するファイルがDABroker運用ディレクトリ\spool\dabcltrcの下に作成されます(通信トレースはDABrokerトレース出力ユティリティで出力します)。
XXXXXXXX.cmt
XXXXXXXX.cmt_AA〜AA
XXXXXXXX:任意の文字列
AA〜AA:任意の文字列
ハードディスクの空き容量がなくなった場合,それ以降の通信トレースは取得しません。なお,格納するファイルサイズは設定できません。
クライアントからの要求量が多い場合は,トレースのファイルの容量も多く必要です。ハードディスクの容量は余裕を持たせてください。必要容量の概算方法については,マニュアル「DABroker」を参照してください。また,クライアントからの要求量が多ければ,DABrokerを終了するまでに時間が掛かります。ご注意ください。
「取得しない」を設定した場合
クライアントとの通信トレースを取得しません。