Hitachi

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


jcsdbimport

Organization of this page

Function

This command applies monitoring object database storage information that was output by the jcsdbexport command (monitoring tree configuration information, common event monitoring conditions, and Visual Monitoring window configuration information) to the monitoring object database of JP1/IM - Manager.

Use this command together with the jcsdbexport command to migrate JP1/IM - Manager monitoring object database storage information to another server.

You can use this command when the Central Scope functions are enabled.

If you execute this command while updating data for Central Scope Service, the command terminates with an error. For example, if you execute this command while updating the server's tree from the Monitoring Tree (Editing) window or while changing the status of a monitoring node with the jcschstat command, the command terminates with an error.

Format

jcsdbimport [-h logical-host-name]
            -o file-name
            [-t timeout-period]

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

-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.

-o file-name

Specifies the full path of a file that was output by the jcsdbexport command and that is to be applied to the monitoring object database of JP1/IM - Manager. The file name must end with .dat. If the path contains a space, enclose the entire path in double-quotation marks (").

-t timeout-period

Specifies the timeout period for communication with the server. The permitted value is from 10 to 32,767 (seconds). The default is 1,800 seconds (30 minutes).

Notes

Importing information with the jcsdbimport command initializes the status of the monitoring tree.

Return values

0

Normal termination

1

Logical host name was not found

2

Argument error

3

Specified file is invalid

4

No permission to execute the command

6

No permission to access the specified file

12

Insufficient memory

31

Database initialization failed at the server

32

Database access failed at the server

34

Format error in the configuration file for monitoring tree

37

No response from the server (connection establishment request failed)

38

Communication with the server failed (the server was terminated during communication or the server's connection count exceeded the maximum value)

39

A timeout occurred (after a request was sent to the server, the timeout period was exceeded before a response was received)

40

Invalid response was sent from the server

41

Specified input file was not found

42

Another command or request is being processed

48

The file is not compatible with the file version specified by the server

99

Other error

Example

Apply the file input.dat output by the jcsdbexport command to the monitoring object database of JP1/IM - Manager:

jcsdbimport -o input.dat

Example output

KAVB7660-I Importing of the monitoring tree definition from the file input.dat was successful.