8.2.4 定義項目の詳細

プロセス監視定義の項目の内容を次の表に示します。プロセス監視定義の指定項目内容の説明では,例の記述がWindows表記となっています。UNIX上ではUNIX表記に置き換えてください。

表8-1 プロセス監視定義の項目の内容

項番定義項目指定する値項目の説明
1起動プロセスの識別子
(必須)
直接起動方式の場合
先頭がa~zまたはA~Zの英字で始まる,4文字以上32文字以下の英数字
間接起動方式の場合
先頭が0~9の数字で始まる,4文字以上32文字以下の英数字
2起動する監視対象プロセスの名称-正常起動
(必須)
255文字以内の文字列
直接起動方式の場合
起動するプロセス名
間接起動方式の場合
発行するコマンド名
3起動する監視対象プロセスの名称-再起動255文字以内の文字列
間接起動方式の場合
プロセスID取得用のコマンド名
名称を指定しない場合は,項番2で指定した名称が適用されます。
間接起動方式で,コマンドが未設定の場合,TPBrokerはプロセスを起動および停止するだけで,監視はしません。
4起動する監視対象プロセスの名称-強制正常起動255文字以内の文字列名称を指定しない場合は,項番2で指定した名称が適用されます。
間接起動方式の場合は,無視されます。
5プロセス起動用コマンドおよびプロセス停止用コマンドのタイムアウト値0~1800(秒)
デフォルト:300
「プロセス起動用コマンドのタイムアウト値 , プロセス停止用コマンドのタイムアウト値」の形式で指定します。
プロセス開始コマンドのタイムアウト値は間接起動方式の場合だけ有効です。
プロセス起動用コマンドのタイムアウトおよびプロセス停止用コマンドのタイムアウトに0を設定した場合,コマンドのプロセスを即時に強制終了します。
プロセス起動用コマンドのタイムアウト
項番2で指定したコマンドの終了を,プロセス起動用コマンドのタイムアウト値で指定した時間だけ待ちます。指定時間が経過してもコマンドが終了しない場合は,コマンドのプロセスを強制停止します。
プロセス停止用コマンドのタイムアウト
項番11および項番12で指定したコマンドの終了を,プロセス停止用コマンドのタイムアウト値で指定した時間だけ待ちます。指定時間が経過してもコマンドが終了しない場合は,コマンドのプロセスを強制停止します。
6プロセス起動に失敗した場合のTPBrokerの処置
(必須)
次のどれか一つを指定します。
  • down
    TPBrokerの運用支援機能を終了する
  • restart
    起動に失敗したプロセスを再起動する
  • none
    何もしないで処理を続ける
デフォルト:none
「restart」を指定した場合は,プロセス起動を連続3回失敗すると,それ以降は再起動処理を行いません。
7監視対象プロセスが異常終了した場合のTPBrokerの処置
(必須)
次のどれか一つを指定します。
  • down
    TPBrokerの運用支援機能を終了する
  • restart
    異常終了したプロセスを再起動する
  • none
    何もしない
  • command
    特定のコマンドを発行する
デフォルト:none
「command」を指定した場合は,発行するコマンド名を指定します(項番8を参照のこと)。
8監視対象プロセスが異常終了した場合に発行するコマンド名255文字以内の文字列項番7で「command」を指定した場合,必ず指定します。
9プロセスを起動するタイミング
(必須)
次のどちらかを指定します。
  • none
    admstartコマンド発行時に起動
  • command
    admstartprcコマンド発行時に起動
デフォルト:none
10一定時間内に連続して異常終了する回数の上限
(必須)
0以上の整数
デフォルト:3
監視時間は10分です。
指定値回目の再起動を抑止します。指定値0と1は再起動を行いません。
この定義の指定は,項番7で「restart」を指定している場合だけ有効です。
11正常停止用コマンド255文字以内の文字列コマンドを指定しない場合は,システムコール(UNIXの場合はkill(),Windowsの場合はTerminateProcess())でプロセスが直接停止します。
12強制停止用コマンド255文字以内の文字列コマンドを指定しない場合は,項番11に指定したコマンドが発行されます。
13コマンド実行用のユーザID0~59999の符号なし整数Windows版の場合は無視されます。
14コマンド実行用のグループID0~59999の符号なし整数Windows版の場合は無視されます。
15プロセス起動時に設定する環境変数名と値511文字以内の文字列
「"環境変数名=値","環境変数名=値"…」の形式で指定します。
全体で511文字以内にしてください。
必要な場合に指定します。
16TPBroker開始時に設定する環境変数名と値511文字以内の文字列
「PUTENV:環境変数名=値」の形式で指定します。
ADMFS,ADMSPOOL,TPDIR,TPFS,TPDIRは設定せず,admsetupコマンド実行時の環境変数を引き継がせてください。
必要な場合に指定します。
環境変数は,0~100個まで,1行に1個だけ指定できます。
ここで指定した環境変数は,監視対象プロセスすべてに設定されます。
項番15で指定した環境変数名と重複する場合,プロセス起動時には項番15の値が設定されます。
指定しない場合,admsetupコマンド実行時の環境変数が使用されます。
17改行文字¥定義が複数行にわたる場合は,必ず指定します。
18コメント#「#」から行末までをコメントとみなします。
例1
#コメント1
aaaa:"C:¥tpbroker¥bin¥xxxx": ....
例2
aaab:
"C:¥tpbroker¥bin¥xxxx": ¥ #コメント2
(凡例)
-:該当する内容がないことを表します。
注※
停止用コマンドのタイムアウト値は,TPBroker 05-15以降で有効です。