トランザクショナル分散オブジェクト基盤 TPBroker Object Transaction Monitor ユーザーズガイド
tscstartコマンドおよびtscstartprcコマンドの-TSCEnvironオプションには,ユーザ環境変数定義ファイルを指定できます。ユーザ環境変数定義ファイルには,開始するプロセスが使用する環境変数を記述します。記述した環境変数は,それぞれ,次のプロセスに渡されます。
- tscstartコマンドの場合
TSCデーモン,およびTSCデーモンが開始する,次のプロセスに渡されます。
- tscstartprcコマンドで開始するサーバアプリケーション
- tscstartコマンドの-TSCRegStartオプションによって自動開始されるTSCレギュレータ
- tscstartprcコマンドの場合
tscstartprcコマンドで開始するサーバアプリケーションに渡されます。-TSCEnvironオプションを使用すると,例えば,特定のサーバアプリケーションだけに環境変数から値を渡すことができます。
- <この項の構成>
- (1) ユーザ環境変数定義ファイルの記述形式
- (2) ユーザ環境変数定義ファイルの記述例
- (3) ユーザ環境変数定義ファイル使用時の注意事項
ユーザ環境変数定義ファイルの記述形式を次に示します。
環境変数名称=指定値
環境変数名称,イコール(=),および環境変数値のどれも省略できません。行の先頭からその行の最初のイコール(=)の直前までが環境変数名称とみなされます。また,最初のイコール(=)の直後から改行またはファイルの終端の直前までが環境変数値とみなされます。
シャープ(#)で始まる行は,その行全体がコメントとみなされて無視されます。また,行の途中からシャープ(#)の場合はそれ以降から行の最後までがコメントとみなされて無視されます。このとき,シャープ(#)の手前の空白およびタブも無視されます。したがって,シャープ(#)は有効な環境変数値としては指定できません。
一つの定義を複数行に分けて記述する場合は,改行の直前に継続符号(\)を記述してください。継続符号(\)を記述した場合,直前の空白およびタブは無視されます。ただし,行の途中に記述された継続符号(\)は文字として扱われます。また,コメントを記述した行に継続行を続けることはできません。シャープ(#)を記述すると,その行の終わりまでがコメントとみなされるため,継続符号(\)を記述しても行の継続はできなくなります。
- 指定された環境変数は,すでに同一の環境変数名称があれば上書きされ,なければ追加されます。tscstartコマンドでは,tscstartコマンド実行時の環境変数が基となります。tscstartprcコマンドでは,TSCデーモンの実行環境の環境変数,つまり,tscstartコマンド実行時の環境変数にtscstartコマンドの-TSCEnvironオプションで指定された環境変数を上書きまたは追加した環境変数が基となります。
(2) ユーザ環境変数定義ファイルの記述例
ユーザ環境変数定義ファイルの記述例を次に示します。
# コメント行
LANG=ja_JP.SJIS # 以降コメント
CLASSPATH=/opt/TPBrokerOTM_S/lib/tscsv.jar: \
/opt/java/lib/classes.zip # 継続行
(3) ユーザ環境変数定義ファイル使用時の注意事項
ユーザ環境変数定義ファイルを使用する場合の注意事項を次に示します。
- 先頭が"TSC"または"tsc"で始まる環境変数名称は使用できません。
- 環境変数名称には,英数字およびアンダースコア(_)で構成される文字列を指定してください。
- 行の先頭から環境変数名称までは空白およびタブは記述できません。行の先頭から環境変数名称を記述してください。
- 環境変数名称とイコール(=)の間,およびイコール(=)と環境変数定義の間に空白およびタブを記述しないでください。
- 環境変数定義ファイル中に$AAA(UNIXの場合)または%AAA%(Windowsの場合)の記述がある場合,これらはそのままの文字列として認識されます。環境変数AAAとして展開されません。
- 空行(環境変数定義もコメントもない行)を記述する場合は,空白およびタブを含めないで改行コードだけにしてください。
- 次に示す場合は定義内容不正となります。
- 環境変数定義内にイコール(=)がない場合
- 行の先頭または最後にイコール(=)がある場合
- 環境変数名称の先頭が"TSC"または"tsc"で始まる場合
- 空白およびタブだけの行がある場合
All Rights Reserved. Copyright (C) 2002, 2005, Hitachi, Ltd.