JP1/Performance Management リファレンス

[目次][索引][前へ][次へ]

jpcprocdef delete

形式

jpcprocdef delete     -agent サービスID
                      {-name アプリケーション定義名
                      [-name アプリケーション定義名]・・・ | -all}
                      [-noquery]

機能

jpcprocdef deleteコマンドは，指定したエージェントに定義されているアプリケーション定義を削除するコマンドです。

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

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は指定できません。

-name アプリケーション定義名

-agentオプションで指定したエージェントに定義されているアプリケーション定義のうち，削除したい定義の名称を指定します。ワイルドカード文字は使用できません。

複数のアプリケーション定義を削除する場合は，-nameオプションを複数回続けて指定します。-nameオプションで指定したアプリケーション定義がエージェントに定義されていない場合は無視されます。

-all

-agentオプションで指定したエージェントに定義されているアプリケーション定義の定義情報をすべて削除します。

-noquery

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

注意事項

戻り値

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"

出力例

コマンド処理の詳細情報を標準出力，標準エラー出力，稼働状況ログファイルに出力します。ログ仕様については「3.　ログ情報」を参照してください。

標準出力の出力例を次に示します。引数で指定したサービス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

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

[他社商品名称に関する表示]

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