jpcconf agttree export
- Organization of this page
Format
Format 1
jpcconf agttree export -owner user-name [-lhost logical-host-name] [-noquery] -f export-file-name
Format 2
jpcconf agttree export -template [-noquery] -f export-file-name
Function
The jpcconf agttree export command exports Agents tree definition information to the specified file as an Agents tree definition information file. This command can also generate the template file for Agents tree definition information files, rather than the Agents tree definition information file that contains the current definition information.
An exported Agents tree definition information file can be specified in the jpcconf agttree import command as an input file.
Hosts that can execute the command
PFM - Manager
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
-owner user-name
Specifies the name of the user whose Agents tree definition information the command will export.
For user-name, 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.
! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
Interpretation of the specified value follows the command line specifications of the OS and shell. You might need to make sure that the character encoding settings are appropriate beforehand, or add escape characters.
-template
Specify this option to output the template file for Agents tree definition files.
-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.
-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.
If the Agents tree definition file specified for the -f option already exists, the file will be overwritten by the new file.
If a file with the same name as the specified file name already exists, a KAVE05399-I message is output and the file is updated.
-f export-file-name
Specifies the name of the Agents tree definition file to be exported. 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.
Format of Agents tree definition files
See Format of Agents tree definition files in the description of the jpcconf agttree import command.
Notes
-
You can execute this command only when the View Server service is running.
-
The value of the LANG environment variable for the shell that is used to execute the command determines the encoding of the Agents tree definition file and the encoding value in the XML declaration part of that file. If the Agents tree information that you want to export includes non-ASCII characters, make sure that the value of the relevant LANG environment variable is appropriate before you execute this command.
The following table describes the encoding of the file and the encoding value in the XML declaration for each value of the LANG environment variable. If the value of the LANG environment variable is not described in the following table, the encoding attribute in the XML declaration will be set to UTF-8, and the file will be encoded with UTF-8.
-
The LANG environment variable in the shell that executed the command and the output character code of the agent hierarchy definition file are sometimes different. In such cases, when editing the exported the agent hierarchy definition file, confirm that the character code matches the encoding value in the definition file before importing the file. If an agent hierarchy definition file whose character code does not match the encoding value in the definition file is imported, the folder name for the agent hierarchy might be garbled. In such cases, correct the agent hierarchy definition file to match the character code and the encoding value in the definition file, and import the file again.
OS
LANG value
Encoding
Value of encoding in XML declaration
Windows
--
UTF-8
UTF-8
Linux
ja_JP.UTF-8
UTF-8
UTF-8
ja_JP.utf8
C
ASCII#
zh_CN.gb18030
GB18030
GB18030
zh_CN.UTF-8
UTF-8
UTF-8
zh.CN.utf8
Solaris
ja_JP.PCK
Shift-JIS
Shift_JIS
ja
EUC
EUC-JP
japanese
C
ASCII#
UTF-8
zh_CN.GB18030
GB18030
GB18030
zh_CN.GB18030@pinyin
zh_CN.GB18030@radical
zh_CN.GB18030@stroke
zh.UTF-8
UTF-8
UTF-8
zh_CN.UTF-8
zh_CN.UTF-8@pinyin
zh_CN.UTF-8@radical
zh_CN.UTF-8@stroke
AIX
Ja_JP.IBM-932
Shift-JIS
Shift_JIS
Ja_JP
ja_JP.IBM-eucJP
EUC
EUC-JP
ja_JP
C
ASCII#
UTF-8
Zh_CN
GB18030
GB18030
Zh_CN.GB18030
ZH_CN
UTF-8
UTF-8
ZH_CN.UTF-8
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
5 |
An attempt was made to execute the command on the PFM - Base host, but the command can only be executed on the PFM - Manager host. |
6 |
The specified user does not exist. |
11 |
Processing was canceled by the user (N was returned as the response to a query). |
100 |
The Performance Management environment is invalid. |
101 |
A service that is prerequisite for executing this command is not running. |
102 |
The specified logical host has not been set up. |
200 |
A memory shortage occurred. |
210 |
A disk space shortage occurred. |
211 |
A file or directory cannot be accessed. |
255 |
An unexpected error occurred. |
Usage example
This example exports the Agents tree definition information for the user pfm-user.
# jpcconf agttree export -owner pfm-user -f agttree_def.xml