JP1/Performance Management リファレンス
形式
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です。実際に取得できる最大サイズは,システムに依存します。指定する値が次の条件を満たさない場合は,コマンドライン形式不正となります。指定値の条件を次に示します。
- 1〜1,024の整数
- 「-mxの指定値 >= -msの指定値」
-ms 初期ヒープサイズ
java.exeの初期ヒープサイズをMB単位で指定します。デフォルトは,32MBです。指定する値が次の条件を満たさない場合は,コマンドライン形式不正となります。指定値の条件を次に示します。
- 1〜1,024の整数
- 「-mxの指定値 >= -msの指定値」
-o 出力ファイル
表示結果を出力するXML形式ファイルの名称を指定します。絶対ファイルパス名,相対ファイルパス名,ファイル名を指定でき,絶対ファイルパス名以外の場合,カレントディレクトリを基点とします。指定されたディレクトリが存在しない場合は,エラーになります。
サービスID
表示対象エージェントを示すサービスIDを指定します。ワイルドカード文字は使用できません。指定値の条件を次に示します。
- 4〜258文字
- 1けた目はエージェントのプロダクトIDを指定します。プロダクトIDについては,各PFM - Agentマニュアルを参照してください。
- 2けた目は「A」(Agent Collector)を指定します。
注意事項
- このコマンドは,実行時にPFM - Managerに対する認証が必要です。認証用のキーファイルを作成していない場合は,コマンドを実行する前に,jpcmkkeyコマンドで認証用のキーファイルを作成してください。サービスID,レコードIDの指定範囲については,各PFM - Agentのマニュアルを参照してください。
- 更新できない定義情報は,出力ファイルにコメントとして出力されます。
戻り値
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
出力例
コマンド処理の詳細情報を標準出力,標準エラー出力,トレースログファイルに出力します。ログ仕様については「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>"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>"80.000"</expression> <expression>VIRTUAL_BYTES>"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>
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.