形式
jpcalarm list {-key サービスキー
[-table アラームテーブル名]| -id サービスID}
機能
jpcalarm listコマンドは,アラームテーブルやアラームの定義情報またはバインド情報を表示するコマンドです。
-keyオプションと-tableオプションの指定の組み合わせと,表示される情報の関係を,次の表に示します。
表2-13 オプション指定の組み合わせと,表示される情報の関係
オプションの指定 | 表示される情報 | ||
---|---|---|---|
-key | -table | -id | |
○ | × | × | -keyオプションで指定したPFM - Agentで定義されているアラームテーブル名の一覧が表示される。個々のアラーム名は表示されない。 |
○ | ○ | × | -tableオプションで指定したアラームテーブルに定義されているアラーム名,アラームが有効か無効か,アラームテーブルがバインドされているエージェントの一覧が表示される。 |
× | × | ○ | エージェントがバインドしているアラームテーブルの一覧が表示される。 |
コマンドを実行できるホスト
PFM - Manager
実行権限
格納先ディレクトリ
引数
-key サービスキー
アラーム定義情報を表示したいPFM - Agentのサービスキーを指定します。ここで指定できるサービスキーは,PFM - Agentのサービスキーだけです。PFM - Agentのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
-table アラームテーブル名
アラーム定義情報を表示するアラームテーブル名を指定します。
1~64バイトの全角文字,半角英数字,半角空白文字,または次に示す半角記号を指定できます。
% - ( ) _ . / @ [ ]
ただし,半角空白文字を含む場合は「"」(半角引用符)で囲んでください。また,半角記号を指定する場合は,必要に応じてエスケープ表記をしてください。
ワイルドカード文字は使用できません。
-id サービスID
Agent CollectorのサービスIDを指定します。ワイルドカード文字("*"(アスタリスク)および"?"(クエスチョンマーク))は使用できません。指定できる文字数は1~258(単位:バイト)です。指定したサービスIDが存在しない場合は,エラーになります。
注意事項
戻り値
0 | 正常終了した。 |
1 | 引数の指定に誤りがある。 |
2 | コマンドの実行権限がない。 |
3 | Name Serverサービス,Master Managerサービス,View Serverサービスのうち,一つ以上のサービスが起動していない。 |
4 | 同一マシン上で起動停止コマンドまたはほかのセットアップコマンドが実行されている。 |
5 | 指定されたPFM - Agentがセットアップされていない。 |
6 | 指定されたアラームテーブルがない。 |
11 | ユーザーによって処理が中止された。 |
100 | Performance Managementの環境が不正である。 |
200 | メモリーが不足している。 |
222 | 通信処理でエラーが発生した。 |
223 | 通信処理でタイムアウトが発生した。 |
255 | 予期しないエラーが発生した。 |
表示情報
jpcalarm listコマンドを実行して表示される情報を,次の表に示します。
表2-14 jpcalarm listコマンドを実行して表示される情報
項番 | 表示情報 | オプション指定による 表示の有無 | 説明 | ||
---|---|---|---|---|---|
-key | -key,-table | -id | |||
1 | Product ID | ○ | ○ | × | PFM - Agentの種類を示すプロダクトIDを示す。各PFM - AgentのプロダクトIDについては,各PFM - Agentのマニュアルの,付録に記載されている識別子一覧を参照のこと。 |
2 | DataModelVersion | × | ○ | × | データモデルのバージョンを示す。 |
3 | Alarm Table Name | ○ | ○ | × | アラームテーブル名を示す。 |
4 | Alarm Name | × | ○ | × | アラーム名およびアラームが有効か無効かを示す。
|
5 | The Bound Agent | × | ○ | × | アラームテーブルがバインドされているエージェントのサービスIDを示す。 |
6 | Service ID | × | × | ○ | サービスIDを示す。 |
7 | Bound Alarm Table Name | × | × | ○ | バインドされているアラームテーブル名を示す。 |
使用例1
PFM - Agent for Platform(UNIX)で,ソリューションセット以外のアラームテーブルalarmtable1が定義されていると仮定します。
このとき,PFM - Agent for Platform(UNIX)で定義されているアラームテーブルの一覧を表示する場合のコマンド実行例を次に示します。
jpcalarm list -key agtu
出力結果1
Product ID:U
Alarm Table Name:
alarmtable1
PFM UNIX Solution Alarms 7.50
PFM UNIX Solution Alarms 8.00
使用例2
PFM - Agent for Platform(UNIX)で,ソリューションセットPFM UNIX Solution Alarms 8.00がホストhostAとホストhostBにバインドされていると仮定します。
このとき,PFM - Agent for Platform(UNIX)のソリューションセットPFM UNIX Solution Alarms 8.00に定義されているアラームの一覧およびバインドされているエージェントの一覧を表示する場合のコマンド実行例を次に示します。
jpcalarm list -key agtu -table "PFM UNIX Solution Alarms 8.00"
出力結果2
Product ID:U
DataModelVersion:6.0
Alarm Table Name:PFM UNIX Solution Alarms 8.00
Alarm Name:
Disk Service Time [active]
I/O Wait Time [active]
Kernel CPU [active]
Pagescans [active]
Run Queue [active]
Swap Outs [active]
User CPU [active]
The Bound Agent:
UA1hostA
UA1hostB
使用例3
PFM - Agent for Platform(UNIX)で,ソリューションセットPFM UNIX Solution Alarms 6.70とユーザー定義のアラームテーブルalarmtable1がホストhostAにバインドされていると仮定します。
このとき,hostAにバインドされているアラームテーブルの一覧を表示する場合のコマンド実行例を次に示します。
jpcalarm list -id UA1hostA
出力結果3
Service ID:UA1hostA
Bound Alarm Table Name:
alarmtable1
PFM UNIX Solution Alarms 6.70