jpcctrl register

形式

jpcctrl register     サービスID
                   [host=ホスト名
                   [lhost=論理ホスト名

機能

jpcctrl registerコマンドは,削除されたPerformance Managementプログラムのサービス情報をPerformance Managementに再登録するコマンドです。

通常,サービス情報を削除するjpcctrl deleteコマンドでは,起動中のサービス情報を削除できません。しかし,通信障害などが発生し,そのサービスの起動状態が確認できなかった場合,サービス情報が削除されます。通信障害などが発生し,起動中のサービス情報を削除してしまった場合,通信が回復したあとにjpcctrl registerコマンドを実行することで,サービス情報を再登録できます。

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

PFM - Manager

実行権限

Windowsの場合
  • Administrators権限を持つユーザー
  • Backup Operators権限を持つユーザー
UNIXの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

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

引数

サービスID

サービスIDを指定します。1~258バイトで指定します。

ワイルドカード文字を使用して,複数のサービスIDを指定することもできます。この場合,あるサービスがエラーとなっても,残りのサービスに対して処理が続行されます。また,複数のサービスに対してエラーが発生した場合,最後に発生したエラーに対する戻り値が返されます。

host=ホスト名

特定のホストのサービス情報を再登録する場合にこの引数を使用します。1~32バイトの半角英数字で指定します。空白文字は,指定できません。指定を省略した場合,ローカルホストが仮定されます。

ワイルドカード文字を使用して,複数のホスト名を指定することもできます。

lhost=論理ホスト名

このコマンドを実行するホストを,物理ホスト環境ではなく論理ホスト環境とする場合にその論理ホスト名を指定します。1~32バイトの半角英数字で指定します。空白文字は,指定できません。指定を省略した場合,物理ホストが仮定されます。ワイルドカード文字は使用できません。

注意事項

戻り値

0正常終了した。
1引数の指定に誤りがある。
2コマンドの実行権限がない。
3指定されたサービスのうち,一つ以上が起動していない。
5PFM - Managerがインストールされていない。
7指定されたサービスIDがName ServerサービスまたはStatus Serverサービスのものである。
100Performance Managementの環境が不正である。
101Name Serverサービス,Master Managerサービス,または操作対象サービスのどれかが起動していない。
102指定された論理ホスト名はセットアップされていない。
200メモリーが不足している。
220サービス構成情報ファイルに指定しているホスト名が不正である。
222通信処理でエラーが発生した。
255予期しないエラーが発生した。

使用例

ホストhost03でのすべてのPerformance Managementプログラムのサービス情報を再登録する場合のコマンド実行例を次に示します。

jpcctrl register * host=host03