jpcasrec output

形式

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

機能

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

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

PFM - Web Console

実行権限

Windowsの場合
  • OSのユーザー権限:Administrators権限を持つユーザー
  • Performance Managementのユーザー権限:管理ユーザー権限を持つユーザー
UNIXの場合
  • OSのユーザー権限:rootユーザー権限を持つユーザー
  • Performance Managementのユーザー権限:管理ユーザー権限を持つユーザー

格納先ディレクトリ

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

引数

-mx 最大ヒープサイズ

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

-ms 初期ヒープサイズ

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

-o 出力ファイル

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

サービスID

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

注意事項

戻り値

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

使用例

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

jpcasrec  output  -o asrec_output.xml  TA1host1

出力例

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

標準出力形式を次に示します。引数で指定したサービス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="0100">
<agent-store-db-record-definition>
   <service id="TA1clarysage">
     <record id="PD_DEV">
        <!-- Description : Devices Detail -->
        <log>Yes</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PD_GEND">
        <!-- Description : Generic Data Detail -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PD_PAGF">
        <!-- Description : Page File Detail -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PD">
        <!-- Description : Process Detail -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif>
          <expression>PCT_PROCESSOR_TIME&gt;"80.000"</expression>
        </logif>
     </record>
     <record id="PD_PDI">
        <!-- Description : Process Detail Interval -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif>
          <or>
            <expression>PCT_PROCESSOR_TIME&gt;"80.000"</expression>
            <expression>VIRTUAL_BYTES&gt;"102400.000"</expression>
          </or>
        </logif>
     </record>
     <record id="PD_PEND">
        <!-- Description : Process End Detail -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PD_SVC">
        <!-- Description : Service Process Detail -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PD_ELOG">
        <!-- Description : Event Log -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_BRSR">
        <!-- Description : Browser Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_GENI">
        <!-- Description : Generic Data Interval -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_ICMP">
        <!-- Description : ICMP Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_IP">
        <!-- Description : IP Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_LOGD">
        <!-- Description : Logical Disk Overview -->
        <log>Yes</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_NBT">
        <!-- Description : NBT Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_NETI">
        <!-- Description : Network Interface Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_PCSR">
        <!-- Description : Processor Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_PHYD">
        <!-- Description : Physical Disk Overview -->
        <log>Yes</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI">
        <!-- Description : System Overview -->
        <log>Yes</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_SVRQ">
        <!-- Description : Server Work Queues Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_TCP">
        <!-- Description : TCP Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_UDP">
        <!-- Description : UDP Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_WINS">
        <!-- Description : WINS Server Overview -->
        <log>No</log>
        <collection-interval>60</collection-interval>
        <collection-offset>0</collection-offset>
        <logif> </logif>
     </record>
     <record id="PI_WGRP">
        <!-- Description : Workgroup Summary -->
        <log>Yes</log>
        <!-- Sync Collection With : Detail Records,PD -->
        <logif>
          <expression>PROGRAMS="*jpc*"</expression>
        </logif>
     </record>
   </service>
</agent-store-db-record-definition>
</pr-cli-parameters>