動作を行うための基本情報として設定(Config)ファイルを使用しています。
使用されるのは common.wdg , RunDBServer.wdg の2つのファイルになります。

RunDBServer.wdg からは common.wdg の設定を参照しています。
common.wdg では、接続先サーバの情報などの設定を行います。
common.wdg の設定方法は共通Configuration設定(common.wdg) を参照して下さい。

このドキュメントでは RunDBServer.wdg の設定についての説明になります。

1-1. JDBC の設定

<jdbc
	driver="${RunJdbcDriver}"
	url="${RunJdbcUrl}"
	isolation=""
	AutoCommit="false"
/>

この項目ではJDBCドライバのクラスの指定、およびJDBCへの接続URLを設定しています。この項目はデフォルトではcommon.wdgの内容を参照していますので、設定を変更する場合はcommon.wdgの値を変更して下さい。

driver="org.postgresql.Driver"
JDBCドライバのクラスを指定して下さい。
設定例)
- PostgreSQLの場合
  org.postgresql.Driver
- ORACLEの場合
  oracle.jdbc.OracleDriver
  または
  oracle.jdbc.OracleDriver
- DB2(TYPE2)の場合
  COM.ibm.db2.jdbc.app.DB2Driver
- DB2(TYPE3)の場合
  COM.ibm.db2.jdbc.net.DB2Driver
- AS/400 の場合
  com.ibm.as400.access.AS400JDBCDriver
url="jdbc:postgresql://localhost/dbname?encoding=EUC_JP"
接続先URLを設定して下さい。
設定例)
- PostgreSQL で hostnameというホストにあるdbnameというEUC_JPの文字コードで作成されたデータベースに接続
  jdbc:postgresql://hostname/dbname?encoding=EUC_JP
- Oracle で hostnameというホストにあるORCLというデータベースにポート1521で接続する場合
  jdbc:oracle:thin:@hostname:1521:ORCL
- DB2(TYPE2)で dbname というデータベースに接続する場合
  jdbc:db2:dbname
- DB2(TYPE3)で hostname というホストにある dbname というデータベースに接続する場合
  jdbc:db2://hostname/dbname
- AS/400 で AS000001 というホストに接続する場合
  jdbc:as400://AS000001

1-2. トランザクション遮断レベルの設定

<jdbc
	driver="${RunJdbcDriver}"
	url="${RunJdbcUrl}"
	isolation=""
	AutoCommit="false"
/>

データベース接続におけるトランザクション遮断レベルを設定します。
Java 2 Platform, Standard Edition では次の 4つの遮断レベルを指定することができます。

TRANSACTION_READ_COMMITTED	ダーティー読み取りは抑制されます。
TRANSACTION_READ_UNCOMMITTED	ダーティー読み取り、繰り返し不可の読み取り、およびファントム読み取りが起こります。
TRANSACTION_REPEATABLE_READ	ダーティー読み取りおよび繰り返し不可の読み取りが抑制されます。
TRANSACTION_SERIALIZABLE	ダーティー読み取り、繰り返し不可の読み取り、およびファントム読み取りが抑制されます。

isolation="TRANSACTION_READ_COMMITTED"

遮断レベルを指定します。この例では TRANSACTION_READ_COMMITTED を指定しています。
Example...
```
<jdbc
	driver="${RunJdbcDriver}"
	url="${RunJdbcUrl}"
	isolation="TRANSACTION_READ_COMMITTED"
	AutoCommit="false"
/>
```
isolation=""

遮断レベルとして何も指定しなかった場合(空文字列を指定した場合)は、接続先データベースのデフォルトの設定が使われます。
Example...
```
<jdbc
	driver="${RunJdbcDriver}"
	url="${RunJdbcUrl}"
	isolation=""
	AutoCommit="false"
/>
```
まったく何も指定しなかった場合。

まったく何も指定しなかった場合は、以前のバージョンと互換性を保つため、TRANSACTION_READ_COMMITTED が適用されます。
Example...
```
<jdbc
	driver="${RunJdbcDriver}"
	url="${RunJdbcUrl}"
	AutoCommit="false"
/>
```

1-3. AutoCommitの設定

1-4. ユーザ名、パスワードの設定

<connect user="${RunJdbcUser}" password="${RunJdbcPass}" />
<connect user="${RunJdbcUser}" password="${RunJdbcPass}" />
<connect user="${RunJdbcUser}" password="${RunJdbcPass}" />

データベースに接続するときに使用するユーザ名とパスワードを指定します。この項目はデフォルトではcommon.wdgの内容を参照していますので、設定を変更する場合はcommon.wdgの値を変更して下さい。
また、ここでユーザ、パスワード指定を複数行記述すると、その行数分だけデータベースのコネクションプールを確保することとなり、同時に複数のデータベースアクセスを行うプロジェクトでの処理向上に役立ちます。
(上記の例では3つのデータベースコネクションがコネクションプールに確保されます)

user="${RunJdbcUser}"
データベース接続に使用するユーザ名を入力して下さい。
password="${RunJdbcPass}"
パスワードを入力して下さい。

2. チェック

2-1. Connection Pool の使用状況チェック

<connection>
	<check type="unuse" interval="30000" timeout="900000" />
</connection>

DBServer実行時、ネットワークになんらかの障害が発生すると、データベースのコネクションが解放されないまま残るという現象が発生することがあります。
DBServerではこの現象を解消するために、コネクションプールの使用状況のチェックを一定時間ごとに行います。
一定時間以上データベースアクセスが行われないまま使用中になっているコネクションがある場合は、そのコネクションを解放し、未使用状態のコネクションプールへと戻します。

type
Connection Pool の使用状況チェックを設定するには、type に unuse を指定してください。
interval="30000"

コネクションプールのチェックを行う間隔をミリ秒で指定して下さい。
この時間を短くすると、使用されないまま放置されているコネクションを早く発見できますが、あまり短くするとチェックのためのオーバーヘッドがかかります。
timeout="900000"

接続を解除するtimeout値をミリ秒で指定して下さい。
この時間を短くすると使用されないまま放置されているコネクションを早期に発見できますが、あまり短くすると処理の途中で解放されてしまうことがあります。 Timeoutに指定する時間は、あるDCを実行後、次のDCを実行するまでにかかる時間、 (ロジッククラスの処理時間等)の最大値よりも大きい値を指定します。

上記の例では30秒ごとに15分以上放置されたコネクションが存在しないかどうかをチェックし、存在した場合、そのコネクションを解放してコネクションプールに戻します。

2-2. JDBC 接続のチェック

<connection>
	<check type="alive" class="jp.ne.mki.wedge.pub.server.db.check.connect.SqlSelectExec"
		interval="600"
		sql="select sysdate from dual" />
</connection>

定期的に JDBC 接続が切断されていないかどうかをチェックし、切断されている場合は、再接続を行います。
例えば、RDBMS が再起動することにより、JDBC 接続が切断された場合は、この設定により自動的に接続し直すことが可能となります。

type
JDBC 接続チェックを設定するには、type に alive を指定してください。
class
JDBC 接続チェックを行うクラスを指定します。
jp.ne.mki.wedge.pub.server.db.check.connect.SqlSelectExec クラスは標準で提供される JDBC 接続チェッククラスで、後述の sql 属性に指定された SQL を発行し、SQL が正常終了したかどうかで接続が有効かどうかを判断します。
このクラスは jp.ne.mki.wedge.pub.server.db.check.connect.JdbcConnectionCheck インターフェースを実装していますので、このインターフェースを実装した別のクラスを指定することにより、JDBC 接続方法チェックを別の方法で行うように変更することも可能です。
interval
前述の JDBC 接続チェッククラスを実行する間隔を秒単位で指定します。
0 を指定した場合は、SAMC のトランザクション開始時に JDBC 接続チェッククラスを実行します。
sql
JDBC 接続チェッククラスに渡す SQL 文を指定します。
この SQL にはプレースホルダー(?) を含めることはできません。
標準で提供される JDBC 接続チェッククラス(jp.ne.mki.wedge.pub.server.db.check.connect.SqlSelectExec)は、ここで指定された SQL を使ってチェックを行うようになっていますが、別クラスを使ってチェックを行う場合、この SQL を使うかどうかは、そのクラスの実装に依存します。

2-3. コネクション要求のタイムアウト

<connection>
    <require timeout="180000" />
</connection>

トランザクション開始時にコネクションプールからJDBCコネクションを取得する時の、最大待ち時間を設定します。
単位はミリ秒で指定します。
1以上の値が指定された場合は、コネクション取得要求を開始してからその時間が経過するまで待機します。指定された時間が経過する前にコネクションが取得できた場合は、処理を継続します。
指定された時間が経過してもコネクションが取得できなかった場合は、処理を中断してエラーを返します。
0以下の値を指定した場合、または指定しなかった場合は、コネクションが取得できるまで待機します。(従来と同じ動きになります。)
上記の例ではコネクション取得要求を開始してから最大 3分間、コネクションが取得できるまで待機します。

Point
この設定は複数DB接続環境で common.wdg の「beforehand」の指定と組み合わせて使います。
common.wdg に「beforehand="false"」と指定すると、マッパークラスから SQL を発行するタイミングで、対象となる DB に対するコネクションをまだ取得していない場合に、コネクションプールに対してJDBCコネクション取得要求を行います。
するとトランザクションごとに DBに接続する順序が異なりますので、同時実行するトランザクション数が多くなり、コネクションプールに用意された JBCコネクションを使い切った場合は、デッドロックが発生する可能性があります。
コネクション要求の最大待機時間を指定することで、デッドロックが発生しても永遠に待ち続けることなく、エラーで終わらせることができるようになります。
最大待ち時間になってもコネクションが取得できなかった場合は、そのトランザクションが保持していたコネクションは、コネクションプールに戻されます。
「beforehand="true"」と指定すると、トランザクション開始時にすべての接続先DB に対する JDBC コネクションの取得要求を行います。通常はこちらの方を指定してください。

common.wdg での beforehand の定義は次のように行います。

<server name="${DefaultDBServer}"
        protocol="${rmi}"
        url="${RmiUrl}${RunDBServerRmiRegistName}"
        exchanger="${CommonExchanger}" beforehand="true" />

ApServerからDBServerに接続する時の定義に「beforehand="true"」と指定すると、トランザクション開始時にすべての接続先DB に対するコネクション取得要求を行います。
「beforehand="true"」と指定すると、マッパークラス実行時に、まだそのDBに対するコネクションを取得していない場合は、そのDBに対するコネクションの取得要求を行います。
トランザクションの中で、すでにそのDBに対してマッパークラスを実行しているため、コネクションも取得している場合は、マッパークラス実行時にコネクション取得要求は行わず、すでに取得済みのコネクションを使って SQL を発行します。
「beforehand」を指定しなかった場合は、「beforehand="true"」を指定した場合と同じ動きになります。

3. DB変換クラス使用時のパッケージ

<data>
	<convert package="jp.ne.mki.wedge.data.db.defaults" />
</data>

DB変換クラスを使用時に、クラス名の頭に付け加えるパッケージ名を記述します。例えばOMCにてDB変換クラスがVarcharと登録されていて、このパッケージ部分に jp.ne.mki.wedge.data.db.defaultsと記述されている場合、実際に使用されるクラスは jp.ne.mki.wedge.data.db.defaults.Varcharとなります。
独自に作成されたDB変換クラスをご利用になられる場合は、そのクラス名(パッケージ名を含まない)を OMCの「基本クラス」タブのデータベース用フォーマットクラスに登録し、「データクラス」タブの「DB変換クラス」に登録した基本クラスを指定します。

package="jp.ne.mki.wedge.data.db.defaults"

OMCの基本クラスタブのデータベース用フォーマットクラスに登録したクラスを検索するパッケージを指定します。
```
< convert package="xxx"/>
```
が複数行指定された場合は、記述されたパッケージの順番に DB変換クラスが検索されます。
Example...
```
<data>
	<convert package="jp.ne.mki.wedge.data.db.mycv1" />
	<convert package="jp.ne.mki.wedge.data.db.defaults" />
	<convert package="jp.ne.mki.wedge.data.db.mycv2" />
</data>
```
この状態で、DB変換クラス「Varchar」を選択した場合は、
1. jp.ne.mki.wedge.data.db.mycv1.Varchar
2. jp.ne.mki.wedge.data.db.defaults.Varchar
3. jp.ne.mki.wedge.data.db.mycv2.Varchar
の優先順位でクラスを検索し、見つかったクラスを使用します。

DB変換クラスの作成方法についてはこちらを参考にして下さい。

4. SQLマッパー基本クラスのマッピングテーブル設定

<dc>
	<mapping name="jp.ne.mki.wedge.run.db.control.dc.Start" alias="my.MyStart" />
</dc>

本来使用されるSQLマッパー基本クラスを別のSQLマッパー基本クラスに置き換えるマッピングテーブルを設定します。例えば、例の場合では処理開始用のSQLマッパー基本クラスに"my.MyStart"クラスが使用されることとなります。
このマッピングテーブルを用いることで、リポジトリ定義では設定できない開始・終了・異常時終了用の SQLマッパー基本クラスを独自で作成したクラスに置き換えることが可能となります。

5. ネットワークの設定

5-1. RMIの登録Registry名称

<network>
	<regist protocol="${rmi}" url="${RmiUrl}${RunDBServerRmiRegistName}" />
<!-- RMI data connection port
	<rmi port="49201" />
-->
</network>

regist

起動されたDBServerをどのようなRegistry名称でRMIへ登録するかを設定します。この項目は標準でcommon.wdgの内容を参照していますので、そちらの値を変更して下さい。
ApServerのコンフィグレーションには自分自身が参照すべきDBServerのRmiUrlを記述しています。 ApServerからDBServerへとアクセスをするためには、
- DBServerコンフィグレーションのnetwork/regist/url
- ApServerコンフィグレーションのnetwork/dbserver/url
の二つの値が一致している必要があります。
port

DBServerが待機する RMI のポート番号を設定します。
ネットワーク上にファイアウォールやロードバランサが存在する場合等、ポート番号を固定する必要がある場合に設定します。
この指定を省略した場合は、起動時に Java VM が空いているポートを割り当てます。

6. ログの出力先パス

7. ログHandlerの設定

<setting>
  <debug>
    <log>
    	<handlers>
    		<common>
    			<handler class="jp.ne.mki.wedge.option.log.handler.WedgeFileHandler">
    				<formatter class="jp.ne.mki.wedge.run.logger.formatter.RunEngineFormatter" />
    				<limit value="1048576" />
    				<count value="10" />
    				<append value="true" />
    				<pattern value="${LogPath}RunDBServer.%g.log" />
    				<level value="CONFIG" />
    			</handler>
    			<handler class="jp.ne.mki.wedge.run.logger.handler.TraceLogHandler">
    				<formatter class="jp.ne.mki.wedge.run.db.logger.formatter.RunDBServerTraceLogFormatter" />
    				<filter class="jp.ne.mki.wedge.run.logger.filter.TraceLogFilter" />
    				<limit value="10485760" />
    				<count value="30" />
    				<append value="true" />
    				<pattern value="${LogPath}/RunDBServer/trace_#g/#s_#t.log" />
    				<level value="FINEST" />
    			</handler>
    		</common>
    	</handlers>
    </log>
  </debug>
</setting>

ログ出力のHandlerを設定します。
デフォルトの設定では、WedgeFileHandlerは、エラー・警告・情報ログを出力し、TraceLogHandlerは、トレースログを出力しています。
詳しい設定内容はログ使用方法を参照して下さい。

AutoCommit="false"	自動コミットモードを無効にします。
AutoCommit="true"	自動コミットモードを有効にします。
AutoCommit=""	Connection#setAutoCommit(boolean)を呼び出しません。
AutoCommitの記述がされていない時	AutoCommit="false"と認識されます。

DBServer設定

1. 接続先データベースの設定