JP1/Performance Management リファレンス

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

jpcrdef delete

形式

jpcrdef delete     ［-y］
                   ［-mx 最大ヒープサイズ］
                   ［-ms 初期ヒープサイズ］
                   入力ファイル

機能

jpcrdef deleteコマンドは，PFM - Managerに接続し，レポート定義を削除するコマンドです。レポート定義ディレクトリを指定すると下位のレポート定義およびレポート定義ディレクトリを含めて削除します。削除対象のレポート定義とレポート定義ディレクトリは，コマンドライン引数として指定されたXML形式のパラメーターファイルから取得します。一つのパラメーターファイルに，複数のレポート定義またはレポート定義ディレクトリを指定し，一括して削除できます。

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

PFM - Web Console

実行権限

Windowsの場合
  • OSのユーザー権限：Administrators権限を持つユーザー
  • Performance Managementのユーザー権限：一般ユーザー権限，または管理ユーザー権限を持つユーザー

UNIXの場合
  • OSのユーザー権限：rootユーザー権限を持つユーザー
  • Performance Managementのユーザー権限：一般ユーザー権限，または管理ユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
インストール先フォルダ\tools\

UNIXの場合
/opt/jp1pcwebcon/tools/

引数

-y

このオプションを指定した場合は，削除確認メッセージを出力しません。省略した場合は，<report-definition>ごとに削除確認メッセージを出力します。削除確認メッセージに対して，「y」または「Y」で応答すると削除します。それ以外の値で応答すると，削除はしないで次の<report-definition>の削除確認メッセージを出力します。

-mx 最大ヒープサイズ

java.exeの最大ヒープサイズをMB単位で指定します。デフォルトは，64MBです。実際に取得できる最大サイズは，システムに依存します。指定する値が次の条件を満たさない場合は，コマンドライン形式不正となります。指定値の条件を次に示します。

-ms 初期ヒープサイズ

java.exeの初期ヒープサイズをMB単位で指定します。デフォルトは，32MBです。指定する値が次の条件を満たさない場合は，コマンドライン形式不正となります。指定値の条件を次に示します。

入力ファイル

レポート定義を削除するためのXML形式のパラメーターファイルを指定します。このパラメーターファイルは，後述の「パラメーターファイルの形式」に基づいて作成されたファイルです。絶対ファイルパス名，相対ファイルパス名，ファイル名が指定でき，絶対ファイルパス名以外の場合，カレントディレクトリを基点とします。

パラメーターファイルの形式

XMLタグ仕様

パラメーターファイルの記述例を次に示します。

パラメーターファイル記述例

 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pr-cli-parameters SYSTEM "rdef_delete_params.dtd">
<pr-cli-parameters ver="0100">
  <report-definitions>
   <report-definition name="Workload Status (Multi-Agent)"
             parent-folder="/"/>
   <report-definition name="daily report"
             parent-folder="/UserReport"
                 read-only="FALSE"/>
   <report-definition name="" parent-folder="/report1"/>
  </report-definitions>
</pr-cli-parameters>

パラメーターの記述を定義するDTDファイル（rdef_delete_params.dtd）を次に示します。

パラメーターの記述を定義するDTDファイル（rdef_delete_params.dtd）

 
<!ENTITY     % BOOL_VALUE     "(true|false|TRUE|FALSE)">
<!ELEMENT pr-cli-parameters    (report-definitions)>
<!ATTLIST pr-cli-parameters
          ver                  (0100)                 #REQUIRED>
<!ELEMENT report-definitions   (report-definition+)>
<!ELEMENT report-definition    ANY>
<!ATTLIST report-definition
          name                 CDATA                  #IMPLIED
          parent-folder        CDATA                  #REQUIRED
          id                   CDATA                  #IMPLIED
          read-only            %BOOL_VALUE;           "FALSE">

注意事項

戻り値

0 正常終了した。
1 コマンドラインの形式が不正である。
2 コマンドの実行権限がない。
3 出力ファイルの作成に失敗した。
5 DTDファイルと不整合のためパラメーターが解析できない。
10 1件以上のレポート定義作成に失敗した。
11 PFM - Managerへの認証処理に失敗した。
100 環境が不正である。
200 メモリーエラーが発生した。
202 ファイルアクセスエラーが発生した。
222 通信処理でエラーが発生した。
255 予期しないエラーが発生した。

使用例1

パラメーターファイル（rdef_del.xml）に記述したレポート定義を削除する場合のコマンド実行例を次に示します。

 
jpcrdef  delete  -y  rdef_del.xml

使用例2

パラメーターファイル（rdef_del02.xml）に記述したレポート定義を確認しながら削除する場合のコマンド実行例を次に示します。

 
jpcrdef  delete  rdef_del02.xml

出力例

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

10のレポート定義と五つのレポート定義ディレクトリを指定し，三つのレポート定義がエラーとなった場合の標準出力形式を次に示します。

標準出力の出力例

 
jpcrdef delete connected to vserv01 at 2006 03 20 15:00:55.282
delete result OK  : レポート定義ディレクトリパス1/レポート定義名11
delete result OK  : レポート定義ディレクトリパス2/レポート定義名21
delete result ERR : レポート定義ディレクトリパス3
          Skipped : レポート定義ディレクトリパス3/レポート定義名31
エラー要因
              OK  : レポート定義ディレクトリパス3/レポート定義名32
          Skipped : レポート定義ディレクトリパス3/レポート定義名33
エラー要因
              OK  : レポート定義ディレクトリパス3/レポート定義名34
              OK  : レポート定義ディレクトリパス3/レポート定義名35
delete result ERR : レポート定義ディレクトリパス4/レポート定義名41
エラー要因
delete result OK  : レポート定義ディレクトリパス5
              OK  : レポート定義ディレクトリパス5/レポート定義名51
              OK  : レポート定義ディレクトリパス5/レポート定義名52
jpcrdef delete disconnected at 2006 03 20 15:01:06.2

上記例では，レポート定義ディレクトリパス3のレポート定義ディレクトリパス3/レポート定義名31およびレポート定義ディレクトリパス3/レポート定義名33が削除できなかったため，レポート定義ディレクトリパス3，レポート定義ディレクトリパス3/レポート定義名31，レポート定義ディレクトリパス3/レポート定義名33は残っていることを示します。レポート定義ディレクトリパス4/レポート定義名41も残っていることを示します。

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

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

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.