jbshosts2import
- Organization of this page
Function
The jbshosts2import command registers jp1hosts2 information on a host.
Format
jbshosts2import { {-o|-r} [jp1hosts2-definition-file-name] | -d } [-h logical-host-name]
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
{-o|-r} jp1hosts2-definition-file-name
Specify the name of the file that contains the jp1hosts2 information you want to register with the host. If you specify the -o option, the command merges the new jp1hosts2 information with the existing information (if the same host is already defined, the existing entry is overwritten). The following figure shows what happens to the jp1hosts2 information when you specify the -o option.
If you specify the -r option, the jbshosts2import command deletes all of the existing jp1hosts2 information before registering the new information. The following figure shows what happens to the jp1hosts2 information when you specify the -r option.
If you specify the name of the jp1hosts2 definition file by relative path, the path is interpreted relative to the current directory at command execution. If you do not specify a file name, the command imports the jp1hosts2 definition file in the following directory:
- In Windows:
-
installation-folder\conf\jp1hosts2.conf
shared-folder\jp1base\conf\jp1hosts2.conf (in a cluster environment)
- In UNIX:
-
/etc/opt/jp1base/conf/jp1hosts2.conf
shared-directory/jp1base/conf/jp1hosts2.conf (in a cluster environment)
For details on the format of a jp1hosts2 definition file, see jp1hosts2 definition file in 16. Definition Files.
-d
Specify this option to delete the jp1hosts2 information registered on the host.
-h logical-host-name
Specify the name of the logical host for which to register or delete jp1hosts2 information. If you omit this option, the host name set in the JP1_HOSTNAME environment variable is assumed. If JP1_HOSTNAME is not set, the physical host name is assumed.
To register or delete jp1hosts2 information on a logical host in a cluster system, execute the jbshosts2import command on the primary node.
Notes
-
If executing the jbshosts2import command changes either of the following settings, you must restart JP1/Base, products for which JP1/Base is a prerequisite, and programs that have a dependency relationship with JP1/Base:
-
The IP address allocated to the local host
-
The IP address of a host with which JP1/Base is communicating
-
-
If you execute this command in an environment where jp1hosts information is set but not jp1hosts2 information, the confirmation message KAVA0464-I is output.
-
When registering jp1hosts2 information in an environment that uses jp1hosts information, first migrate the definitions in the jp1hosts information to jp1hosts2 information. For details, see 6.4.5 Migrating from jp1hosts information to jp1hosts2 information.
-
In a cluster system environment, if you import jp1hosts2 information to a physical host that contains a logical host with jp1hosts information, the jp1hosts2 information you import is also applied to the logical host. When this happens, the jp1hosts information defined for the logical host becomes invalid.
Return values
0 |
Normal end |
1 |
Message processing error |
2 |
Command argument error |
3 |
Permission check error |
4 |
Common definition error |
5 |
Syntax error |
6 |
File I/O error |
7 |
Another jbshosts2import command is being executed |