Hitachi

Cosminexus V11 アプリケーションサーバ Cosminexus Reliable Messaging


3.4.8 DB Connector for Reliable Messagingのプロパティ定義

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

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

注意事項

DB Connector for Reliable Messagingでは,認証機能情報およびコネクションプーリング情報の設定は無効になります。このため,リソースアダプタの認証機能情報のユーザ名とパスワードの設定は,Reliable Messagingのプロパティ設定で実施してください。

〈この項の構成〉

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

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

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

<Application Serverのインストールディレクトリ>\CC\admin\templates

DB Connector for Reliable MessagingのConnector属性ファイルのテンプレートについては,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」のConnector属性ファイルのテンプレートファイルに関する内容を参照してください。

注意事項

テンプレートからコピーしたConnector属性ファイルにASCII文字以外を使用する場合は,次のどちらかの対処が必要です。

  • UTF-8形式で保存する。

  • 編集したファイルの文字エンコーディング形式に従って,ファイルの先頭行に次に示すencoding宣言を追加する。

    <?xml version="1.0" encoding="<文字エンコーディング>"?>

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

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

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

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

項目

必須

対応するタグ

トランザクションサポートのレベル

<transaction-support>

再認証のサポート有無

<reauthentication-support>

(凡例) ○:必須

プロパティの設定項目の説明については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」を参照してください。

(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 Reliable Messagingの種類によって一部異なります。DB Connector for Reliable Messagingの種類によって,設定できるコンフィグレーションプロパティの違いについては,「3.4.8(3) DB Connector for Reliable Messagingの種類によるコンフィグレーションプロパティの違い」を参照してください。

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

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

(c) 実行時プロパティ

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

項目

対応するタグ

プロパティ名

<property-name>

プロパティのデータ型

<property-type>

プロパティの値

<property-value>

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

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

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

  • ログを出力するかどうかの選択(LogEnabled)

注意事項

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

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

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

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

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

表3‒6 各DB Connector for Reliable Messaging共通のコンフィグレーションプロパティ

プロパティ名

設定値

linkedResourceAdapterName

Reliable Messagingの表示名

(b) DABroker対応のDB Connector for Reliable Messagingのコンフィグレーションプロパティ

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

表3‒7 DABroker対応のDB Connector for Reliable Messagingのコンフィグレーションプロパティ

項番

プロパティ名

設定値

1

description

接続先DBに必要な接続付加情報

2

DBHostName

接続先HiRDBのホスト名

3

XAOpenString

XA_OPEN文字列

4

databaseName

Reliable Messagingの接続先DB

5

bufSize

DB Connector for Reliable MessagingがDBから受信したデータを格納するためのバッファサイズ

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

(c) HiRDB Type4 JDBC Driver対応のDB Connector for Reliable Messagingのコンフィグレーションプロパティ

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

表3‒8 HiRDB Type4 JDBC Driver対応のDB Connector for Reliable Messagingのコンフィグレーションプロパティ

項番

プロパティ名

設定値

1

description

接続先DBに必要な接続付加情報

2

DBHostName

接続先HiRDBのホスト名

3

XAOpenString

XA_OPEN文字列

4

SQLWarningLevel

SQL実行時に発生した警告保持レベル

5

maxBinarySize

JDBC SQLタイプLONGVARBINARY型データ取得時のデータサイズの上限

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

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

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

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

項番

プロパティ名

設定値

1

databaseName

Oracleサーバ上の特定のデータベース名(SID)

2

serverName

Oracleサーバのホスト名またはIPアドレス

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

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

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

(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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

networkProtocol

lib

3

description

<HiRDBポート番号>

4

DBHostName

<HiRDBホスト名>

5

loginTimeout

0

6

serverName

7

portNumber

40179

8

databaseName

HIRDB

9

DBEnv

10

encodLang

11

JDBC_IF_TRC

false

12

SV_EVENT_TRC

false

13

TRC_NO

500

14

uapName

15

bufSize

64

16

rowSize

16

17

OSAuthorize

false

18

HiRDBCursorMode

false

19

blockUpdate

false

20

executeDirectMode

false

21

SQLWarningIgnore

false

22

LONGVARBINARY_Access

REAL

23

bufferPoolSize

0

24

PreparedStatementPoolSize

10

25

CallableStatementPoolSize

10

26

ConnectionIDUpdate

false

27

logLevel

ERROR

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

注※ 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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

networkProtocol

lib

3

description

<環境変数グループ識別子>※1

4

DBHostName

<HiRDBホスト名>

5

XAOpenString

Windowsの場合

<環境変数グループ識別子※2>+<環境変数グループ名※3

UNIXの場合

<環境変数グループ識別子※2>+<環境変数グループの設定ファイルのパス※3

6

loginTimeout

0

7

serverName

8

portNumber

40179

9

databaseName

HIRDB

10

DBEnv

11

encodLang

12

JDBC_IF_TRC

false

13

SV_EVENT_TRC

false

14

TRC_NO

500

15

uapName

16

bufSize

64

17

rowSize

16

18

OSAuthorize

false

19

HiRDBCursorMode

false

20

blockUpdate

false

21

executeDirectMode

false

22

SQLWarningIgnore

false

23

LONGVARBINARY_Access

REAL

24

bufferPoolSize

0

25

XACloseString

26

RMID

1※4

27

XAThreadMode

true

28

XALocalCommitMode

true

29

PreparedStatementPoolSize

10

30

CallableStatementPoolSize

10

31

ConnectionIDUpdate

false

32

logLevel

ERROR

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

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

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

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

注※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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

description

<HiRDBポート番号>

3

DBHostName

<HiRDBホスト名>

4

environmentVariables

<HiRDBクライアント環境変数名>

5

loginTimeout

8

6

encodeLang

7

JDBC_IF_TRC

false

8

TRC_NO

500

9

uapName

10

LONGVARBINARY_Access

REAL

11

SQLInNum

300

12

SQLOutNum

300

13

SQLWarningLevel

SQLWARN

14

SQLWarningIgnore

false

15

HiRDBCursorMode

false

16

maxBinarySize

64000

17

LONGVARBINARY_AccessSize

0

18

PreparedStatementPoolSize

10

19

CallableStatementPoolSize

10

20

CancelStatement

true

21

logLevel

ERROR

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

注※ 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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

description

<環境変数グループ識別子>

3

DBHostName

<HiRDBホスト名>

4

environmentVariables

<HiRDBクライアント環境変数名>

5

XAOpenString

Windowsの場合

<環境変数グループ識別子※1>+<環境変数グループ名※2

UNIXの場合

<環境変数グループ識別子※1>+<環境変数グループの設定ファイルのパス※2

6

loginTimeout

8

7

encodeLang

8

JDBC_IF_TRC

false

9

TRC_NO

500

10

uapName

11

LONGVARBINARY_Access

REAL

12

SQLInNum

300

13

SQLOutNum

300

14

SQLWarningLevel

SQLWARN

15

SQLWarningIgnore

false

16

HiRDBCursorMode

false

17

maxBinarySize

64000

18

LONGVARBINARY_AccessSize

0

19

XACloseString

20

XALocalCommitMode

true

21

PreparedStatementPoolSize

10

22

CallableStatementPoolSize

10

23

CancelStatement

true

24

logLevel

ERROR

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

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

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

(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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

databaseName

<Oracle SID>

3

serverName

<接続先Oracleのホスト名称,またはIPアドレス>

4

portNumber

1521

5

url

6

loginTimeout

8000

7

PreparedStatementPoolSize

10

8

CallableStatementPoolSize

10

9

ConnectionIDUpdate

false

10

logLevel

ERROR

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

(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の場合の設定例

1

linkedResourceAdapterName

<連携するReliable Messagingのリソースアダプタの表示名>

2

databaseName

<Oracle SID>

3

serverName

<接続先Oracleのホスト名称,またはIPアドレス>

4

portNumber

1521

5

url

6

loginTimeout

8000

7

sessionTimeout

300

8

PreparedStatementPoolSize

10

9

CallableStatementPoolSize

10

10

ConnectionIDUpdate

false

11

logLevel

ERROR

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