Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/IT Service Level Management Description, User's Guide, Reference and Operator's Guide


jslmmgrimport (imports service monitor information)

Organization of this page

Function

This command imports service monitor information that was exported by the jslmmgrexport command.

You can import the data that was exported for a monitored service by the jslmmgrexport command as is or by specifying the name of a monitored service and the name of the service group to which the monitored service is to belong. If data was exported for all monitored services, you import that data without specifying a monitored service name or service group name.

For both import methods, the command processing depends on whether the name of an exported monitored service or the name of an exported service group to which the monitored service belongs that is contained in the data to be imported already exists at the import destination.

The following table describes the processing when service monitor information is imported.

Table 9‒4: Processing when service monitor information is imported

No.

Data to be imported

Whether the name of a monitored service or the name of the service group to which the monitored service belongs that is contained in the data to be imported already exists at the import destination

Exists#

Does not exist

1

Monitored service management information

Data is imported according to the specified -m option.

Target data is imported as is.

2

Performance data and list of events

Data is imported according to the specified -p option.

#

If the import target already contains a monitored service with the same name as one that is in the data to be imported, monitoring of that monitored service must be stopped.

A monitored service added by import processing is applied to the windows at the time of login.

If you need to change definition information for a monitored service because the IP address of the Web server that provides the monitored service or the IP address of ITSLM - UR has changed, you can edit the definition information in the imported data. However, if the imported data was created by exporting information for all monitored services, the definition information cannot be edited.

Execute this command while the following ITSLM - Manager services are running:

In a cluster system, execute this command on the active server (if the command is executed on the standby server, an error will result).

jslmmgrimport is set as the identifier in the messages this command outputs to the message logs.

For details about the message logs, see 7.2.3 Message logs.

For details about the messages displayed during command execution, see 11.3 Messages.

Format

jslmmgrimport -i import-data-file-name
             [ -g service-group-name -s service-name ]
             [ -m [ IP-address-of-Web-server IP-address-of-ITSLM-UR ] ]
             [ -p ]

Execution permission

User account that belongs to the OS's Administrators group

Storage folder

ITSLM-Manager-installation-folder\mgr\bin\

Arguments

-i import-data-file-name

Specifies as an absolute path the name of the file from which data is to be imported. Specification in UNC is not supported.

If the specified file does not exist, is not accessible, or does not contain valid data exported by the jslmmgrexport command, an error results.

-g service-group-name

Specifies the name of the service group to which the target monitored service belongs.

If both this option and the -s option are omitted, the command uses the appropriate value from the data that is to be imported as is.

If the data to be imported is for all monitored services, do not specify either the -s option or the -g option. If these options are specified in such a case, an error results.

You can specify for the name of the service group a name that differs from the one used for the export processing. However, the specified name must be a string of characters that does not include the characters ", /, [, ], ;, :, |, =, ,, +, ?, <, >, space, tab, machine-dependent characters, and control characters. If the specified name does not observe this limitation, an error results. Also, a name beginning with a hyphen (-) cannot be specified.

-s service-name

Specifies the name of the target monitored service.

This option can be omitted together with the -g option. If this option is omitted, the command uses the value from the data that is to be imported as is.

If the data to be imported is for all monitored services, do not specify either the -s option or the -g option. If these options are specified in such a case, an error results.

You can specify for the name of the monitored service a name that differs from the one used for the export processing. However, the specified name must be a string of no more than 64 characters that does not include the characters ", ,, ', \, space, tab, machine-dependent characters, and control characters. If the specified name does not observe this limitation, an error occurs. Also, a name beginning with a hyphen (-) cannot be specified.

-m

Specifies that if the import target already contains a monitored service with the same name as in the data to be imported, the imported data is to overwrite the management information for that monitored service.

If the import target contains a Web transaction with the same name as in the data to be imported, the display order in effect at the import target remains in effect. If the import target does not contain a Web transaction with the same name, the imported data is added following the Web transactions already registered at the import target.

If this option is omitted and the import target already contains both the name of the service group to which the monitored service specified in the -g option belongs and the name of the monitored service specified in the -s option, the command results in an error.

An error also occurs if import processing will result in the number of Web transactions for a service exceeding 10 (which is the maximum value).

This option is also used to change in the monitored service management information the IP address of the Web server that provides the monitored service and the IP address of ITSLM - UR. The following shows the specification method.

  • IP address of Web server

    Specify the new IP address of the Web server that will be providing the monitored service. The specification format is as follows:

    XXX.XXX.XXX.XXX

    Legend:

    XXX: A number from 0 through 255

    If the value is specified in any other format, an error results.

  • IP address of ITSLM - UR

    Specify the new IP address of ITSLM - UR. The specification format is as follows:

    XXX.XXX.XXX.XXX

    Legend:

    XXX: A number from 0 through 255

    If the value is specified in any other format, an error results.

When data exported for multiple monitored services is to be imported or the number of Web transactions per monitored service exceeds 10 as a result of import processing, specifying this option results in an error.

A service in a system monitoring configuration cannot be imported as a service in a service monitoring configuration by specifying the IP address of the Web server and the IP address of ITSLM - UR. Similarly, a service in a service monitoring configuration cannot be imported as a service in a system monitoring configuration.

-p

Specifies that service performance is to be imported.

When this option is specified and the import target contains a monitored service whose name is the same as a name in the data to be imported, this option overwrites with the imported data the performance of the existing monitored service within the range of the service performance information contained in the imported data. When overwrite import processing is performed, only the data that is within the retention period is imported based on the data with the most recent time, and any data whose retention period has expired is not imported.

The command does not import service performance when this option is omitted, in which case the command imports only management information for monitored services.

Notes

Return value

Return value

Description

0

Import processing terminated normally.

1

Import processing failed.

130

The import processing was canceled because Ctrl+C was pressed.

Example

C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrimport -i D:\data\itslm_export -g GroupA -s ServiceA -m 10.150.100.10 10.150.200.20 -p