jpcasrec output

〈このページの構成〉

形式
機能
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
注意事項
戻り値
使用例
出力例
出力ファイル

形式

jpcasrec output    [-mx 最大ヒープサイズ]
                   [-ms 初期ヒープサイズ]
                   -o 出力ファイル名
                   サービスID

ページの先頭へ

機能

jpcasrec outputコマンドは，Storeデータベースの記録方法に関する定義情報をXML形式で出力するコマンドです。出力ファイルは，jpcasrec updateコマンドの入力ファイルとして指定できます。

ページの先頭へ

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

PFM - Web Console

ページの先頭へ

実行権限

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

また，コマンドを実行するためには，事前にPerformance Managementに対する管理ユーザー権限^※のユーザーアカウントで認証用のキーファイルを作成する必要があります。詳細については，「jpcmkkey」コマンドを参照してください。

注※: Performance ManagementユーザーまたはJP1ユーザーが必要とする，Performance Managementに対する実行権限です。

ページの先頭へ

格納先ディレクトリ

Windowsの場合: インストール先フォルダ\tools\
UNIXの場合: /opt/jp1pcwebcon/tools/

ページの先頭へ

引数

-mx 最大ヒープサイズ

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

1〜2,048の整数
「-mxの指定値 >= -msの指定値」

-ms 初期ヒープサイズ

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

1〜2,048の整数
「-mxの指定値 >= -msの指定値」

-o 出力ファイル名

表示結果を出力するXML形式ファイルの名称を指定します。絶対ファイルパス名，相対ファイルパス名，ファイル名を指定でき，絶対ファイルパス名以外の場合，カレントディレクトリを基点とします。指定されたディレクトリがない場合は，エラーになります。

サービスID

表示対象エージェントを示すサービスIDを指定します。ワイルドカード文字は使用できません。指定値の条件を次に示します。

4〜258文字
1桁目はエージェントのプロダクトIDを指定します。プロダクトIDについては，各PFM - AgentまたはPFM - RMマニュアルを参照してください。
2桁目は「A」（Agent CollectorまたはRemote Monitor Collector）を指定します。

ページの先頭へ

注意事項

このコマンドは，実行時にPFM - Managerに対する認証が必要です。認証用のキーファイルを作成していない場合は，コマンドを実行する前に，jpcmkkeyコマンドで認証用のキーファイルを作成してください。サービスID，レコードIDの指定範囲については，各PFM - AgentまたはPFM - RMマニュアルを参照してください。
更新できない定義情報は，出力ファイルにコメントとして出力されます。
通常，-mxオプションおよび-msオプションを設定する必要はありません。コマンド実行時に，メモリー不足を示すKAVJK0401-Eメッセージが出力された場合は，-mxオプションの最大ヒープサイズに64以上を指定して，再度実行してください。

ページの先頭へ

戻り値

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

ページの先頭へ

使用例

サービスID「TA1host1」のPFM - AgentのStoreデータベースの記録方法に関する定義情報をパラメーターファイル（asrec_output.xml）に出力する場合のコマンド実行例を次に示します。

jpcasrec  output  -o asrec_output.xml  TA1host1

ページの先頭へ

出力例

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

標準出力形式を次に示します。引数で指定したサービスIDの実行結果を表示します（OKまたはERR）。

標準出力の出力例

jpcasrec output connected to hostname at yyyy MM dd HH:MM:SS.mmm
output result  OK  : TA1host1
jpcasrec output disconnected at yyyy MM dd HH:MM:SS.mmm

ページの先頭へ

出力ファイル

このコマンドの出力ファイル例を次に示します。

出力ファイル例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pr-cli-parameters SYSTEM "asrec_params.dtd">
<pr-cli-parameters ver="0110">
<agent-store-db-record-definition>
    <service id="TA1host1">
        <record id="PD_CIND">
            <!-- Description : Content Index Detail -->
            <log>Yes</log>
            <collection-interval>600</collection-interval>
            <collection-offset>0</collection-offset>
            <!--Over 10 Sec Collection Time : No -->
            <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode>
            <logif></logif>
              <and>
                <or>
                  <expression>RECORD_TIME&lt;"01:23:45"</expression>
                  <expression>INTERVAL&lt;"2000"</expression>
                </or>
                <expression>INSTANCE&lt;"INST"</expression>
              </and>
            </logif>
        </record>
        <record id="PD_CINF">
            <!-- Description : Content Index Filter Detail -->
            <log>No</log>
            <collection-interval>60</collection-interval>
            <collection-offset>0</collection-offset>
            <!--Over 10 Sec Collection Time : Yes -->
            <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode>
            <logif> </logif>
        </record>
        <record id="PD_DEV">
            <!-- Description : Devices Detail -->
            <log>Yes</log>
            <collection-interval>480</collection-interval>
            <collection-offset>60</collection-offset>
            <!--Over 10 Sec Collection Time : No -->
            <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode>
            <logif> </logif>
        </record>
　　      ：
　　      ：
　　      ：
    </service>
</agent-store-db-record-definition>
</pr-cli-parameters>

ページの先頭へ