JP1/Performance Management リファレンス

jpcconf agttree export

形式1

jpcconf agttree export    -owner ユーザー名
                          [-lhost 論理ホスト名]
                          [-noquery]
                          -f エクスポート先のファイル名

形式2

jpcconf agttree export    -template
                          [-noquery]
                          -f エクスポート先のファイル名

機能

jpcconf agttree exportコマンドは，エージェント階層の定義情報を指定されたファイルにエクスポートするコマンドです。また，現在の定義情報ではなく，テンプレートファイルをエクスポートすることもできます。

エクスポートしたエージェント階層定義ファイルは，jpcconf agttree importコマンドの入力ファイルとして指定できます。

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

PFM - Managerホスト

実行権限

Windowsの場合

Administrators権限を持つユーザー

UNIXの場合

rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合

インストール先フォルダ\tools\

UNIXの場合

/opt/jp1pc/tools/

引数

-owner ユーザー名

ユーザー名に指定したユーザーのエージェント階層の定義情報をエクスポートします。

ユーザー名には，1〜16バイトの半角英数字，半角空白文字，または次に示す記号を指定できます。ただし，英文字の大文字と小文字は区別されません。

! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~

入力値はOSおよびシェルのコマンドラインの仕様に従って解釈されます。必要に応じて，エスケープおよびエンコード処理をした上で指定してください。

-template

エージェント階層定義ファイルのテンプレートファイルを出力します。

-lhost 論理ホスト名

このコマンドを実行するホストの論理ホスト名を指定します。1〜32バイトの半角英数字で指定します。指定を省略した場合，物理ホストが仮定されます。

-noquery

このオプションを指定すると，コマンドの実行を中断する問い合わせメッセージが出力されなくなり，ユーザーの応答が不要になります。非対話形式で実行したい場合に指定します。

-fオプションで指定したエージェント階層定義ファイルがすでにある場合，上書きされます。

なお，指定したファイルと同名のファイルが存在した場合は，KAVE05399-Iメッセージが出力され，ファイルが更新されます。

-f エクスポート先のファイル名

エクスポートするエージェント階層定義ファイルのファイル名を指定します。絶対ファイルパス名，相対ファイルパス名，ファイル名が指定できます。絶対ファイルパス名以外の場合，カレントディレクトリを基点とします。

エージェント階層定義ファイルの形式

コマンド「jpcconf agttree import」の「エージェント階層定義ファイルの形式」の記載個所を参照してください。

注意事項

• View Serverサービスが停止している場合，このコマンドは実行できません。
• エージェント階層定義ファイルの文字コードおよびエージェント階層定義ファイル内のXML宣言部のencodingの値は，コマンドを実行したシェルのLANG環境変数の値に合わせて決定されます。エクスポートするエージェント階層の内容にASCIIコード以外の文字が含まれる場合，このコマンドを実行する前にシェルのLANG環境変数の値を確認してください。
  LANG環境変数の値と，文字コードおよびencodingの値の対応を次の表に示します。なお，次の表に示されていない値がLANG環境変数に指定されている場合，XML宣言中のencodingの値および出力される文字コードはUTF-8になります。
  

  実行OS	LANG環境変数の値	文字コード	XML宣言中のencodingの値
  Windows	−	UTF-8	UTF-8
  Linux	ja_JP.UTF-8	UTF-8	UTF-8
  	ja_JP.utf8
  	C	ASCII※
  HP-UX	ja_JP.SJIS	シフトJIS	Shift_JIS
  	japanese
  	ja_JP.eucJP	EUC	EUC-JP
  	japanese.euc
  	C	ASCII※	UTF-8
  Solaris	ja_JP.PCK	シフトJIS	Shift_JIS
  	ja	EUC	EUC-JP
  	japanese
  	C	ASCII※	UTF-8
  AIX	Ja_JP.IBM-932	シフトJIS	Shift_JIS
  	Ja_JP
  	ja_JP.IBM-eucJP	EUC	EUC-JP
  	ja_JP
  	C	ASCII※	UTF-8

  （凡例）

  −：該当しない

  注※

  エクスポートするエージェント階層の内容にASCIIコード以外の文字が含まれる場合，文字コードはUTF-8になります。

  
  

戻り値

0	正常終了した。
1	引数の指定に誤りがある。
2	コマンドの実行権限がない。
5	PFM - Baseホスト上でPFM - Managerホストだけで実行できるコマンドを実行しようとした。
6	指定されたユーザーが存在しない。
11	ユーザーによって処理が中止された（問い合わせに対して「N」を返した場合）。
100	Performance Managementの環境が不正である。
101	コマンドの実行に必要なサービスが起動していない。
102	指定された論理ホスト名がセットアップされていない。
200	メモリーが不足している。
210	ディスク容量が不足している。
211	ファイルまたはディレクトリにアクセスできない。
255	予期しないエラーが発生した。

使用例

ユーザー「pfm-user」のエージェント階層定義情報を出力する例を次に示します。

# jpcconf agttree export -owner pfm-user -f agttree_def.xml

[目次][前へ][次へ]

All Rights Reserved. Copyright (C) 2009, 2012, Hitachi, Ltd.
(C)opyright 2000-2009, by Object Refinery Limited and Contributors.