トランザクショナル分散オブジェクト基盤 TPBroker ユーザーズガイド
![[目次]](FIGURE/CONTENT.GIF)
![[索引]](FIGURE/INDEX.GIF)
![[前へ]](FIGURE/FRONT.GIF)
TPBrokerを使用するために,次に示す環境変数を設定してください。システム環境変数の値を変更した場合は,Windowsを再起動してください。
なお,説明中の「$」で始まる文字列はUNIXでの表記であり,Windowsの場合は「%」で始まり「%」で終わる文字列になります。同様に「/」はUNIXの表記であり,Windowsの場合は「\」になります。例えば,UNIXで$TPDIR/libの場合,Windowsでは%TPDIR%\libになります。
- <この節の構成>
- (1) 必ず設定する環境変数
- (2) オプションの環境変数
(1) 必ず設定する環境変数
- CLASSPATH(Java)
JARファイルを環境変数の値に追加します。
- Java OTS用JARファイル
- $TPDIR/lib/tpcosots.jar
- ORB用JARファイル
- $TPDIR/lib/vbjorb.jar
- (Windows)
- prompt> set CLASSPATH=%TPDIR%\lib\tpcosots.jar;%TPDIR%\lib\vbjorb.jar
- (UNIX)
- csh(Cシェル)の場合
- prompt> setenv CLASSPATH $TPDIR/lib/tpcosots.jar:$TPDIR/lib/vbjorb.jar
- sh(ボーンシェル)の場合
- prompt> CLASSPATH=$TPDIR/lib/tpcosots.jar:$TPDIR/lib/vbjorb.jar
- prompt> export CLASSPATH
-
- OSAGENT_PORT
OSAgentが使用するポート番号を指定します。デフォルト値は14000です。OSAgentは起動時に,定義されたポート番号でリクエストを検出しようとします。TPBrokerは,この環境変数からポート番号を取得して,そのポート番号によってOSAgentと通信します。
一つのホストで複数のOSAgentプロセスを実行する場合,各OSAgentプロセスには,それぞれ別のポート番号を指定してください。
ポート番号を10000にする例を次に示します。
- (Windows)
- prompt> set OSAGENT_PORT=10000
- (UNIX)
- csh(Cシェル)の場合
- prompt> setenv OSAGENT_PORT 10000
- sh(ボーンシェル)の場合
- prompt> OSAGENT_PORT=10000
- prompt> export OSAGENT_PORT
-
- PATH
TPBrokerが提供する運用コマンドの格納ディレクトリ($TPDIR/bin)を指定します。
- (Windows)
- prompt> set PATH=%TPDIR%\bin;%PATH%
- (UNIX)
- csh(Cシェル)の場合
- prompt> setenv PATH $TPDIR/bin:$PATH
- sh(ボーンシェル)の場合
- prompt> PATH=$TPDIR/bin:$PATH
- prompt> export PATH
-
- TPDIR
TPBrokerがインストールされたディレクトリを指定します。
- TPJDIR(Java)
TPBrokerがインストールされたディレクトリを指定します。
- TZ
タイムゾーンを指定します。日本時間の場合は,JST-9を指定してください。
- VBROKER_ADM
TPBrokerのインタフェースリポジトリ,OAD,およびOSAgentの定義情報が格納されているディレクトリを指定します。
環境変数VBROKER_ADMには,$TPDIR/admを設定することをお勧めします。$TPDIR/adm以外を設定する場合は,$TPDIR/admをディレクトリごとコピーした上で,この環境変数を設定してください。
またこの環境変数は,デフォルトではORBのトレースファイルなどの出力先の起点になります。ORBのトレースファイルなどの出力先は,デフォルトでは$VBROKER_ADM/../log(C++)および$VBROKER_ADM/../logj(Java)になります。
- (Windows)
- prompt> set VBROKER_ADM=%TPDIR%\adm
- (UNIX)
- csh(Cシェル)の場合
- prompt> setenv VBROKER_ADM $TPDIR/adm
- sh(ボーンシェル)の場合
- prompt> VBROKER_ADM=$TPDIR/adm
- prompt> export VBROKER_ADM
-
次に示す三つの環境変数は,使用するOSによって異なります。共用ライブラリのパスに,TPBrokerが提供するライブラリのディレクトリ($TPDIR/lib)を追加してください。これらの環境変数はOSごとに必ずアップデートしてください。C++実行環境の場合,tslnkrmコマンドに-iオプションを付けて,リソースマネージャをTPBrokerに登録しているときは,$TPSPOOL/XAも追加してください。
(2) オプションの環境変数
- ADMFS
TPBrokerの運用支援機能の情報(システムステータスファイル)を格納するディレクトリ,またはキャラクタ型スペシャルファイルを指定します。
admsetupコマンドに-cオプションを付けて実行したときに,この環境変数に設定されているディレクトリが生成されます。
キャラクタ型スペシャルファイルを指定する場合は,あらかじめtsmkfsコマンドでTPBrokerファイルシステムを作成しておく必要があります。TPBrokerファイルシステムについては「7.6 TPBrokerファイルシステム(UNIX)」を参照してください。
この環境変数が設定されていない場合は,環境変数ADMSPOOLに指定したディレクトリが使用されます。
同一ノード内に複数のTPBrokerの運用支援機能の実行環境を登録する場合は,それぞれの環境で異なるディレクトリを環境変数ADMFSに指定してください。また,環境変数TPFSおよび環境変数TPSPOOLと異なる値にしてください。
- ADMSPOOL
TPBrokerの運用支援機能の情報を格納するディレクトリを指定します。
admsetupコマンドに-cオプションを付けて実行したときに,この環境変数に指定されているディレクトリが生成されます。
この環境変数が設定されていない場合は,$TPDIR/spoolが使用されます。
同一ノード内に複数のTPBrokerの運用支援機能の実行環境を登録する場合は,それぞれの環境で異なるディレクトリを環境変数ADMSPOOLに指定してください。また,環境変数TPFSおよび環境変数TPSPOOLと異なる値にしてください。
- TPB_TRN_TRACE_PATH
トランザクショントレース情報を格納するディレクトリを指定します。
tssetupコマンドを実行したときに,この環境変数に指定されているディレクトリが生成されます。
この環境変数が設定されていない場合は,環境変数TPSPOOLに指定したディレクトリが使用されます。
- TPFS
トランザクションのステータスファイルを格納するディレクトリ,またはキャラクタ型スペシャルファイルを指定します。
キャラクタ型スペシャルファイルを指定する場合は,あらかじめtsmkfsコマンドでTPBrokerファイルシステムを作成しておく必要があります。TPBrokerファイルシステムについては,「7.6 TPBrokerファイルシステム(UNIX)」を参照してください。
この環境変数が設定されていない場合は,環境変数TPSPOOLに指定したディレクトリが使用されます。
同一ノード内に複数のOTS実行環境を起動する場合は,それぞれの環境で異なるディレクトリを環境変数TPFSに指定してください。また,環境変数ADMFSおよび環境変数ADMSPOOLと異なる値にしてください。
- TPRMINFO(C++)
アプリケーションプログラムおよび決着プロセスが使用するリソースマネージャを識別するための定義キーの名称を指定します。設定内容の詳細は「8.3.3 リソースマネージャ定義(C++)」を参照してください。
- TPSPOOL
TPBroker稼働情報などを格納するディレクトリを指定します。tssetupコマンドを実行したときに,この環境変数に設定されているディレクトリが生成されます。
この環境変数が設定されていない場合は,$TPDIR/otsspoolが使用されます。同一ノード内に複数の運用支援機能の実行環境,または複数のOTS実行環境を起動する場合は,それぞれの環境で異なるディレクトリを環境変数TPSPOOLに指定してください。また,環境変数ADMFSおよび環境変数ADMSPOOLと異なる値にしてください。
- TPSYS_APTTRCPERTHRD(C++)
〜((1〜255))<<32>>(単位:トレース)
一つのスレッドで格納できるAPIトレース数を指定します。この値を超える回数のAPIが同一スレッドから発行された場合は,古いAPIトレースから上書きされます。無効な値を指定した場合は,デフォルト値が適用されます。ただし,tx_infoおよびget_transaction_nameオペレーションを発行した場合は,取得情報が通常よりも多くなるため,格納できるAPIトレース数が指定値よりも少なくなります。
- TPSYS_APTUSE(C++)
APIトレースを取得するかどうかを指定します。APIトレースを取得するには,任意の値(例えば1)を指定します。
この環境変数が設定されていない場合は,APIトレースは取得されません。
All Rights Reserved. Copyright (C) 2008, Hitachi, Ltd.