Hitachi

JP1 Version 13 JP1/Base User's Guide


jbsdestpimport

Organization of this page

Function

The jbsdestpimport command reflects changes to destination communications port settings.

Format

jbsdestpimport { {-o|-r} destination-communications-port-settings-file | -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 Linux:

/opt/jp1base/bin/

Arguments

{-o|-r} destination-communications-port-settings-file

Specify the file that defines destination communications port information to register to common definition information.

If the -o option is specified, the destination communications port settings information is registered as a new entry without deleting destination communications port settings information that has already been registered in common definition information (entries are overwritten if the same container exists).

If you specify the -r option, all of the existing destination communication port setting information registered in the common definition information are deleted, and the newer destination communication port setting information is registered.

For details about the format of the destination communications port settings file, see Destination communications port settings file in 16. Definition Files.

-d

Specify this option when you need to delete the destination communications port setting information registered in the common definition information.

-h logical-host-name

When operating in a cluster system, specify the logical host to extract destination communications port settings information. Specify the correct, case-sensitive logical host name set when setting up the logical host. 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.

If incorrect arguments other than this option are specified, all specified contents after the incorrect argument are ignored.

Notes

If destination communications port settings registration fails, set the destination communications port again while specifying the -r option.

Return values

0

Normal end

1

Message processing error

2

Command argument error

3

Permission check error

4

Common definition error

5

Destination communications port settings file syntax error

6

File I/O error

255

Other error

Example

The following shows an example of using this command to register new destination communications port settings information.

> jbsdestpimport -o destination-communications-port-settings-file
KAVA0471-I The processing was successful.