4.14.6 Symfoware ServerのNativeインターフェイス JDBCドライバ(Type2)

Symfoware ServerのNativeインターフェイスを利用する場合、Connection Managerの利用を推奨します。
Connection Managerの設定については、Symfoware Serverのマニュアルを参照してください。

環境変数の設定

以下の環境設定を行ってください。

クラスパスの設定および、パス/ライブラリーパスの設定については「4.14.1 JDBCドライバの環境設定」を参照してください。

設定項目	設定値
パス	NativeインターフェイスのSymfoware Server クライアント機能インストール先ディレクトリー\JDBC\fjjdbc\bin Windowsシステムディレクトリー\ESQL\BIN
クラスパス	NativeインターフェイスのSymfoware Server クライアント機能インストール先ディレクトリー\JDBC\fjjdbc\lib\fjsymjdbc4.jar

設定項目	設定値
ライブラリーパス	FSUNrdb2bインストール先ディレクトリー/FSUNrdb2b/lib (注) JDBCドライバインストール先ディレクトリー/FJSVsymjd/fjjdbc/bin (注)
クラスパス	JDBCドライバインストール先ディレクトリー/FJSVsymjd/fjjdbc/lib/fjsymjdbc4.jar (注)

設定項目	設定値
ライブラリーパス	FJSVrdb2bインストール先ディレクトリー/FJSVrdb2b/lib (注) JDBCドライバインストール先ディレクトリー/FJSVsymjd/fjjdbc/bin (注)
クラスパス	JDBCドライバインストール先ディレクトリー/FJSVsymjd/fjjdbc/lib/fjsymjdbc4.jar (注)

注) 以下のディレクトリーのデフォルトは、/optです。

FSUNrdb2bインストール先ディレクトリー
FJSVrdb2bインストール先ディレクトリー
JDBCドライバインストール先ディレクトリー

接続プールの設定

接続プールの設定に以下を指定してください。
リソースタイプにはデータソースクラスが実装するインターフェイスを指定してください。

パラメタ	指定値
名前	任意の値
リソースタイプ	以下を指定してください。 javax.sql.ConnectionPoolDataSource (注)
データソースクラス名	以下を指定してください。 com.fujitsu.symfoware.jdbc2.SYMConnectionPoolDataSource

パラメタ

指定値

名前

任意の値

リソースタイプ

以下を指定してください。

javax.sql.ConnectionPoolDataSource (注)

データソースクラス名

以下を指定してください。

com.fujitsu.symfoware.jdbc2.SYMConnectionPoolDataSource

注) Symfoware ServerのNativeインターフェイスのJDBCドライバ側のプーリング機能は、GlassFish側のプーリング機能ですべて実現できます。そのため、Symfoware ServerのNativeインターフェイスのJDBCドライバ側のプーリング機能をサポートしません。Symfoware ServerのNativeインターフェイスを利用する場合、GlassFish側のプーリング機能を利用してください。

プロパティ

以下に指定できるプロパティを説明します。説明されているプロパティ以外は編集する必要はありません。指定するプロパティの詳細は、JDBCドライバのマニュアルを参照してください。

Connection Managerを利用する場合

プロパティ名	値
user	ユーザーIDを指定してください。
password	パスワードを指定してください。
networkProtocol	接続するネットワークプロトコル名を指定します。以下を指定してください。指定は必須です。 symfold
databaseName	Connection ManagerのAPC動作環境ファイルのSQLSERVERパラメタで指定したSQLサーバー名を指定してください。指定は必須です。
description	このデータソースの説明を指定します。
SYMOption	JDBCドライバのオプションを指定します。以下のオプションが指定可能です。 lang schema ctuneparam javaconverter default_isolation default_readonly autoclosestatement statementcache 各オプションの設定値については、JDBCドライバのマニュアルを参照してください。 [SYMOptionの記述例] statementcache=36;ctuneparam='CLI_MAX_SQL=(255);CLI_WAIT_TIME=(30)' [記述上の注意] 各オプションの設定値に空文字列は指定できません。例) ctuneparam='CLI_MAX_SQL='

Connection Managerを利用しない場合

プロパティ名	値
user	ユーザーIDを指定してください。
password	パスワードを指定してください。
networkProtocol	接続するネットワークプロトコル名を指定します。以下のどちらかを指定してください。指定は必須です。 symfold(ローカル) symford(RDB2_TCP連携)
serverName	接続するサーバーのホスト名またはIPアドレスを指定します。本オプションは、プロトコルでリモートアクセス(RDB2_TCP連携)を設定した場合に指定可能です。例1)IPv4の場合 127.0.0.1 例2)IPv6の場合 ::1
portNumber	接続するサーバーのポート番号を指定します。本オプションは、リモートアクセス(RDB2_TCP連携)を設定した場合に指定可能です。有効値は、1～65535の整数値です。
databaseName	接続するデータ運用資産名を指定してください。指定は必須です。 protocolにsymfold(ローカル)を指定した場合、以下のようにRDBシステム名を付加する必要があります。RDBシステム名を付けない運用の場合は必要ありません。 <RDBシステム名>.<データ運用資産名>
description	このデータソースの説明を指定します。
SYMOption	JDBCドライバのオプションを指定します。以下のオプションが指定可能です。 lang schema ctuneparam javaconverter default_isolation default_readonly autoclosestatement statementcache 各オプションの設定値については、JDBCドライバのマニュアルを参照してください。 [SYMOptionの記述例] statementcache=36;ctuneparam='CLI_MAX_SQL=(255);CLI_WAIT_TIME=(30)' [記述上の注意] 各オプションの設定値に空文字列は指定できません。例) ctuneparam='CLI_MAX_SQL='

注意

Symfoware ServerのNativeインターフェイスを使用する場合、urlプロパティは指定しないでください。urlプロパティを指定すると、データベース接続時の認証に失敗する場合があります。

RDB2_TCPでSymfoware ServerのNativeインターフェイスに接続するための設定

注意

GlassFishと別のサーバーシステム上にあるSymfoware ServerのNativeインターフェイスにアクセスするために使用する接続形態を「RDB2_TCP」と呼びます。
RDB2_TCPでSymfoware ServerのNativeインターフェイスに接続するためには、以下の作業が必要です。
以下の作業は、GlassFishと同一のサーバーシステム上にあるSymfoware ServerのNativeインターフェイスにアクセスする場合は不要です。

RDB2_TCP接続用のパラメタの設定
RDB2_TCPのポート番号の設定

RDB2_TCP接続用のパラメタの設定

Symfoware ServerのNativeインターフェイスのシステム用動作環境ファイル内に、以下のRDB2_TCP接続用のパラメタを追加してください。

MAX_CONNECT_TCP = (n)
n : 最大接続数(省略値は0)

参考

システム用動作環境ファイルは、Symfoware ServerのNativeインターフェイスインストール時に指定した場所に格納されています。格納場所を指定しないでインストールした場合は、以下の場所に格納されています。

[Symfoware ServerのNativeインターフェイスがインストールされているドライブ]:\SFWETC\RDB\ETC\UXPSQLENV

/opt/FSUNrdb2b/etc/fssqlenv

/opt/FJSVrdb2b/etc/fssqlenv

注意

システム用動作環境ファイル内にMAX_CONNECT_TCPを設定していない、または最大接続数に0が指定されている場合、Jakarta EEコンポーネント実行時に、Symfoware ServerのNativeインターフェイス ODBCドライバのエラーが出力されます。出力されるエラーの詳細については、Symfoware Serverのマニュアルを参照してください。

RDB2_TCPのポート番号の設定

以下のファイルに、RDB2_TCP用のポート番号を設定してください。

システムフォルダー\system32\drivers\etc\services

※ システムフォルダーは環境変数“SystemRoot”に設定されているフォルダーです。

/etc/services

例

ポート番号に2050を割り当てる場合

RDBII 2050/TCP

注意

ポート番号には、システム上のアプリケーションを含むすべてのサービスにおいて、それぞれ異なるポート番号を設定する必要があります。以下の値を設定しないでください。

システム内の他のサービス、システム上のアプリケーションが使用するポート番号
システムが動的に割り当てる領域のポート番号(エフェメラルポート)

ポート番号の設定については、「付録D ポート番号」を参照してください。