jpcconf agttree import

-nocheck

Specify this option to skip checking whether the agents specified in the Agents tree definition file are recognized by Performance Management. If this option is omitted and an unrecognized agent is detected, the command processing stops.

After agents have been installed and set up, Performance Management recognizes them when they connect to PFM - Manager. Recognized agents are displayed under the Products node in the Agents tree.

Before agents are recognized by Performance Management, their data model version is assumed to be 3.0. The actual data model version will be applied after these agents are recognized.

Performance Management might have not yet recognized all of agents specified in the Agents tree definition file when, for example, the system is being built. In such a case, specify this option.

-noquery

If this option is specified, the command does not output any query messages that interrupt command execution, making it unnecessary for the user to respond. Specify this option if you want the command to run in non-interactive mode.

Note that if the user specified in the Agents tree definition file has already created his or her Agents tree, the tree will be overwritten.

If the Agents tree of the specified user already exists, a KAVE06073-I message is output and the Agents tree is updated.

-lhost logical-host-name

Specifies the logical host name of the host on which this command is executed. For logical-host-name, specify a string of 1 to 32 bytes, consisting of single-byte alphanumeric characters. If this option is omitted, the command will be executed on the physical host.

-f Agents-tree-definition-file-name

Specifies the name of the Agents tree definition file to be imported. The file must be an XML file. The format of this file is described in Format of Agents tree definition files below. You can specify an absolute file path, a relative file path from the current directory, or the name of a file in the current directory.

Example of an Agents tree definition file:

<?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="7A1instBD[tHOST01@host111]"/>
        </folder>
        <folder name="Development Department">
            <agent name="7A1instDD[tHOST02@host111]"/>
            <agent name="7A1instDD[tHOST03@host111]"/>
        </folder>
        <agent name="TA1host111"/>
    </folder>
    <agent name="TA1host999"/>
</tree>

With the above example file, the following Agents tree is created:

Descriptive conventions

The following provides the descriptive conventions for the Agents tree definition file:

• The tree can have a maximum of eight hierarchical levels. In the root level and each folder, you can create a maximum of 64 folders and a maximum of 128 agents.

• Element names and attribute values consisting of only spaces are assumed to be omitted. Any spaces before and after element names and attribute values are ignored.

• If nonprintable characters are used in an element name or attribute value, an error occurs.

• The DOCTYPE declaration in the file is fixed. In the declaration, always specify the name of the DTD file that contains file descriptive definitions. This command supports the following DTD file:

  • agttree_param.dtd

• In XML, a less-than (<) sign and other characters have special meanings. If you use these characters as ordinary characters, you must follow the notations prescribed by the XML specifications.

  For example, to use a less-than sign (<), specify &lt;. To use a greater-than sign (>), specify &gt;.

XML tag specifications

• tree

  Item	Description
  Description	The tree element indicates a top (root) node in an Agents tree.
  Specifiable value	None
  Omissible	No
  Attribute	owner	Specifies the name of the user who owns the Agents tree settings. This attribute is required. You can specify a string of 1 to 16 bytes, consisting of single-byte alphanumeric characters, spaces, and the symbols listed below. Alphabetic characters are not case sensitive. ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
  Parent element	None
  Child element	folder (Multiple instances can be specified.)
  	agent (Multiple instances can be specified.)

• folder

  Item	Description
  Description	The folder element indicates a folder node in an Agents tree.
  Specifiable value	None
  Omissible	Yes
  Attribute	name	Specifies a folder name. This attribute is required. The name can have 1 to 64 double-byte and/or single-byte characters.
  Parent element	tree, folder
  Child element	folder (Multiple instances can be specified.)
  	agent (Multiple instances can be specified.)

• agent

  Item	Description
  Description	The agent element indicates an agent node in an Agents tree.
  Specifiable value	None
  Omissible	Yes
  Attribute	name	Specifies a service ID as an agent name. This attribute is required. The value of this attribute must be 1 to 258 bytes long. For the product ID part, specify the product ID of PFM - Agent or PFM - RM. For the function ID part, specify A.
  Parent element	tree, folder
  Child element	None