3.4.8 DB Connector for Cosminexus RMのプロパティ定義

Cosminexus RMがデータベースと接続するには,DB Connector for Cosminexus RMのプロパティを定義する必要があります。「3.4.6 DB Connector for Cosminexus RMの選択」で選択したDB Connector for Cosminexus RMのプロパティを定義します。

DB Connector for Cosminexus RMのプロパティの定義は,DB Connector for Cosminexus RMをデプロイしたあとでも実行できます。なお,設定済みのDB Connector for Cosminexus RMのプロパティを変更する場合は,該当するDB Connector for Cosminexus RMを停止した状態で実行してください。

注意事項
DB Connector for Cosminexus RMでは,認証機能情報およびコネクションプーリング情報の設定は無効になります。このため,リソースアダプタの認証機能情報のユーザ名とパスワードの設定は,Cosminexus RMのプロパティ設定で実施してください。
<この項の構成>
(1) 編集する属性ファイル
(2) 編集する属性設定項目
(3) DB Connector for Cosminexus RMの種類によるコンフィグレーションプロパティの違い
(4) コンフィグレーションプロパティの設定例

(1) 編集する属性ファイル

Cosminexusで提供するDB Connector for Cosminexus RMのConnector属性ファイルのテンプレートを任意のディレクトリにコピーして,コピーしたファイルを編集します。

DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートは,次のディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CC¥admin¥templates

DB Connector for Cosminexus RMのConnector属性ファイルのテンプレートについては,マニュアル「Cosminexus リファレンス 定義編」のConnector属性ファイルのテンプレートファイルに関する内容を参照してください。

注意
テンプレートからコピーしたConnector属性ファイルにASCII文字以外を使用する場合は,次のどちらかの対処が必要です。
  • UTF-8形式で保存する。
  • 編集したファイルの文字エンコーディング形式に従って,ファイルの先頭行に次に示すencoding宣言を追加する。
    <?xml version="1.0" encoding="<文字エンコーディング>"?>

(2) 編集する属性設定項目

DB Connector for Cosminexus RMのプロパティ設定項目を次に示します。

(a) リソースアダプタの一般情報

設定できるDB Connector for Cosminexus RMの一般情報属性(<outbound-resourceadapter>タグ)の設定項目を次に示します。

項目必須対応するタグ
トランザクションサポートのレベル<transaction-support>
再認証のサポート有無<reauthentication-support>

(凡例) ○:必須


プロパティの設定項目の説明については,マニュアル「Cosminexus リファレンス 定義編」を参照してください。

(b) コンフィグレーションプロパティ

リソースアダプタのコンフィグレーションプロパティ(<outbound-resourceadapter> - <connection-definition> - <config-property>タグ)の設定項目を次に示します。

項目対応するタグ
コンフィグレーションプロパティ名<config-property-name>
コンフィグレーションプロパティのデータ型<config-property-type>
コンフィグレーションプロパティの値<config-property-value>
注※ コンフィグレーションプロパティの値をクリアする場合
<config-property-value>タグだけを指定して,値を指定しないでください。
<config-property-value>タグ自体が指定されていない場合は,そのプロパティの値は変更されないで,すでに設定されている値がそのまま有効になります。

定義するコンフィグレーションプロパティの数だけ上記の設定を繰り返してください。

設定する必要がある項目は,DB Connector for Cosminexus RMの種類によって一部異なります。DB Connector for Cosminexus RMの種類によって,設定できるコンフィグレーションプロパティの違いについては,「(3) DB Connector for Cosminexus RMの種類によるコンフィグレーションプロパティの違い」を参照してください。

なお,PreparedStatementPoolSize,CallableStatementPoolSize,LogLevel,およびCancelStatement以外のプロパティは,すべてCosminexus DABroker Library,HiRDB Type4 JDBC Driver,またはOracle JDBC Thin Driverに設定する項目です。Cosminexus DABroker Libraryの場合はCosminexus DABroker Libraryの環境設定ユティリティ(Windowsの場合),またはCosminexus DABroker Library動作環境定義ファイル(UNIXの場合)で設定します。詳細は,マニュアル「Cosminexus リファレンス 定義編」を参照してください。

DB Connector for Cosminexus RMのコンフィグレーションプロパティの設定内容については,「6.3 DB Connector for Cosminexus RMのコンフィグレーションプロパティの一覧」を参照してください。

(c) 実行時プロパティ

DB Connector for Cosminexus RMの実行時プロパティ(<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <property>タグ)の設定項目を次に示します。

項目対応するタグ
プロパティ名<property-name>
プロパティのデータ型<property-type>
プロパティの値<property-value>

定義するプロパティの数だけ,上記の設定を繰り返してください。

実行時プロパティ名(<property-name>)およびコネクションプールの動作と注意事項については,マニュアル「Cosminexus アプリケーション設定操作ガイド」のDB Connectorのプロパティ定義に関する内容を参照してください。

なお,DB Connector for Cosminexus RMの場合は,次の実行時プロパティの設定だけが有効となります。

 

注意
ユーザ名およびコネクションプールに関する設定値は,Cosminexus RMとDB Connector for Cosminexus RMで同じ値を設定してください。

(3) DB Connector for Cosminexus RMの種類によるコンフィグレーションプロパティの違い

DB Connector for Cosminexus RMの種類によって,設定するコンフィグレーションプロパティが異なります。DB Connector for Cosminexus RMの種類を次に示します。

(a) 各DB Connector for Cosminexus RM共通のコンフィグレーションプロパティ

DABroker対応のDB Connector for Cosminexus RM,HiRDB Type4 JDBCドライバ対応のDB Connector for Cosminexus RM,Oracle JDBC Thinドライバ対応のDB Connector for Cosminexus RM共通で設定が必要なコンフィグレーションプロパティを次の表に示します。

表3-6 各DB Connector for Cosminexus RM共通のコンフィグレーションプロパティ

プロパティ名設定値
linkedResourceAdapterNameCosminexus RMの表示名
(b) DABroker対応のDB Connector for Cosminexus RMのコンフィグレーションプロパティ

DABroker対応のDB Connector for Cosminexus RMを使用する場合,Cosminexus RMとして設定が必要なDB Connector for Cosminexus RMのコンフィグレーションプロパティを次の表に示します。

表3-7 DABroker対応のDB Connector for Cosminexus RMのコンフィグレーションプロパティ

項番プロパティ名設定値
1description接続先DBに必要な接続付加情報
2DBHostName接続先HiRDBのホスト名
3XAOpenStringXA_OPEN文字列
4databaseNameCosminexus RMの接続先DB
5bufSizeDB Connector for Cosminexus RMがDBから受信したデータを格納するためのバッファサイズ

注※ XATransactionで使用する場合だけ設定が必要です。


(c) HiRDB Type4 JDBCドライバ対応のDB Connector for Cosminexus RMコンフィグレーションプロパティ

HiRDB Type4 JDBCドライバ対応のDB Connector for Cosminexus RMを使用する場合,Cosminexus RMとして設定が必要なDB Connector for Cosminexus RMのコンフィグレーションプロパティを次の表に示します。

表3-8 HiRDB Type4 JDBCドライバ対応のDB Connector for Cosminexus RMのコンフィグレーションプロパティ

項番プロパティ名設定値
1description接続先DBに必要な接続付加情報
2DBHostName接続先HiRDBのホスト名
3XAOpenStringXA_OPEN文字列
4SQLWarningLevelSQL実行時に発生した警告保持レベル
5maxBinarySizeJDBC SQLタイプLONGVARBINARY型データ取得時のデータサイズの上限

注※ XATransactionで使用する場合だけ設定が必要です。


(d) Oracle JDBC Thinドライバ対応のDB Connector for Cosminexus RMのコンフィグレーションプロパティ

Oracle JDBC Thinドライバ対応のDB Connector for Cosminexus RMを使用する場合,Cosminexus RMとして設定が必要なDB Connector for Cosminexus RMのコンフィグレーションプロパティを次の表に示します。

表3-9 Oracle JDBC Thinドライバ対応のDB Connector for Cosminexus RMのコンフィグレーションプロパティ

項番プロパティ名設定値
1databaseNameOracleサーバ上の特定のデータベース名(SID)
2serverNameOracleサーバのホスト名またはIPアドレス

(4) コンフィグレーションプロパティの設定例

次に示す場合のDB Connector for Cosminexus RMのコンフィグレーションプロパティの設定例を示します。

コンフィグレーションプロパティの各項目の詳細については,「6.3 DB Connector for Cosminexus RMのコンフィグレーションプロパティの一覧」を参照してください。

(a) DBConnector_DABJ_CP_Cosminexus_RM.rarで,HiRDBを使用する場合

DBConnector_DABJ_CP_Cosminexus_RM.rarで,HiRDBを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-10 データベースとしてHiRDBを使用する場合(DBConnector_DABJ_CP_Cosminexus_RM.rarの場合)

項番プロパティ名HiRDBの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2networkProtocollib
3description<HiRDBポート番号>
4DBHostName<HiRDBホスト名>
5loginTimeout0
6serverName
7portNumber40179
8databaseNameHIRDB
9DBEnv
10encodLang
11JDBC_IF_TRCfalse
12SV_EVENT_TRCfalse
13TRC_NO500
14uapName
15bufSize64
16rowSize16
17OSAuthorizefalse
18HiRDBCursorModefalse
19blockUpdatefalse
20executeDirectModefalse
21SQLWarningIgnorefalse
22LONGVARBINARY_AccessREAL
23bufferPoolSize0
24PreparedStatementPoolSize10
25CallableStatementPoolSize10
26ConnectionIDUpdatefalse
27logLevelERROR

(凡例) -:設定は不要です。

注※ HiRDBクライアントの環境変数グループ名(Windowsの場合)または環境変数グループの設定ファイルのパス(UNIXの場合)を指定することもできます。


(b) DBConnector_DABJ_XA_Cosminexus_RM.rarで,HiRDBを使用する場合

DBConnector_DABJ_XA_Cosminexus_RM.rarで,HiRDBを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-11 データベースとしてHiRDBを使用する場合(DBConnector_DABJ_XA_Cosminexus_RM.rarの場合)

項番プロパティ名HiRDBの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2networkProtocollib
3description<環境変数グループ識別子>※1
4DBHostName<HiRDBホスト名>
5XAOpenString
Windowsの場合
<環境変数グループ識別子※2>+<環境変数グループ名※3
UNIXの場合
<環境変数グループ識別子※2>+<環境変数グループの設定ファイルのパス※3
6loginTimeout0
7serverName
8portNumber40179
9databaseNameHIRDB
10DBEnv
11encodLang
12JDBC_IF_TRCfalse
13SV_EVENT_TRCfalse
14TRC_NO500
15uapName
16bufSize64
17rowSize16
18OSAuthorizefalse
19HiRDBCursorModefalse
20blockUpdatefalse
21executeDirectModefalse
22SQLWarningIgnorefalse
23LONGVARBINARY_AccessREAL
24bufferPoolSize0
25XACloseString
26RMID1※4
27XAThreadModetrue
28XALocalCommitModetrue
29PreparedStatementPoolSize10
30CallableStatementPoolSize10
31ConnectionIDUpdatefalse
32logLevelERROR

(凡例) -:設定は不要です。

注※1 J2EEサーバ内でユニークな4バイトの文字列を指定します。

注※2 [Description]フィールドに入力した値を指定します。

注※3 HiRDBの環境変数グループ名(Windowsの場合)または環境変数グループの設定ファイルのパス(UNIXの場合)を指定します。詳細については,マニュアル「Cosminexus システム構築ガイド」を参照してください。

注※4 リソースマネジャの識別子を指定します。J2EEサーバ内でユニークな1~2147483647の数値で指定します。


(c) DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarで,HiRDBを使用する場合

DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarで,HiRDBを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-12 データベースとしてHiRDBを使用する場合(DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rarの場合)

項番プロパティ名HiRDBの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2description<HiRDBポート番号>
3DBHostName<HiRDBホスト名>
4environmentVariables<HiRDBクライアント環境変数名>
5loginTimeout8
6encodeLang
7JDBC_IF_TRCfalse
8TRC_NO500
9uapName
10LONGVARBINARY_AccessREAL
11SQLInNum300
12SQLOutNum300
13SQLWarningLevelSQLWARN
14SQLWarningIgnorefalse
15HiRDBCursorModefalse
16maxBinarySize64000
17LONGVARBINARY_AccessSize0
18PreparedStatementPoolSize10
19CallableStatementPoolSize10
20CancelStatementtrue
21logLevelERROR

(凡例) -:設定は不要です。

注※ HiRDBクライアントの環境変数グループ名(Windowsの場合)または環境変数グループの設定ファイルのパス(UNIXの場合)も指定できます。


(d) DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarで,HiRDBを使用する場合

DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarで,HiRDBを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-13 データベースとしてHiRDBを使用する場合(DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rarの場合)

項番プロパティ名HiRDBの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2description<環境変数グループ識別子>
3DBHostName<HiRDBホスト名>
4environmentVariables<HiRDBクライアント環境変数名>
5XAOpenString
Windowsの場合
<環境変数グループ識別子※1>+<環境変数グループ名※2
UNIXの場合
<環境変数グループ識別子※1>+<環境変数グループの設定ファイルのパス※2
6loginTimeout8
7encodeLang
8JDBC_IF_TRCfalse
9TRC_NO500
10uapName
11LONGVARBINARY_AccessREAL
12SQLInNum300
13SQLOutNum300
14SQLWarningLevelSQLWARN
15SQLWarningIgnorefalse
16HiRDBCursorModefalse
17maxBinarySize64000
18LONGVARBINARY_AccessSize0
19XACloseString
20XALocalCommitModetrue
21PreparedStatementPoolSize10
22CallableStatementPoolSize10
23CancelStatementtrue
24logLevelERROR

(凡例) -:設定は不要です。

注※1 [Description]フィールドに入力した値を指定します。

注※2 HiRDBの環境変数グループ名(Windowsの場合)または環境変数グループの設定ファイルのパス(UNIXの場合)を指定します。詳細については,マニュアル「Cosminexus システム構築ガイド」を参照してください。


(e) DBConnector_Oracle_CP_Cosminexus_RM.rarで,Oracleを使用する場合

DBConnector_Oracle_CP_Cosminexus_RM.rarで,Oracleを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-14 データベースとしてOracleを使用する場合(DBConnector_Oracle_CP_Cosminexus_RM.rarの場合)

項番プロパティ名Oracleの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2databaseName<Oracle SID>
3serverName<接続先Oracleのホスト名称,またはIPアドレス>
4portNumber1521
5url
6loginTimeout8000
7PreparedStatementPoolSize10
8CallableStatementPoolSize10
9ConnectionIDUpdatefalse
10logLevelERROR

(凡例) -:設定は不要です。


(f) DBConnector_Oracle_XA_Cosminexus_RM.rarで,Oracleを使用する場合

DBConnector_Oracle_XA_Cosminexus_RM.rarで,Oracleを使用する場合のコンフィグレーションプロパティの設定例を次の表に示します。

表3-15 データベースとしてOracleを使用する場合(DBConnector_Oracle_XA_Cosminexus_RM.rarの場合)

項番プロパティ名Oracleの場合の設定例
1linkedResourceAdapterName<連携するCosminexus RMのリソースアダプタの表示名>
2databaseName<Oracle SID>
3serverName<接続先Oracleのホスト名称,またはIPアドレス>
4portNumber1521
5url
6loginTimeout8000
7sessionTimeout300
8PreparedStatementPoolSize10
9CallableStatementPoolSize10
10ConnectionIDUpdatefalse
11logLevelERROR

(凡例) -:設定は不要です。