Hitachi

JP1 Version 12 JP1/Base User's Guide


jbshostsimport

Organization of this page

Function

The jbshostsimport command registers the jp1hosts information into the common definition information.

Format

jbshostsimport { {-o|-r} jp1hosts-definition-file-name [-f] | -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} jp1hosts-definition-file-name

Specify the file name that defines the jp1hosts data to be registered in the common definition information. If you specify the -o option, the existing jp1hosts data registered in the common definition information is not deleted, and the newer jp1hosts data is added (the existing host that is the same as the newer one is overwritten). The following figure shows what happens to the jp1hosts information when you specify the -o option.

[Figure]

If you specify the -r option, all of the existing jp1hosts data registered in the common definition information are deleted, and the newer jp1hosts data is registered. The following figure shows what happens to the jp1hosts information when you specify the -r option.

[Figure]

For details about the format of jp1hosts definition file, see jp1hosts definition file in 16. Definition Files.

-f

If you specify this option, the jp1hosts data is forcibly registered in an environment where the jp1hosts2 data is already defined.

-d

Specify this option when you need to delete the jp1hosts data registered in the common definition information.

-h logical-host-name

When using JP1/Base in a cluster system, specify the logical host whose jp1hosts data you want to register or delete. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed.

Note

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

8

jp1hosts information could not be imported because jp1hosts2 information has already been imported

Example

This example shows how to define the jp1hosts data in an environment where the jp1hosts2 data is already defined:

Execute the jbshostsimport command with the -f option specified in an environment where the jp1hosts2 data is defined.

>jbshostsimport -o jp1hosts-definition-file-name -f
KAVA0436-I  The processing was successful.

If you execute the jbshostsimport command without the -f option specified in an environment where jp1hosts2 data is defined, an error will occur.

>jbshostsimport -o jp1hosts-definition-file-name
KAVA0443-E  The command cannot be executed because jp1hosts2 was already imported.