jpcstart

形式

jpcstart     サービスキー
           [lhost=論理ホスト名
           [inst=インスタンス名

機能

jpcstartコマンドは,ローカルホストのPerformance Managementプログラムのサービスを起動するコマンドです。リモートホストのPerformance Managementプログラムのサービスは,起動できません。

Performance Managementプログラムのサービスの状態を確認するには,jpcctrl listコマンドを使用してください。jpcstartコマンドを二重実行したり,jpcstopコマンドと同時に実行したりできません。

起動対象サービスにPFM - Managerが含まれ,コマンドを実行するPFM - Managerホストでヘルスチェック機能が有効になっている場合,PFM - Managerのサービスの一部としてヘルスチェックエージェントも起動します。なお,サービスキーにagt0は指定できません。

コマンドを実行できるホスト

実行権限

Windowsの場合
Administrators権限を持つユーザー(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
インストール先フォルダ¥tools¥
UNIXの場合
/opt/jp1pc/tools/

引数

サービスキー

起動するサービスのサービスキー名を指定します。指定できるサービスキーを次に示します。

PFM - Agentのサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。

lhost=論理ホスト名

コマンドを実行するホスト環境を指定します。コマンドを実行するマシンに論理ホストが構成されている場合,この引数を使用します。1~32バイトの半角英数字で指定します。空白文字は,指定できません。

指定を省略した場合,物理ホストが仮定されます。ワイルドカード文字は使用できません。

inst=インスタンス名

特定のインスタンスのサービスを起動する場合は,インスタンス名を指定します。このオプションは,インスタンス環境を持つPFM - Agentのサービスにだけ有効となります。それ以外のサービスについては,このオプションは無視されます。1~32バイトの半角英数字で指定します。

注意事項

戻り値

0正常終了した。
1引数の指定に誤りがある。
2コマンドの実行権限がない。
4指定されたサービスはすでに起動している。または,Master StoreサービスもしくはAgent Storeサービス,またはコマンドがStoreデータベースアクセス中にコマンドを実行した。
5指定されたサービスがインストールされていない。
10コマンドはほかのセッションで実行中である。
100Performance Managementの環境が不正である。
101PFM - Managerサービスが起動していない。
102指定された論理ホスト名またはインスタンスは,セットアップされていない。
103起動処理の監視がタイムアウトになった。
107Windowsサービスコントロールマネージャーなどのほかのプロセスからサービス起動処理および停止処理が実行されている。
212インデックスの作成に失敗しました。
255予期しないエラーが発生した。

使用例1

すべてのPerformance Managementプログラムのサービスを起動する場合のコマンド実行例を次に示します。

jpcstart all

使用例2

PFM - Agent for Oracleのうち,インスタンスoracleAのサービスだけ起動する場合のコマンド実行例を次に示します。

jpcstart agto inst=oracleA