jpcprocdef delete
形式
jpcprocdef delete -agent サービスID
{-name アプリケーション定義名
[-name アプリケーション定義名]... | -all}
[-noquery]
コマンドを実行できるホスト
PFM - Web Console
実行権限
- Windowsの場合
-
Administrators権限を持つユーザー
- UNIXの場合
-
rootユーザー権限を持つユーザー
また，コマンドを実行するためには，事前にPerformance Managementに対する管理ユーザー権限※のユーザーアカウントで認証用のキーファイルを作成する必要があります。詳細については，「jpcmkkey」コマンドを参照してください。
- 注※
-
Performance ManagementユーザーまたはJP1ユーザーが必要とする，Performance Managementに対する実行権限です。
格納先ディレクトリ
- Windowsの場合
-
インストール先フォルダ\tools\
- UNIXの場合
-
/opt/jp1pcwebcon/tools/
引数
-agent サービスID
アプリケーション定義を削除する対象エージェントを，Agent CollectorサービスまたはリモートエージェントのサービスIDで指定します。ワイルドカード文字は使用できません。
指定するサービスIDは，使用している監視エージェントによって次のように異なります。
|
使用している監視エージェント |
指定するサービスID |
|---|---|
|
PFM - Agent for Platform（Windows） |
Agent CollectorサービスのサービスID |
|
PFM - Agent for Platform（UNIX） |
|
|
PFM - RM for Platform |
リモートエージェントのサービスID |
次に示すサービスIDは指定できません。
-
Agent Storeサービス，Remote Monitor Collectorサービス，Remote Monitor StoreサービスおよびグループエージェントのサービスID
-
PFM - Agent for PlatformまたはPFM - RM for Platform以外のプロダクトのサービスID
-name アプリケーション定義名
-agentオプションで指定したエージェントに定義されているアプリケーション定義のうち，削除したい定義の名称を指定します。ワイルドカード文字は使用できません。
複数のアプリケーション定義を削除する場合は，-nameオプションを複数回続けて指定します。-nameオプションで指定したアプリケーション定義がエージェントに定義されていない場合は無視されます。
-all
-agentオプションで指定したエージェントに定義されているアプリケーション定義の定義情報をすべて削除します。
-noquery
このオプションを指定すると，コマンドの実行を中断する問い合わせメッセージが出力されなくなり，ユーザーの応答が不要になります。非対話形式で実行したい場合に指定します。
注意事項
-
このコマンドは，実行時にPFM - Managerに対する認証が必要です。認証用のキーファイルを作成していない場合は，コマンドを実行する前に，jpcmkkeyコマンドで認証用のキーファイルを作成してください。各タグの指定値は，各PFM - AgentまたはPFM - RMマニュアルの「パフォーマンスデータの収集の設定」に関する注意に従って設定してください。
-
このコマンドはPFM - Managerおよび対象PFM - Agentのサービスが起動した状態で実行してください。
戻り値
|
0 |
正常終了した。 |
|
1 |
コマンドラインの形式が不正である。 |
|
2 |
コマンドの実行権限がない。 |
|
4 |
コマンドの引数が不正である。 |
|
11 |
PFM - Managerへの認証処理に失敗した。または，jpcmkkeyで作成されたユーザーに実行権限がない。 |
|
80 |
-noquery指定なし時の確認に対して，「Y」または「y」以外を指定して中断させた。 |
|
100 |
Performance Managementの環境が不正である。 |
|
200 |
メモリーが不足している。 |
|
222 |
通信処理でエラーが発生した。 |
|
224 |
エージェントに接続できない。 |
|
225 |
エージェントがない。 |
|
226 |
エージェントがサポート対象外である。 |
|
227 |
接続先PFM - Managerがサポート対象外である。 |
|
228 |
接続先PFM - Managerに対象エージェントがセットアップされていない。 |
|
255 |
予期しないエラーが発生した。 |
使用例
エージェント「TA1hostpfm」に定義されているアプリケーション定義「PFM - Manager」を削除する場合のコマンド実行例を次に示します。
jpcprocdef delete -agent TA1hostpfm -name "PFM - Manager"
出力例
コマンド処理の詳細情報を標準出力，標準エラー出力，稼働状況ログファイルに出力します。ログ仕様については「6. Performance Managementで出力するログ情報」を参照してください。
標準出力の出力例を次に示します。引数で指定したサービスIDの実行結果を表示します（OKまたはERR）。
標準出力の出力例
jpcprocdef delete connected to localhost at yyyy MM dd HH:MM:SS.mmm KAVJK8605-Q エージェントTA1hostpfmのアプリケーション定義"PFM - Manager"を削除してもよろしいですか？[y/n]y delete result OK : TA1hostpfm jpcprocdef delete disconnected at yyyy MM dd HH:MM:SS.mmm