形式
jpcstop サービスキー
[lhost=論理ホスト名]
[inst=インスタンス名]
[kill=immediate]
機能
jpcstopコマンドは,ローカルホストのPerformance Managementプログラムのサービスを停止するコマンドです。リモートホストのPerformance Managementプログラムのサービスは,停止できません。
Performance Managementプログラムのサービスの状態を確認するには,jpcctrl listコマンドを使用してください。jpcstopコマンドを二重実行したり,jpcstartコマンドと同時に実行したりできません。
停止対象サービスにPFM - Managerが含まれ,コマンドを実行するPFM - Managerホストでヘルスチェック機能が有効になっている場合,PFM - Managerのサービスの一部としてヘルスチェックエージェントも停止します。なお,サービスキーにagt0は指定できません。
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
サービスキー
停止するサービスのサービスキー名を指定します。指定できるサービスキーを次に示します。
PFM - Agentのサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
lhost=論理ホスト名
コマンドを実行するホスト環境を指定します。コマンドを実行するマシンに論理ホストが構成されている場合,この引数を使用します。1~32バイトの半角英数字で指定します。空白文字は,指定できません。
指定を省略した場合,物理ホストが仮定されます。ワイルドカード文字は使用できません。
inst=インスタンス名
特定のインスタンスのサービスを停止する場合は,インスタンス名を指定します。このオプションは,インスタンス環境を持つPFM - Agentのサービスにだけ有効となります。それ以外のサービスについては,このオプションは無視されます。1~32バイトの半角英数字で指定します。
kill=immediate
クラスタ運用時に,起動中のプロセスを強制的に停止させる場合にだけ指定します。サービスキーにallを指定した場合,同一ホスト上で起動中のすべてのプロセスを停止します。all以外のサービスキーを指定した場合,そのサービスに対応するすべてのプロセスを停止します。ただし,instオプションを指定して,インスタンス単位でプロセスを停止させることはできません。
注意事項
戻り値
0 | 正常終了した。 |
1 | 引数の指定に誤りがある。 |
2 | コマンドの実行権限がない。 |
3 | 指定されたサービスは,すでに停止している。 |
5 | 指定されたサービスがインストールされていない。 |
10 | コマンドはほかのセッションで実行中である。 |
100 | Performance Managementの環境が不正である。 |
102 | 指定された論理ホスト名またはインスタンスは,セットアップされていない。 |
103 | 停止処理の監視がタイムアウトになった。 |
107 | Windowsサービスコントロールマネージャーなどのほかのプロセスからサービス起動処理および停止処理が実行されている。 |
108 | Status Serverサービスに依存するサービスが起動しているため,Status Serverを停止できない。 |
255 | 予期しないエラーが発生した。 |
使用例1
すべてのPerformance Managementプログラムのサービスを停止する場合のコマンド実行例を次に示します。
jpcstop all
使用例2
PFM - Agent for Oracleのうち,インスタンスoracleAのサービスだけ停止する場合のコマンド実行例を次に示します。
jpcstop agto inst=oracleA