jpcconf agttree import

-nocheck

エージェント階層定義ファイルで指定したエージェントが，Performance Managementに認識されているかを確認しない場合に指定します。指定を省略した場合，認識されていないエージェントが検出されたときには処理が中断されます。

エージェントは，インストールやセットアップのあと，PFM - Managerに接続した時点で認識されます。エージェントが認識されているかは，［エージェント階層］画面の「Products」にあるかどうかで確認できます。

Performance Managementに認識されていないエージェントは，データモデルバージョンに3.0が仮定されます。実際のデータモデルバージョンは，エージェントの認識後に反映されます。

システムの構築時など，まだPerformance Managementに認識されていないエージェントをエージェント階層定義ファイルに指定している場合は，このオプションを指定してください。

-noquery

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

エージェント階層定義ファイルで指定したユーザーが，すでにエージェント階層を作成している場合，そのエージェント階層は上書きされます。

なお，指定したユーザーのエージェント階層がある場合は，KAVE06073-Iメッセージが出力され，エージェント階層が更新されます。

-lhost 論理ホスト名

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

-f エージェント階層定義ファイル名

インポートするエージェント階層定義ファイルのファイル名を指定します。入力ファイルは，XML形式のファイルです。このファイルは，後述の「エージェント階層定義ファイルの形式」に基づいて作成します。絶対ファイルパス名，相対ファイルパス名，ファイル名が指定できます。絶対ファイルパス名以外の場合，カレントディレクトリを基点とします。

エージェント階層定義ファイル記述例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tree SYSTEM "agttree_param.dtd">
 
<tree owner="pfm-user">
    <folder name="Test Company">
        <folder name="Business Department">
            <agent name="7A1inst_BD[tHOST_01@host_111]"/>
        </folder>
        <folder name="Development Department">
            <agent name="7A1inst_DD[tHOST_02@host_111]"/>
            <agent name="7A1inst_DD[tHOST_03@host_111]"/>
        </folder>
        <agent name="TA1host_111"/>
    </folder>
    <agent name="TA1host_999"/>
</tree>

この場合，次に示す構成でエージェント階層が作成されます。

ファイルの記述方式

エージェント階層定義ファイルの記述方式を次に示します。

• 階層数の上限は，8階層です。また，ルートまたはフォルダ内の各要素数の上限は，フォルダが64フォルダ，エージェントが128エージェントです。

• 空白だけの要素値または属性値については，省略と見なします。また，要素値，属性値の前後に指定した半角空白は，無視します。

• 印字文字以外の文字を要素または属性に指定するとエラーとなります。

• ファイル内のDOCTYPE宣言は固定です。DOCTYPE宣言には，ファイルの記述を定義するDTDファイル名を必ず指定してください。このコマンドがサポートするDTDファイルは次のとおりです。

  • agttree_param.dtd

• 「<」などXML形式の書式制御文字を値に含める場合，XML仕様が定める記法に従って記述する必要があります。

  例えば，「<」の場合は「&lt;」，「>」の場合は「&gt;」と記述します。

XMLタグ仕様

• tree

  種別	説明
  意味	エージェント階層の最上位（ルート）ノードを表す要素。
  指定可能値	なし
  省略	不可
  属性	owner	エージェント階層の設定を保持するユーザー名を指定する。省略できない。 1〜16バイトの半角英数字，半角空白文字，または次に示す記号を指定できる。ただし，英文字の大文字と小文字は区別されない。 ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
  親要素	なし
  子要素	folder（複数指定できる）
  	agent（複数指定できる）

• folder

  種別	説明
  意味	エージェント階層のフォルダノードを表す要素。
  指定可能値	なし
  省略	可
  属性	name	フォルダ名を指定する。省略できない。 1〜64文字の全角および半角文字を指定できる。
  親要素	tree，folder
  子要素	folder（複数指定できる）
  	agent（複数指定できる）

• agent

  種別	説明
  意味	エージェント階層のエージェントノードを現す要素。
  指定可能値	なし
  省略	可
  属性	name	エージェント名をサービスIDの形式で指定する。省略できない。1〜258バイトの長さで指定する。 プロダクトID部分にはPFM - AgentまたはPFM - RMのプロダクトIDを指定する。また，機能ID部分には「A」を指定する。
  親要素	tree，folder
  子要素	なし