rapkill（rapサーバの限界監視時間の指定と強制停止）

〈このページの構成〉

形式

rapkill -t 限界経過時間 〔-f〕〔-d〕 rapリスナー名〔〔△rapリスナー名〕…〕

指定したrapリスナー下で動作するdc_rpc_call代理実行中のrapサーバで，-tオプションで指定した限界経過時間を超えているrapサーバの情報を標準出力に表示します。また，オプションの指定で該当するrapサーバを強制停止します。

-t　限界経過時間　　〜〈符号なし整数〉((1〜65535))

dc_rpc_call代理実行処理を監視する限界経過時間を，秒単位で指定します。

-tオプションに指定した値を，（コマンド入力時刻−dc_rpc_call代理実行開始時刻）の値が超えているrapサーバの情報を標準出力に表示します。

RPC最大応答待ち時間×2（安全値）を目安にして指定してください。
-f

-tオプションで指定した限界経過時間を超えているdc_rpc_call代理実行中のrapサーバを強制停止します。
-d

-tオプションで指定した限界経過時間を超えているdc_rpc_call代理実行中のrapサーバに，userdumpコマンドを実行してダンプファイルを取得します。

ダンプファイルは「RAPSERVR_プロセスID.dmp」の名称でコマンド実行フォルダに出力されます。このオプションを-fオプションと同時に指定した場合，ダンプファイルを取得したあとで，該当するrapサーバを強制停止します。

[図データ]

なお，-tオプションで指定した限界経過時間を超えているdc_rpc_call代理実行中のrapサーバがない場合は，rapサーバの情報は表示されません。

rapkillコマンドを実行するSUPのサンプルと格納場所を次に示します。

サンプルSUPの仕様

環境変数RAPKILL_INTERVALに指定された時間間隔（デフォルト値：1800，単位：秒）でrapkill -fdコマンドを実行します。停止は，TP1/LiNK停止と同期します。

また，userdumpコマンドの実行時に，カレントディレクトリに出力されたダンプファイルを%DCDIR%\spool\saveに移動します。

rapkillコマンドのオプションは，次に示す環境変数で変更できます。

サンプルSUPの使用方法

実行形式ファイルを作成します

Microsoft Visual C++のnmakeコマンドを実行して実行形式ファイルを作成します。コマンドの入力例を次に示します。

C:\>cd %DCDIR%\sample\TP1LINK\RAPKILL <CR>

C:\>nmake <CR>
実行形式ファイルをコピーします

作成した実行形式ファイルrapkillp.exeを，%DCDIR%\aplib下にコピーします。
定義ファイルをコピーします

定義ファイル%DCDIR%\sample\TP1LINK\CONF\RAPKILLを，%DCDIR%\conf下にコピーします。
実行環境を確認します

［アプリケーション管理SUP］ウィンドウで，ユーザサーバ名RAPKILLがあることを確認したあとで，RAPKILLの環境変数などを変更します。

-dオプションを指定してrapkillコマンドを実行する場合は，userdumpコマンドのパスが，システム環境変数か，または［システム環境設定］ウィンドウのサーチパスにある必要があります。

また，自動起動する場合はRAPサービスよりあとに起動してください。

SUP使用上の注意事項

RAPサービスの起動や停止のタイミングによっては，rapkillコマンドがRAPサービス未起動でエラー（dc_adm_call_command関数がDCADMER_STATNOTZERO（-1855）でエラーリターン）になることがあります。