jcfimport
- Organization of this page
Function
This command imports IM Configuration Management information.
You cannot use this command unless IM Configuration Management Service is running. Note that this command cannot be executed during remote monitoring. In addition, a maximum of five commands can be executed concurrently.
Executing this command deletes three types of information (host, system hierarchy (IM configuration), and profile) that have been managed by IM Configuration Management before import processing. Thereafter, the information specified by options is imported.
To perform remote monitoring after the import, open the System Common Settings window from the IM Configuration Management - View, review the settings, and then click the OK button.
Format
jcfimport [-h logical-host-name] -i directory-name [-m | -r | -c | -g | -a]
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In UNIX: Superuser permissions
Storage directory
- In Windows:
-
Manager-path\bin\imcf\
- In UNIX:
-
/opt/jp1imm/bin/imcf/
Arguments
- -h logical-host-name
-
When you are operating in a cluster system, this option specifies the logical host name of the host that executes the command. If this option is omitted, the command assumes the logical host name specified in the JP1_HOSTNAME environment variable. If the JP1_HOSTNAME environment variable is not specified, the command assumes the physical host name. If you do not use a cluster system, there is no need to specify this option.
- -i directory-name
-
Specifies the name of the directory to which files were exported by the jcfexport command, expressed as an absolute path or a path relative to the location where the jcfimport command is executed. This option is mandatory.
- -m
-
Specifies that only the host information is to be imported. This option cannot be specified together with the -c, -r, -g, or -a option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.
- -r
-
Imports only host information and remote authentication information.
This option cannot be specified together with the -m, -c, -g, or -a option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.
- -c
-
Specifies that the system hierarchy and host information are to be imported. This option cannot be specified together with the -m or -a option. If specified in such a case, an invalid argument error results. If you omit all of the -m, -c, and -a options, the -a option is assumed.
- -g
-
Imports host information, business group information, and monitoring group information only.
This option cannot be specified together with the -m, -r, -c, or -a option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.
- -a
-
Specifies that all information is to be imported. This option cannot be specified together with the -m, -r -c, or -g option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.
Notes
-
Execute this command only on the active host. Make sure that the shared disk is mounted when the command executes.
-
Do not execute this command on the standby host.
If you execute with standby host in UNIX / Linux, an unwanted directory named /shared-directory-name is created under the root directory of standby host local disk, and further unwanted directory and Files are created under that directory as follows.
-
/shared-directory-name/jp1imm
-
/shared-directory-name/jp1imm/log
-
/shared-directory-name/jp1imm/log/imcf
Delete these unwanted directory and files, they will never to be used. To prevent from mistakenly deleting the directory from shared directory, make sure that shared disk is not mounted on standby host before deleting the directory.
-
Return values
0 |
Normal termination |
4 |
Invalid option |
8 |
Server cannot be connected |
12 |
Memory shortage occurred |
16 |
Invalid permission |
20 |
Error, such as a file error or invalid path |
21 |
Upper limit for number of concurrent executions reached |
24 |
An input/output error occurred |
120 |
System error occurred |
124 |
Terminated due to other error |
201 or greater |
JavaVM start error occurred |
Example
Import all the data of an export file located under the c:\temp:
jcfimport -i c:\temp