Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

jcsdbexport

Function

This command acquires monitoring object database storage information and outputs it locally to a file as a configuration file for monitoring tree. The information that is output to the file includes monitoring tree configuration information, common event monitoring conditions, and Visual Monitoring window configuration information.

You can use this command to store multiple generations of storage information in the monitoring object database. To copy the storage information in the monitoring object database to another server, execute this command and then use the jcsdbimport command to copy the storage information to the monitoring object database of the other 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.

A configuration file for monitoring tree that was output by JP1/IM - Manager version 08-10 or later cannot be imported by JP1/IM - Manager version 08-01 or earlier.

Format

jcsdbexport [-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 the file to which tree configuration information is to be output. 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).

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
13	Insufficient disk capacity
31	Database initialization failed at the server
32	Database access failed at the server
33	Specified monitoring tree ID or monitoring node ID was not found in the database
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	An invalid response was sent from the server
42	Another command or request is being processed
99	Other error

Example

Output monitoring object database storage information to c:\temp\output.dat:

jcsdbexport -o c:\temp\output.dat
 

Example output

 
KAVB7670-I Exporting of the monitoring tree definition to the file c:\temp\output.dat was successful.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.