range

Description

Use this subcommand to specify a term of monitoring data to be exported into files. Use this subcommand when you want to narrow the export-target term within the stored data.

You need to log into the storage system with the login subcommand before the range subcommand runs.

Syntax

range [[yyyyMMddhhmm][{+|-}hhmm]:[yyyyMMddhhmm][{+|-}hhmm]]

Operands

The value on the left of the colon (:) specifies the starting time of the period. The value on the right of the colon specifies the ending time of the period. Specify the term within "Range From XXX To XXX" which is output by the show subcommand.

If no value is specified on the left of the colon, the starting time for collecting monitoring data is assumed. If no value is specified on the right of the colon, the ending time for collecting monitoring data is assumed. The starting and ending times for collecting monitoring data are displayed in the Monitoring Term area in the Monitor Performance window.

Operand

Description

yyyyMMddhhmm

yyyyMMdd indicates the year, the month, and the day. hhmm indicates the hour and the minute.

If yyyyMMddhhmm is omitted on the left of the colon, the starting time for collecting monitoring data is assumed. If yyyyMMddhhmm is omitted on the right of the colon, the ending time for collecting monitoring data is assumed.

To save monitoring data up to the sampling end time, omit yyyyMMddhhmm on the right of the colon. If you specify yyyyMMddhhmm on the right of the colon, specify date and time at least 30 minutes earlier than the current time. Otherwise, an Out of range error may occur.

+hhmm

Adds time (hhmm) to yyyyMMddhhmm if yyyyMMddhhmm is specified. For example, 201306230000+0130 indicates June 23, 2013. 01:30.

Adds time to the starting time for collecting monitoring data, if yyyyMMddhhmm is omitted.

-hhmm

Subtracts time (hhmm) from yyyyMMddhhmm if yyyyMMddhhmm is specified. For example, 201306230000-0130 indicates June 22, 2013. 22:30.

Subtracts time from the ending time for collecting monitoring data, if yyyyMMddhhmm is omitted.

If the last two digit of the time on the left or right of the colon (:) is not a multiple of the sampling interval, the time will automatically be changed so that the last two digits is a multiple of the sampling interval. If this change occurs to the time on the left of the colon, the time will be smaller than the original time. If this change occurs to the time on the right of the colon, the time will be larger than the original time. The following are the examples:

  • If the time on the left is 10:15, the time on the right is 20:30, and the sampling interval is 10 minutes:

    The time on the left will be changed to 10:10 because the last two digits of the time is not a multiple of 10 minutes. The time on the right will remain unchanged because the last two digits of the time is a multiple of 10 minutes

  • If the time on the left is 10:15, the time on the right is 20:30, and the sampling interval is 7 minutes:

    The time on the left will be changed to 10:14 because the last two digits of the time is not a multiple of 7 minutes. The time on the right will be changed to 20:35 because of the same reason.

Examples

The following examples assume that:

  • The starting time for collecting monitoring data is Jan. 1, 2013, 00:00.
  • The ending time for collecting monitoring data is Jan. 2, 2013, 00:00.

range 201301010930:201301011730
Export Tool saves monitoring data within the range of Jan. 1, 9:30-17:30.

range 201301010930:
Export Tool saves monitoring data within the range of Jan. 1, 9:30 to Jan. 2, 00:00.

range:201301011730
Export Tool saves monitoring data within the range of Jan. 1, 0:00-17:30.

range +0001:
Export Tool saves monitoring data within the range of Jan. 1, 0:01 to Jan. 2, 00:00.

range :-0001
Export Tool saves monitoring data within the range of Jan. 1, 0:00-23:59.

range +0101:-0101
Export Tool saves monitoring data within the range of Jan. 1, 1:01-22:59.

range 201301010900+0130:201301011700-0130
Export Tool saves monitoring data within the range of Jan. 1, 10:30-15:30.

range 201301010900-0130:201301011700+0130
Export Tool saves monitoring data within the range of Jan. 1, 7:30-18:30.

range 201301010900-0130:
Export Tool saves monitoring data within the range of Jan. 1, 7:30 to Jan. 2, 00:00.