jcshostsimport
- Organization of this page
Function
This command registers host information into and deletes host information from the host information database. You can apply the host information while JP1/IM - Manager is running by executing the jco_spmd_reload command after this command has executed. While JP1/IM - Manager is stopped, you can apply the host information by starting JP1/IM - Manager.
You can use this command when the Central Scope functions are enabled.
Format
jcshostsimport { { -o | -r } host-information-file-name | -d} [-h logical-host-name]
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:
-
Scope-path\bin\
- In UNIX:
-
/opt/jp1scope/bin/
Arguments
- -r host-information-file-name
-
Specifies the name of the file that contains the host information that is to be registered into the host information database. When the -r option is specified, the command deletes all host information from the existing host information database and then registers the specified host information into the database.
For details about the format of the host information file, see Host information file (jcs_hosts) in Chapter 2. Definition Files.
- -o host-information-file-name
-
Specifies the name of the file that contains the host information that is to be registered into the host information database. When the -o option is specified, the command adds to the host information database the host information contained in the host information file without deleting the existing host information from the database (if an identical IP address exists, the information for that host is overwritten).
For details about the format of the host information file, see Host information file (jcs_hosts) in Chapter 2. Definition Files.
- -d
-
Specifies that all the existing host information is to be completely deleted from the host information database.
- -h logical-host-name
-
When you are operating in a cluster system, this option specifies the logical host name. If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed. If you are not using a cluster system, specification of this option is not needed.
Return values
0 |
Normal termination |
1 |
Logical host name is invalid |
2 |
Argument error |
3 |
File name is invalid |
4 |
No permission to execute the command |
5 |
Syntax error in the specified host information file |
6 |
No permission to access the specified host information file |
10 |
Setup has not been completed |
11 |
There is no host information database |
12 |
Insufficient memory |
13 |
Insufficient disk capacity |
14 |
Host information database is corrupted |
15 |
Message initialization failed |
16 |
Host information database is in use |
99 |
Other error |