JP1/Performance Management リファレンス

jpcconf mgrhost define

形式

jpcconf mgrhost define       -host ホスト名|-localhost
                             [-lhost 論理ホスト名]
                             [-noquery]

機能

jpcconf mgrhost defineコマンドは，接続先PFM - Managerホスト（Name Serverサービス）のホスト名を設定および変更するコマンドです。

論理ホスト環境の接続先PFM - Managerホストを設定および変更する場合は，-lhostオプションを指定してください。

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

• PFM - Manager
• PFM - Agent
• PFM - Base
• PFM - RM

実行権限

接続先PFM - Managerホスト（Name Serverサービス）のホスト名を表示するだけの場合，実行権限は必要ありません。

PFM - Managerホストを設定および変更する場合（引数を指定する場合）は，次のOSユーザーだけが実行できます。

Windowsの場合

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

UNIXの場合

rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合

インストール先フォルダ\tools\

UNIXの場合

/opt/jp1pc/tools/

引数

-host ホスト名

接続先PFM - Managerホストのホスト名を指定します。1〜32バイトの半角英数字で指定します。IPアドレスによる指定はできません。

この引数は，PFM - Baseホスト，PFM - AgentまたはPFM - RMホストで実行できます。また，同一ホストでPFM - Managerが論理ホスト，PFM - AgentまたはPFM - RMが物理ホストの場合も実行できます。

ローカルホストにPFM - Managerがインストールされていた場合，このオプションを指定したとき，エラーとなります。PFM - AgentまたはPFM - RMのホストにPFM - Managerがインストールされていた場合，接続先PFM - Managerは，ローカルホストのPFM - Managerとなります。接続先PFM - ManagerホストとしてリモートホストのPFM - Managerホストは指定できません。

PFM - Managerホストにホスト名を二つ以上設定している場合，接続先PFM - Managerは，次のようにする必要があります。

• PFM - Managerの監視ホスト名に実ホスト名を使用している場合
  Windowsシステムではhostnameコマンド，UNIXシステムではuname -nコマンドを実行して確認したホスト名
  
• PFM - Managerの監視ホスト名にエイリアス名を使用している場合
  設定しているエイリアス名
  

-localhost

接続先をローカルホストに設定します。

-lhost 論理ホスト名

接続先PFM - Manager ホストを設定または変更する論理ホスト環境のホスト名を指定します。

1〜32バイトの半角英数字で指定します。半角空白文字および"."は指定できません。

論理ホスト名に，"localhost"，IPアドレス，"-"から始まるホスト名は指定できません。

-noquery

このオプションを指定すると，コマンドの実行を中断する問い合わせメッセージが出力されなくなり，ユーザーの応答が不要になります。非対話形式で実行したい場合に指定します。

なお，起動中のPerformance Managementサービスがあった場合は，KAVE05143-Eメッセージが出力され，コマンドの実行が中断されます。ローカルホスト上で起動しているすべてのPerformance Managementサービスを停止して，コマンドを再度実行してください。

注意事項

• ホスト上のすべてのPerformance Managementプログラムのサービスを停止してからこのコマンドを実行してください。ホスト名の設定が終わったあと，手動でサービスを起動してください。
• ホストからODBCドライバーを使用する場合，このコマンドを実行してください。
• コマンドの実行をCtrl+Cキーやシグナルで中断した場合，特定の戻り値が返りません。そのため，コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。

戻り値

0	正常終了した。
1	引数の指定に誤りがある。
2	コマンドの実行権限がない。
4	実行ホスト上のサービスが停止されていない。
10	コマンドはほかのセッションで実行中である。
11	ユーザーによって処理が中止された（問い合わせに対して「N」を返した場合）。
100	Performance Managementの環境が不正である。
101	ポート番号が取得できない。
102	指定された論理ホスト名がセットアップされていない。
200	メモリーが不足している。
210	ディスク容量が不足している。
211	ファイルまたはディレクトリにアクセスできない。
222	通信処理でエラーが発生した（IPアドレスが取得できない）。
230	内部コマンドの実行に失敗した。
255	予期しないエラーが発生した。

使用例1

接続先PFM - Managerホストをhostmgrに変更する場合のコマンド実行例を次に示します。

 
jpcconf mgrhost define -host hostmgr

使用例2

論理ホスト（ホスト名：jp1-ha1）の接続先PFM - Managerホストをhostmgrに変更する場合のコマンド実行例を次に示します。

 
jpcconf mgrhost define -host hostmgr -lhost jp1-ha1

[目次][前へ][次へ]

All Rights Reserved. Copyright (C) 2009, 2012, Hitachi, Ltd.
(C)opyright 2000-2009, by Object Refinery Limited and Contributors.