Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Infrastructure 7.1 .

Examples of common TIME command requests

The following examples of the TIME command demonstrate how to request historical data for various time intervals.

Note

For these examples, assume that today's date is April 15, 2021.


Time interval request

Command string

Description

Retrieve data from one week ago

TIME 08APR2021 09:25

Displays data from the previous week at the end of the interval that contains 9:25 (that is, the interval between 9:15 and 9:30)

Display data from the next interval

TIME = = NEXT

Requests the next interval (the default) from the date and time last specified. Using the previous example, data from April 8, during the interval from 9:30 to 9:45, is displayed.

Display data for a specific time period

TIME 15APR2021 12:00 3H

Displays data from the three-hour period ending on April 15, 2021 at 12 noon

Display data from the next day

TIME 16APR2021 = =

Displays data from the next day during the same time period. The equal signs request the last specified time and duration. Using the previous example, these values would be 12:00 and 3H.

Display data for a specific time period

TIME 15APR2021 08:00 30M

Displays data for the 30 minutes ending at 8:00 on April 15

Display data for a specific time

TIME * 9:00

Displays data from today at 9:00. The asterisk indicates the current date.

Reestablish the current time

TIME * * *

Reestablishes the current time

Note

If the returned window information does not look as you expected, the probable cause is that data was not available during one or more of the intervals that you requested. For example, if you entered TIME * 11:00 4I, you would expect the following line:

=======SYSB=====*======15APR2021===11:00====60M=MVMVP===2

If you receive the following line instead, data was not recorded between 10:45 and 11:00, so the time field says 10:45.:

=======SYSB=====*======15APR2021===10:45====45M=MVMVP===2

How spanned time is calculated

(BMC.AMIOPS.SPE2110)On views that support interval history, by default the window information line displays the spanned time of the current or most recently ended interval in seconds, minutes, or hours. 

You can also request the spanned time of multiple intervals by using the TIME command. The following examples explain how the spanned time is calculated for different types of intervals:

Note

For these examples, assume that each interval lasts 15 minutes and ends on the quarter hour.

Type of interval

Example

Single past interval

The current time is 12:16 and you request data for the interval ending at 12.15.

The time span is the total time elapsed of the interval (15 minutes).

 >H1 =JCPU==============SYSB=*========13JUL2021==12:16=15M====MVMVS====D==499=====

Single current interval

The current time is 12:16 and the current interval started at 12.15.

The time span is the time elapsed since the start of the interval (one minute).

 >W1 =JCPU==============SYSB=*========13JUL2021==12:16=1M====MVMVS====D==499=====

Multiple past intervals

The current time is 12:16 and you used the TIME command to request three intervals with the ending time of 11:00. That is, you want the time elapsed from 10:15 until 11:00.

The interval times are:

  • 10:15 - 10:30 (interval 1)
  • 10:30 - 10:45 (interval 2)
  • 10:45 - 11:00 (interval 3)

The requested end time is in the past and all of the intervals have completed. Therefore, the time span is the total elapsed time for all the intervals (15+15+15=45 minutes)

 >H1 =JCPU==============SYSB=*========13JUL2021==12:16=45M====MVMVS====D==499=====

Multiple intervals including the current interval

The current time is 12:16 and you use the TIME command to request three intervals with the ending time of now (12:16).

The interval times are:

  1. 11:45 – 12:00 (interval 1)
  2. 12:00 – 12:15 (interval 2)
  3. 12:15 – now (12.16) (interval 3)

The current interval (interval 3) has not completed yet. We are one minute into the current interval. Therefore, the time span is the total elapsed time of the two completed intervals plus one minute of the current interval (15+15+1=31 minutes)

 >H1 =JCPU==============SYSB=*========13JUL2021==12:16=31M====MVMVS====D==499=====


Related topic

Viewing-historical-data-in-TSO

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*