9.9 jslmmgrexport (exports service monitor information)

Function

This command exports service monitor information needed for data migration. This export processing can be performed for a single monitored service or for all monitored services.

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

• SLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0)

• SLM - Manager Service (service name: JP1_ITSLM_MGR_Service)

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

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

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

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

Format

jslmmgrexport [ -g service-group-name -s service-name ]
                 -t { export-period | all | none }
                 -o output-file-name
                 [ -f ]

Execution permission

User account that belongs to the OS's Administrators group

Storage folder

SLM-Manager-installation-folder\mgr\bin\

Arguments

-g service-group-name

Specifies the name of the service group to which the monitored service to be exported belongs. If a nonexistent service group name is specified, an error results. A name beginning with a hyphen (-) cannot be specified.

When you specify this option, you must also specify the -s option.

To export service monitor information for all monitored services, omit both this option and the -s option. However, if no monitored services have been registered in SLM, executing this command with this option and the -s option both omitted results in an error.

-s service-name

Specifies the name of the monitored service whose service monitor information is to be exported. If a nonexistent service name is specified, an error results. A name beginning with a hyphen (-) cannot be specified.

When you specify this option, you must also specify the -g option.

To export service monitor information for all monitored services, omit both this option and the -g option. However, if no monitored services have been registered in SLM, executing this command with this option and the -g option both omitted results in an error.

-t

Specifies the period for which service performance data is to be exported. The following explains the specification method.

• export-period

  Specifies the number of days whose service performance data is to be exported.

  The permitted value is from 1 through 60 (numeric characters). If the specified value is not within this range, an error results.

  The command exports as many days' worth of past service performance data as specified here, using the time the date value changes as the reference. The data at the reference time is excluded. The time is based on the local time of the computer used to execute the command.

  The following table shows the relationship between when the command is executed and the period subject to export processing.

  Table 9‒16: Relationship between when the command is executed and the period subject to export processing

  No.	Example specification	Command execution date and time	Reference date and time	Period subject to export processing
  1	1	2011/11/15 00:00:00	2011/11/15 00:00:00	2011/11/14 00:00:00 through 2011/11/14 23:59:59
  2	7	2011/11/15 12:34:56	2011/11/15 00:00:00	2011/11/08 00:00:00 through 2011/11/14 23:59:59
  3	30	2011/11/15 23:59:59	2011/11/15 00:00:00	2011/10/16 00:00:00 through 2011/11/14 23:59:59

• all

  Specifies that all service performance data that has been accumulated in the database is to be exported.

• none

  Specifies that no service performance data is to be exported.

-o output-file-name

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

The command collects the data to be exported and then outputs it in binary format to the specified file.

The service performance information subject to export processing consists of real-time information and past information. After a period of a specific amount of time, service performance information is compressed and then retained as past information. Any information whose age is less than the specific amount of time is retained as real-time information without being compressed. Therefore, the size of the output file changes even when the service monitor information is the same because the amount of real-time data varies depending on when the command is executed.

-f

Specifies that if the output file specified in the -o option already exists, that file is to be overwritten with the export data.

If this option is omitted and the specified output file already exists, the command results in an error.

Notes

• This command's processing and the following operations are mutually exclusive:

  • Registering and deleting monitored services

  • Registering and deleting Web transactions

  • Editing Web transactions (including changing their order)

  • Adding, editing, copying, and deleting report templates

  • Updating configuration information

  • Saving monitoring item settings for system performance

  • Setting up service performance monitoring

  • Setting up system performance monitoring

  • Setting up availability monitoring

  If this command is executed while any mutually exclusive processing is underway, the command results in an error and its processing is canceled. Similarly, if any mutually exclusive processing is launched while this command is executing, that processing results in an error and is canceled.

• Do not change the exported data. If the exported data is changed, it can no longer be used for import processing.

• Do not execute commands other than the jslmminfoget command or the jslmreport command while this command is being executed.

• Do not cancel execution of this command by closing the command prompt that is executing this command or by pressing Ctrl+C on the keyboard.

• If this command was canceled while its execution was underway, do not use the jslmmgrimport command to import the export data file that was partially created by this command.

• This command cannot be used to export access logs.

• The time required to perform the export processing depends on the amount of data to be exported. As the amount of data to be exported grows, so does the time required to perform the export processing.

  To shorten the execution time of this command, specify one or both of the following to reduce the amount of data to be exported:

  • Specify the -g option and the -s option to limit the monitored services to be exported.

  • Specify the export period or none for the -t option to limit the number of days for which data is exported.

Return value

Example

C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrexport -g GroupA -s ServiceA -t 1 -o D:\data\itslm_export