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.
The login subcommand must execute before the range subcommand executes.
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.
Starting and Ending Time for Collecting Monitoring Data
|
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:
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.
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 examples below assume that the:
Starting time for collecting monitoring data is Jan. 1, 2013, 00:00,
Ending time for collecting monitoring data is Jan. 2, 2013, 00:00.
range 201301010930:201301011730
The Export Tool saves monitoring data within the range of Jan. 1, 9:30-17:30.
range 201301010930:
The Export Tool saves monitoring data within the range of Jan. 1, 9:30 to Jan. 2, 00:00.
range:201301011730
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-17:30.
range +0001:
The Export Tool saves monitoring data within the range of Jan. 1, 0:01 to Jan. 2, 00:00.
range -0001:
The Export Tool saves monitoring data within the range of Jan. 1, 23:59 to Jan. 2, 00:00.
range :+0001
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-00:01.
range :-0001
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-23:59.
range +0101:-0101
The Export Tool saves monitoring data within the range of Jan. 1, 1:01-22:59.
range 201301010900+0130:201301011700-0130
The Export Tool saves monitoring data within the range of Jan. 1, 10:30-15:30.
range 201301010900-0130:201301011700+0130
The Export Tool saves monitoring data within the range of Jan. 1, 7:30-18:30.
range 201301010900-0130:
The Export Tool saves monitoring data within the range of Jan. 1, 7:30 to Jan. 2, 00:00.