jpcrdef output

-o 出力ファイル名

出力先のファイルをオプションのあとに指定します。指定しないと，エラーになります。絶対ファイルパス名，相対ファイルパス名，ファイル名を指定でき，絶対ファイルパス名以外の場合，カレントディレクトリを基点とします。既存のファイルを指定すると上書きします。指定されたディレクトリがない場合は，エラーとなります。

-mx 最大ヒープサイズ

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

• 1〜2,048の整数

• 「-mxの指定値 >= -msの指定値」

-ms 初期ヒープサイズ

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

• 1〜2,048の整数

• 「-mxの指定値 >= -msの指定値」

-dateformat 日付フォーマットのパターン名

指定したパターン名に対応する日付フォーマットで，出力ファイルの<expression>タグに記述した日付の形式を決定します。指定できる日付フォーマットのパターン名を次に示します。

• pattern-ddMMyyyy

• pattern-MMddyyyy

• pattern-yyyyMMdd

-dateseparator 日付フォーマットのセパレーター名

指定したセパレーター名に対応するセパレーター文字列で，出力ファイルの<expression>タグに記述したセパレーターの形式を決定します。指定できる日付フォーマットのセパレーター名を次に示します。

• space

• slash

• hyphen

• period

入力ファイル名

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

-parentオプションと同時に指定できません。

-parent レポート定義ディレクトリ

出力対象のレポート定義が存在するディレクトリを，次の記述規則に従って指定します。

• 1〜64文字（バイトではない）の全角文字または半角文字のディレクトリパスを，ルートディレクトリから「/」で区切って指定する。

• 空白文字を含む場合は，「"」（ダブルクォーテーション）で囲む。

• ディレクトリ名に半角の「\」または「/」を含む場合，それぞれ「\\」，「\/」と記述する。

• 全角と半角文字とは混在できる。

• ディレクトリパスを区切る「/」の前後に半角空白を指定するとエラーになる。

• 入力ファイル名オプションと同時に指定するとエラーになる。

-name レポート定義名

出力対象のレポートの定義名を，次の記述規則に従って指定します。

• 1〜64文字（バイトではない）の全角文字または半角文字のレポート定義名を指定する。

• 空白文字を含む場合は，「"」（ダブルクォーテーション）で囲む。

• レポート定義名に半角の「\」または「/」を含む場合，それぞれ「\¥」，「\/」と記述する。

• 全角と半角文字とは混在できる。

• レポート定義名の前後に指定した半角空白は削除する。

• 入力ファイル名オプションと同時に指定するとエラーになる。

• -parentオプションと同時に指定する必要がある。

• -nameオプションを省略すると，-parentオプションに指定したレポート定義ディレクトリに含まれるすべてのレポート定義を，下位層含めて１つのファイルに出力する。

XMLタグ仕様

パラメーターファイルの記述例を次に示します。なお，パラメーターファイルのサンプルを下記ディレクトリに格納しています。パラメーターファイルを記述するときのひな形として利用してください。

Windowsの場合：

インストール先のディレクトリ\sample\conf\

UNIXの場合：

/opt/jp1pcwebcon/sample/conf/

• report-definitions

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

• report-definition

  種別	説明
  意味	1つのレポート定義を指定する。
  指定可能値	なし
  省略	不可
  属性	name	1〜64文字（バイトではない）の全角文字または半角文字でレポート定義名を指定する。レポート定義名に「\」か「/」を含む場合，それぞれ「\\」「\/」と記述する。全角と半角文字が混在できる。省略するとparent-folder属性に指定したレポート定義ディレクトリに含まれるすべてのレポート定義を下位層含めて1つのファイルに出力する。レポート定義名の前後に半角空白を指定すると，前後の半角空白を除いた名称で登録される。
  	parent-folder	name属性のレポート定義があるディレクトリ名を指定する。1〜64文字（バイトではない）の全角文字または半角文字のディレクトリ名をルートディレクトリから「/」で区切って指定する。parent-folder属性を指定した場合，name属性を省略するとレポート定義ディレクトリに含まれるすべてのレポート定義を下位層含めて1つのファイルに出力する。全角と半角文字が混在できる。パスの場合，上位レベルのディレクトリから順に半角「/」で区切って指定する。ディレクトリ名に「\」か「/」を含む場合，それぞれ「\\」「\/」と記述する。ディレクトリ名の前後に半角空白を指定するとエラーになります。省略できない。 例えば，ルートディレクトリ「User Reports」の配下にあるレポート定義名「PD define」のレポート定義をファイルに出力する場合，次のように指定する。 <report-definition name="PD define" parent-folder="/"/> また，ルートディレクトリ「User Reports」配下のディレクトリ「Dir1」内のディレクトリ「Dir2」にある，すべてのレポート定義をファイルに出力する場合，次のように指定する。 <report-definition parent-folder="/Dir1/Dir2"/>
  	id	入力ファイルに指定しても無視される。レポート定義（ディレクトリ出力の場合は，ディレクトリ）の識別子を出力する。
  	read-only	入力ファイルに指定しても無視される。システム定義の場合は，「true」を出力する。それ以外の場合は，「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_output_params.dtd">
<pr-cli-parameters ver="0100">
   <report-definitions>
      <report-definition name="Workload Status (Multi-Agent)"
                parent-folder="/"/>
      <report-definition name="CPU Usage Top 10 Processes"
                parent-folder="/" read-only="FALSE"/>
      <report-definition parent-folder="/Windows/Operating System"/>
   </report-definitions>
</pr-cli-parameters>

標準出力の出力例

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