jpcalarm list

形式

jpcalarm list    {-key サービスキー
              [-table アラームテーブル名]| -id サービスID}

機能

jpcalarm listコマンドは,アラームテーブルやアラームの定義情報またはバインド情報を表示するコマンドです。

-keyオプションと-tableオプションの指定の組み合わせと,表示される情報の関係を,次の表に示します。

表2-13 オプション指定の組み合わせと,表示される情報の関係

オプションの指定表示される情報
-key-table-id
××-keyオプションで指定したPFM - Agentで定義されているアラームテーブル名の一覧が表示される。個々のアラーム名は表示されない。
×-tableオプションで指定したアラームテーブルに定義されているアラーム名,アラームが有効か無効か,アラームテーブルがバインドされているエージェントの一覧が表示される。
××エージェントがバインドしているアラームテーブルの一覧が表示される。
(凡例)
○:指定あり
×:指定なし

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

PFM - Manager

実行権限

Windowsの場合
Administrators権限を持つユーザー
UNIXの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
インストール先フォルダ¥tools¥
UNIXの場合
/opt/jp1pc/tools/

引数

-key サービスキー

アラーム定義情報を表示したいPFM - Agentのサービスキーを指定します。ここで指定できるサービスキーは,PFM - Agentのサービスキーだけです。PFM - Agentのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。

-table アラームテーブル名

アラーム定義情報を表示するアラームテーブル名を指定します。

1~64バイトの全角文字,半角英数字,半角空白文字,または次に示す半角記号を指定できます。

 % - ( ) _ . / @ [ ]

ただし,半角空白文字を含む場合は「"」(半角引用符)で囲んでください。また,半角記号を指定する場合は,必要に応じてエスケープ表記をしてください。

ワイルドカード文字は使用できません。

-id サービスID

Agent CollectorのサービスIDを指定します。ワイルドカード文字("*"(アスタリスク)および"?"(クエスチョンマーク))は使用できません。指定できる文字数は1~258(単位:バイト)です。指定したサービスIDが存在しない場合は,エラーになります。

注意事項

戻り値

0正常終了した。
1引数の指定に誤りがある。
2コマンドの実行権限がない。
3Name Serverサービス,Master Managerサービス,View Serverサービスのうち,一つ以上のサービスが起動していない。
4同一マシン上で起動停止コマンドまたはほかのセットアップコマンドが実行されている。
5指定されたPFM - Agentがセットアップされていない。
6指定されたアラームテーブルがない。
11ユーザーによって処理が中止された。
100Performance Managementの環境が不正である。
200メモリーが不足している。
222通信処理でエラーが発生した。
223通信処理でタイムアウトが発生した。
255予期しないエラーが発生した。

表示情報

jpcalarm listコマンドを実行して表示される情報を,次の表に示します。

表2-14 jpcalarm listコマンドを実行して表示される情報

項番表示情報オプション指定による
表示の有無
説明
-key-key,-table-id
1Product ID×PFM - Agentの種類を示すプロダクトIDを示す。各PFM - AgentのプロダクトIDについては,各PFM - Agentのマニュアルの,付録に記載されている識別子一覧を参照のこと。
2DataModelVersion××データモデルのバージョンを示す。
3Alarm Table Name×アラームテーブル名を示す。
4Alarm Name××アラーム名およびアラームが有効か無効かを示す。
  • active:アラームが有効であることを示す。
  • inactive:アラームが無効であることを示す。
5The Bound Agent××アラームテーブルがバインドされているエージェントのサービスIDを示す。
6Service ID××サービスIDを示す。
7Bound Alarm Table Name××バインドされているアラームテーブル名を示す。
(凡例)
-key:-keyオプションだけを指定した場合
-key,-table:-keyオプションと-tableオプションの両方を指定した場合
○:表示される
×:表示されない

使用例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