Interstage Application Server アプリケーション作成ガイド (データベース連携サービス編)

6.2 リソース定義ファイルの作成

　リソース定義ファイルは、データベースごとに作成し、データベースに接続するための情報など（リソース定義）をテキスト形式で記述します。

　Interstage管理コンソールを使用する場合は、JTS用のリソース定義ファイルを作成する必要がありません。

OTS用のリソース定義ファイルの記述：

　なお、リソース管理プログラムをスレッドモードとして動作させる場合にTHREADS=TRUEを記述します。

　リソース定義ファイルの設定例を以下に示します。

Oracle用のリソース定義ファイル例（プロセスモード時）

# 環境変数
ENVIRON ORACLE_SID=orac
# 使用するデータベースシステム名と OPENINFO文字列、CLOSEINFO文字列
NAME=oracle_rmp_process
RMNAME=Oracle_XA
OPENINFO=Oracle_XA+Acc=P/system/manager+SesTm=0
CLOSEINFO=

Oracle用のリソース定義ファイル例（スレッドモード時）

# 環境変数
ENVIRON ORACLE_SID=orac
# 使用するデータベースシステム名と OPENINFO文字列、CLOSEINFO文字列
NAME=oracle_rmp_thread
RMNAME=Oracle_XA
OPENINFO=Oracle_XA+Acc=P/system/manager+SesTm=0+Threads=true
CLOSEINFO=

Oracle用のリソース定義ファイル例（プロセスモード時）

# 環境変数
ENVIRON ORACLE_SID=orac
ENVIRON ORACLE_HOME=/opt/oracle
ENVIRON LD_LIBRARY_PATH=/opt/oracle/lib
# 使用するデータベースシステム名と open 文字列、close 文字列
NAME=oracle_rmp_process
RMNAME=Oracle_XA
OPENINFO=Oracle_XA+Acc=P/system/manager+SesTm=0
CLOSEINFO=

Oracle用のリソース定義ファイル例（スレッドモード時）

# 環境変数
ENVIRON ORACLE_SID=orac
ENVIRON ORACLE_HOME=/opt/oracle
ENVIRON LD_LIBRARY_PATH=/opt/oracle/lib
# 使用するデータベースシステム名と open 文字列、close 文字列
NAME=oracle_rmp_thread
RMNAME=Oracle_XA
OPENINFO=Oracle_XA+Acc=P/system/manager+SesTm=0+Threads=true
CLOSEINFO=
THREADS=TRUE

Symfoware/RDB用リソース定義ファイル例

# 使用するデータベースシステム名とOPENINFO文字列、CLOSEINFO文字列
NAME=symfo_rmp
RMNAME=RDBII
OPENINFO=TO 'DB1' USER 'system/manager'
CLOSEINFO=

Symfoware/RDB用リソース定義ファイル例 (プロセスモード時)

# 使用するデータベースシステム名とOPENINFO文字列、CLOSEINFO文字列
NAME=symfo_rmp_process
RMNAME=RDBII
OPENINFO=TO 'DB1' USER 'system/manager'
CLOSEINFO=

Symfoware/RDB用リソース定義ファイル例 (スレッドモード時)

# 使用するデータベースシステム名とOPENINFO文字列、CLOSEINFO文字列
NAME=symfo_rmp_thread
RMNAME=RDBII
OPENINFO=TO 'DB1' USER 'system/manager'
CLOSEINFO=
THREADS=TRUE

SQL Server用リソース定義ファイル例

# 使用するデータベースシステム名とOPENINFO文字列、CLOSEINFO文字列
NAME=sqlserver_rmp
RMNAME=MS_SQL_Server
OPENINFO=Tm=OTS,RmRecoveryGuid=197BAA60-8011-11d2-B342-0000E20F0756
CLOSEINFO=Tm=OTS,RmRecoveryGuid=197BAA60-9011-11d2-B342-0000E20F0756

　リソース定義ファイルはテキストエディタで作成します。リソース定義ファイルの書式を以下に説明します。なお、１文字目に“#”を記述された場合はコメント行とみなします。

ENVIRON env = "data"

　リソース管理プログラムあるいは、リソース管理プログラムと同じプロセス内で動作するデータベースライブラリに渡す環境変数envを、値dataに設定します。
　渡す必要がなければ、省略することができます。

　リソース管理プログラムを使用するサーバアプリケーションの起動時に指定するデータベースへの環境変数と同一の環境変数を指定してください。
　また、リソース定義ファイルには、
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/oracle/libのように$指定をすることはできません。

　使用するデータベースがSymfoware/RDBの場合、Symfoware/RDBの必須製品であるライブラリのパス名を、環境変数LD_LIBRARY_PATHに指定してください。
　使用するデータベースがOracle10gの場合、32ビット互換ライブラリ格納先へのパスをを環境変数LD_LIBRARY_PATHに指定してください。

NAME=リソース定義名

　otssetrscコマンドによって登録された際に、ここに記載されたリソース定義名として登録されます。一度登録されたリソース定義ファイルは、すべてリソース定義名で扱うことが可能になります。リソース定義名は32文字以内で記述する必要があります。
　"JTSRMP"は予約語ですのでリソース定義名に使用できません（一部またはすべてを小文字にしても使用できません）。

RMNAME = "system_name"

　system_nameにデータベースのシステム名を指定します。

　Oracleの場合、"Oracle_XA"、Symfoware/RDBの場合、"RDBII"、SQL Serverの場合、"MS_SQL_Server"、MQDの場合、"XA_MQD"です。

　Oracleの場合、"Oracle_XA"、Symfoware/RDBの場合、"RDBII"、MQDの場合、"XA_MQD"です。

　Oracleの場合、"Oracle_XA"、Symfoware/RDBの場合、"RDBII"です。

OPENINFO = "open_data"

　open_dataにデータベースのベンダが公開する、データベースをオープンする場合に必要なopen文字列を指定します。
　open_dataは256文字以下で指定します。
　指定する内容については、各データベースのマニュアルを参照してください。

CLOSEINFO = "close_data"

　close_dataにデータベースのベンダが公開する、データベースをクローズする場合に必要なclose文字列を指定します。
　close_dataは256文字以下で指定します。
指定する内容については、各データベースのマニュアルを参照してください。

THREADS=TRUE | FALSE

　リソース管理プログラムがプロセスモード(FALSE)か、スレッドモード(TRUE)かを指定します。省略した場合は、FALSE(プロセスモード)になります。

注意

　OPENINFOに指定するユーザ名は、各データベースに対するアクセス権限がないと、リソース管理プログラムの起動が失敗します。必要な権限に関しては、“アプリケーション作成時の注意”を参照してください。また詳細は各データベースのマニュアルを参照してください。

　プロセスモードならびにスレッドモードのタイプが、リソース管理プログラム作成時と動作時（リソース定義ファイル内のスレッド指定）に違っている場合、リソース管理プログラムの起動が誤動作する可能性がありますので、必ずタイプをあわせて運用してください。

OTS_RMP_PROC_CONC=OTS用のリソース管理プログラムの多重度

OTS用のリソース管理プログラムの多重数を指定します。省略した場合は多重度5となります。通常は変更する必要がありません。指定する場合は、1〜31の範囲で指定することが可能です。
　最大値を超えた場合は、警告メッセージ（ots9017）を出力し、31を自動的に設定します。

　リソース管理プログラムの多重度は、トランザクション処理性能を最大限に引き出すようにチューニングされているため、デフォルト値を変更する必要はありません。
　変更する場合は、OTSシステムのスレッド多重度とリソース管理プログラムの多重度の関係を以下のように設定してください。
　　OTSシステムのスレッド多重度　＝＜ リソース管理プログラムの多重度

RSCTYPE=OTS

　リソース定義ファイルの種別を指定します。otssetrscコマンドで登録した際に付加される情報です。otssetrsc -lコマンドの出力をリダイレクトし、そのままotssetrscコマンドで利用できるように追加されています。通常は指定する必要はありません。省略可能です。

USER=ユーザ名

　データベース管理者のユーザ名を指定します。省略した場合には、スーパーユーザの権限で起動するようになります。otssetrscコマンド実行時に、-uオプションを指定した場合には、オプションに指定されたユーザ名が有効になります。
　“GROUP”と同時に指定する必要があります。

GROUP=グループ名

　データベース管理者のグループ名を指定します。省略した場合には、スーパーユーザの権限で起動するようになります。otssetrscコマンド実行時に、-gオプションを指定した場合には、オプションに指定されたグループ名が有効になります。
　“USER”と同時に指定する必要があります。

JTS用のリソース定義ファイルの記述（JDBCを利用する場合）：

　従来の方法でリソース定義を登録して使用する場合は、リソース定義ファイルを作成する必要があります。JDBCを利用してデータベースと連携する場合のリソース定義ファイルの設定例を以下に示します。

リソース定義ファイル例

# database1
name=xads1
rscType=JTS
type=JDBC
lookUpName=jdbc/XADataSource
initialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory
providerURL=file://c:/tmp/JNDI
user=dbuser
password=dbpass
logfileDir=c:\interstage\ots\var

リソース定義ファイル例

# database1
name=xads1
rscType=JTS
type=JDBC
lookUpName=jdbc/XADataSource
initialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory
providerURL=file:/tmp/JNDI
user=dbuser
password=dbpass
logfileDir=/opt/FSUNots/var

　リソース定義ファイルはテキストエディタで作成します。リソース定義ファイルの書式を以下に説明します。なお、１文字目に“#”を記述された場合はコメント行とみなします。

name=リソース定義名

　otssetrscコマンドによって登録された際に、ここに記載されたリソース定義名として登録されます。一度登録されたリソース定義ファイルは、すべてリソース定義名で扱うことが可能になります。リソース定義名は32文字以内で記述する必要があります。
　"JTSRMP"は予約語ですのでリソース定義名に使用できません（一部またはすべてを小文字にしても使用できません）。
　通常は、J2EEリソースアクセス定義によって登録する、接続対象となるリソースの"定義名"を指定することを推奨します。
　詳細は、“J2EE ユーザーズガイド”を参照してください。
　省略することはできません。

rscType=JTS

　"JTS"を指定してください。
　省略することはできません。省略した場合は、"OTS"が指定されたものとして扱われるため、JTS用のリソース定義ファイルとして正しく動作しません。

type=JDBC

　"JDBC"または"DBMS"(旧バージョンでの指定方法)を指定してください。
　省略することはできません。

lookUpName=データソースをバインドした名前

　データベースが提供するデータソースをバインドした名前を指定します。
　J2EEリソースアクセス定義で設定したデータソース名と同じ値を指定してください。

initialContextFactory=initialContextFactory名

　バインドされたデータソースを参照する時に使用するinitialContextFactoruy名を指定します。J2EEリソースアクセス定義で設定したクラス名と同じ値を指定してください。

providerURL=プロバイダURL

　バインドされたデータソースを参照する時に使用するprovider URLを指定します。
　J2EEリソースアクセス定義で設定したURLと同じ値を指定してください。

user=ユーザ名

　リソースと接続する際にユーザ名が必要な場合に指定します。
　J2EEリソースアクセス定義によって設定したユーザ名を指定してください。

password=パスワード

　リソースと接続する際にパスワードが必要な場合に指定します。
　J2EEリソースアクセス定義によって設定したパスワードを指定してください。

logfileDir=ログファイルの格納先ディレクトリ

　接続したリソースのトラブル調査を行う場合は、トレースログを採取するディレクトリを指定してください。ディレクトリ名の最後にセパレータは付加しないでください。
　通常は指定しません。

　name、lookUpName、initialContextFactory、providerURLは、J2EEリソースアクセス定義によって登録されたリソース定義と同じものを指定するようにしてください。詳細は、“J2EE ユーザーズガイド”を参照してください。

JTS用のリソース定義ファイルの記述（J2EE Connector Architectureを利用する場合）：

　従来の方法でリソース定義を登録して使用する場合は、リソース定義ファイルを作成する必要があります。リソースアダプタを利用してEISと連携する場合のリソース定義ファイルの設定例を以下に示します。

リソース定義ファイル例

# resource adapter1
name=connector001
rscType=JTS
type=JCA
lookupName=myEIS
user=rauser
password=rapass
logfileDir=c:\interstage\ots\var

リソース定義ファイル例

# resource adapter1
name=connector001
rscType=JTS
type=JCA
lookupName=myEIS
user=rauser
password=rapass
logfileDir=/opt/FSUNots/var

　リソース定義ファイルはテキストエディタで作成します。リソース定義ファイルの書式を以下に説明します。なお、１文字目に“#”を記述された場合はコメント行とみなします。

name=リソース定義名

　otssetrscコマンドによって登録された際に、ここに記載されたリソース定義名として登録されます。一度登録されたリソース定義ファイルは、すべてリソース定義名で扱うことが可能になります。リソース定義名は32文字以内で記述する必要があります。
　"JTSRMP"は予約語ですのでリソース定義名に使用できません（一部またはすべてを小文字にしても使用できません）。
　通常は、J2EEリソースアクセス定義によって登録する、接続対象となるリソースの"定義名"を指定することを推奨します。
　詳細は、“J2EE ユーザーズガイド”を参照してください。
　省略することはできません。

rscType=JTS

　"JTS"を指定してください。
　省略することはできません。

type=接続するリソースの種類

　"JCA"を指定してください。
　省略することはできません。

lookUpName=リソース名

　J2EE Deploymentツールによってリソースアダプタを配備する際に設定した"リソース名"を指定してください。

user=ユーザ名

　リソースと接続する際にユーザ名が必要な場合に指定します。J2EE Deploymentツールによってリソースアダプタを配備する際に設定したユーザ名、またはJ2EEリソースアクセス定義によって設定したユーザ名を指定してください。

password=パスワード

　リソースと接続する際にパスワードが必要な場合に指定します。J2EE Deploymentツールによってリソースアダプタを配備する際に設定したパスワード、またはJ2EEリソースアクセス定義によって設定したパスワードを指定してください。

logfileDir=ログファイルの格納先ディレクトリ

　接続したリソースのトラブル調査を行う場合は、トレースログを採取するディレクトリを指定してください。ディレクトリ名の最後にセパレータは付加しないでください。
　通常は指定しません。

　nameは、J2EEリソースアクセス定義によって登録されたリソース定義と同じものを指定するようにしてください。また、lookupName、user、passwordはJ2EE Deploymentツールによってリソースアダプタを配備する際に設定したものを指定してください。詳細は、“J2EE ユーザーズガイド”を参照してください。