Tuning Manager Software ユーザーズガイド

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


12.2.2 jpcrdef delete

形式

jpcrdef delete     [-y]
                   <入力ファイル>

機能

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

実行権限

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

SolarisおよびLinuxの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
<Tuning Manager serverのインストール先フォルダ>\PerformanceReporter\tools\

Solarisの場合
/opt/HiCommand/TuningManager/PerformanceReporter/tools/

Linuxの場合
<Tuning Manager serverのインストール先ディレクトリ>/PerformanceReporter/tools/

オプション

jpcrdef deleteコマンド引数のオプションを次の表に示します。

表12-48 jpcrdef deleteコマンド引数のオプション

オプション 必須
任意
目的 備考
-y 任意 このオプションを指定した場合は,削除確認メッセージを出力しません。省略した場合は,<report-definition>ごとに削除確認メッセージを出力します。削除確認メッセージに対して,「y」または「Y」で応答すると削除します。それ以外の値で応答すると,削除はしないで次の<report-definition>の削除確認メッセージを出力します。 なし
<入力ファイル> 必須 レポート定義を削除するためのXML形式のパラメーターファイルを指定します。このパラメーターファイルは,後述の「パラメーターファイルの形式」に基づいて作成されたファイルです。絶対ファイルパス名,相対ファイルパス名,ファイル名が指定でき,絶対ファイルパス名以外の場合,カレントディレクトリを基点とします。 なし

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

XMLタグ仕様

表12-49 report-definitions

種別 説明
意味 レポート定義情報のルートタグ
指定可能値 なし
省略 不可
属性 なし
親要素 pr-cli-parameters
子要素 report-definition

表12-50 report-definition

種別 説明
意味 1つのレポート定義を指定します。
指定可能値 なし
省略 不可
属性 name 1~64文字(バイトではない)の全角文字または半角文字でレポート定義名を指定します。レポート定義名に「\」か「/」を含む場合,それぞれ「\\」「\/」と記述します。全角文字と半角文字が混在できます。name属性を省略するとparent-folderに指定したレポート定義ディレクトリを下位層含めて削除します。レポート定義名の前後に半角空白を指定すると,前後の半角空白を除いた名称で登録されます。
parent-folder name属性のレポート定義が存在するディレクトリ名を指定します。1~64文字(バイトではない)の全角文字または半角文字のディレクトリ名をルートディレクトリから「/」で区切って指定します。name属性を省略すると,レポート定義ディレクトリを下位層含めて削除します。全角文字と半角文字の混在はできます。パスの場合は,上位レベルのディレクトリ名から順に半角「/」で区切って指定します。ディレクトリ名に「\」か「/」を含む場合,それぞれ「\\」「\/」と記述します。ディレクトリ名の前後に半角空白を指定するとエラーになります。属性を省略するとエラーとなります。
id 指定しても無視します。
read-only 「TRUE」の場合は,レポート定義の削除を中断して,次のreport-definition要素を処理します。省略または「FALSE」の場合は,レポート定義を削除します。
親要素 report-definitions
子要素 product 指定しても無視します。
report-type
record
indication-settings
view-type
drilldown

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

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

<?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="/MyReport"/>
   <report-definition name="daily report"
             parent-folder="/MyReport"
                 read-only="FALSE"/>
   <report-definition name="" parent-folder="/MyReport/report1"/>
  </report-definitions>
</pr-cli-parameters>

パラメーターの記述を定義する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 コマンドを実行したOSユーザーに実行権限がありません。
3 出力ファイルの作成に失敗しました。
5 DTDファイルと不整合のためパラメーターを解析できません。
10 1件以上のレポート定義作成に失敗しました。
100 環境が不正です。
200 メモリーエラーが発生しました。
202 ファイルアクセスエラーが発生しました。
222 通信処理でエラーが発生しました。
255 予期しないエラーが発生しました。

使用例1

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

jpcrdef  delete  -y  rdef_del.xml

使用例2

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

jpcrdef  delete  rdef_del02.xml

出力例

コマンド処理の詳細情報を標準出力,標準エラー出力,トレースログファイルに出力します。ログ仕様については,マニュアル「Hitachi Command Suite Tuning Manager Software 運用管理ガイド」を参照してください。

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

標準出力の出力例

jpcrdef delete connected to vserv01 at 2003 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 2003 03 20 15:01:06.2

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

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


All Rights Reserved. Copyright© 2010, 2014, Hitachi, Ltd.