Hitachi

JP1 Version 10　JP1/Performance Management リファレンス

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

  • 1〜1,024の整数

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

-ms 初期ヒープサイズ

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

  • 1〜1,024の整数

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

-o 出力ファイル

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

サービスID

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

  • 4〜258文字

  • 1桁目はエージェントのプロダクトIDを指定します。プロダクトIDについては，各PFM - AgentまたはPFM - RMマニュアルを参照してください。

  • 2桁目は「A」（Agent CollectorまたはRemote Monitor Collector）を指定します。

ページの先頭へ

注意事項

ページの先頭へ

戻り値

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.　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="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>

ページの先頭へ

他社商品名称に関する表示

All Rights Reserved. Copyright (C) 2012, 2013, Hitachi, Ltd.

(C)opyright 2000-2009, by Object Refinery Limited and Contributors.