Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Command, Definition File and API Reference


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