jpcprocdef list
形式
jpcprocdef list -agent サービスID
機能
jpcprocdef listコマンドは，指定したエージェントに定義されているアプリケーション定義名の一覧を表示するコマンドです。jpcprocdef deleteコマンドやjpcprocdef outputコマンドの-name引数に指定するアプリケーション定義名を事前に確認できます。出力する順番はエージェントに定義されている順番です。
コマンドを実行できるホスト
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
注意事項
-
このコマンドは，実行時にPFM - Managerに対する認証が必要です。認証用のキーファイルを作成していない場合は，コマンドを実行する前に，jpcmkkeyコマンドで認証用のキーファイルを作成してください。各タグの指定値は，各PFM - AgentまたはPFM - RMマニュアルの「パフォーマンスデータの収集の設定」に関する注意に従って設定してください。
-
このコマンドはPFM - Managerおよび対象PFM - Agentのサービスが起動した状態で実行してください。
戻り値
|
0 |
正常終了した。 |
|
1 |
コマンドラインの形式が不正である。 |
|
2 |
コマンドの実行権限がない。 |
|
4 |
コマンドの引数が不正である。 |
|
11 |
PFM - Managerへの認証処理に失敗した。または，jpcmkkeyで作成されたユーザーに実行権限がない。 |
|
100 |
Performance Managementの環境が不正である。 |
|
200 |
メモリーが不足している。 |
|
222 |
通信処理でエラーが発生した。 |
|
224 |
エージェントに接続できない。 |
|
225 |
エージェントがない。 |
|
226 |
エージェントがサポート対象外である。 |
|
227 |
接続先PFM - Managerがサポート対象外である。 |
|
228 |
接続先PFM - Managerに対象エージェントがセットアップされていない。 |
|
255 |
予期しないエラーが発生した。 |
使用例
エージェント「TA1hostpfm」に定義されているアプリケーション定義名の一覧を表示する場合のコマンド実行例を次に示します。
jpcprocdef list -agent TA1hostpfm
出力例
コマンド処理の詳細情報を標準出力，標準エラー出力，稼働状況ログファイルに出力します。ログ仕様については「4. Performance Managementで出力するログ情報」を参照してください。
標準出力の出力例を次に示します。
標準出力の出力例
"PFM - Manager" "PFM - Web Console"