Viewing historical data in TSO

Use the following procedure to see system data from the past that is stored in historical data sets on the host. You can view historical data for any time increment, such as an hour ago, yesterday, or last month.

Before you begin

If you want to confirm that data has been recorded to historical data sets, enter DSLIST or VIEW DSLIST on the COMMAND line. A list of the currently allocated historical data sets is displayed.

To view historical data

1. On the COMMAND line, enter the TIME command. For examples of the TIME command, see Examples of common TIME command requests.
   
   The SET TIME FRAME window appears. Use the options under Requested Time Frame to modify or add greater detail to the TIME command. The command uses the following syntax:
   
   TIME date time [{duration|NEXT|PREV} dowMask todMask]
   
   

2. Enter one of the following values for the End Date parameter (the ending date of the data that you want to see):

   Date value	Description
   *	Current date
   =	Date specified with a preceding TIME request
   ddmmmyyyy	Date in the same format as the current date, which always appears in the upper left corner of the screen (such as 15APR2018) Tip You can change the format of the date by entering MVParms on the COMMAND line and selecting the date option.
   *- nnn	Number of days prior to today, up to 365 days
   TODAY TDAY	Today’s date (same as using *)
   YESTERDAY YDAY	Yesterday's date
   LASTdow L abbreviatedDow	Date corresponding to the most recent occurrence of the specified day of the week Replace dow with the full name of the day that you want to use (for example, LASTSUNDAY or LASTWEDNESDAY) Replace abbreviatedDow with the first three characters of the name (for example, LSUN or LWED)
   ENDOFMONTH EOM	Last day of the previous month
   ENDOFYEAR EOY	Last day of the previous year
   FIRSTOFWEEK FOW	First day of the current week (Monday)
   FIRSTOFMONTH FOM	First day of the current month
   FIRSTOFYEAR FOY	First day of the current year
   LASTWEEKDAY LWKD	Most recent weekday prior to today
   LASTWEEKENDDAY LWKED	Most recent weekend day prior to today (Sunday)
   FIRSTWEEKDAY FWKD	First day of the current week (same as specifying FIRSTOFWEEK)
   FIRSTWEEKENDDAY FWKED	First day of the most recent weekend (Saturday)

3. Enter one of the following values for the End Time parameter (the ending time of the data that you want to see):

   Time value	Description
   *	Current time
   =	Time specified from a preceding TIME request
   hh:mm	Where hh  is a 2-digit hour value from 00 to 23 mm  is a 2-digit minute value from 00 to 59
   ss	(Optional) A 2-digit second value from 00 to 59. Example, hh:mm:ss
   th	(Optional) A 2-digit hundredths of a second value from 00 to 99. Example, hh:mm:ss:th

4. (Optional) Enter one of the following values for the Duration parameter (the time period over which you want your data summarized).

   Note

   The TIME command lets you display data as it existed at the end of one interval (usually 15 or 30 minutes), unless you specify a longer duration here. When you request historical data with the TIME command, data from the most recent interval specified and preceding intervals is presented in a view. A detail view displays only the last interval in the time frame.

   
   

   Duration value	Description
   *	One recording interval
   =	Duration specified with a preceding TIME request
   NEXT	Use the duration value currently in effect to cycle forward by that duration amount
   PREV	Use the duration value currently in effect to cycle backward by that duration amount
   TODAY TDAY	Today’s intervals back to midnight You can use this value only if you specified TODAY for the date parameter
   MONTH	One month back from the end date
   nnnnH	Number of hours in the duration, where nnn is any number up to 9999
   nnnnM	Number of minutes in the duration, where nnnn is any number up to 9999
   nnnnI	Number of recording intervals in the duration, where nnnn is any number up to 9999
   nnnD	Number of days in the duration, where nnn is any number up to 416
   nnW	Number of weeks in the duration, where nn is any number up to 59

5. (Optional) Enter one of the following values for the DOW Mask parameter (Day of Week), the TOD Mask parameter (Time of Day), or both to further limit the TIME interval.
   
   DOW Mask limits the selected intervals within the specified time to those that end on specific days of the week. If you use the DOW Mask parameter, you must also use the TOD Mask parameter.

   DOW value	Description
   *	Retains the current day-of-week mask
   =	EVeryday, or EVday
   Days of the week	Mondays or Mons TUesdays or TUes WEDnesdays or WEDs THursdays or THus Fridays or Fris SAturdays or SAts SUndays or SUns WEEKDays or WKDays WEEKEnds or WKEnds

   
   

   Note

   Alternatively, you can specify multiple days by providing a seven-character string of Y or N (Yes or No) indicators. In this string, the first character represents Sunday, the second represents Monday, the third represents Tuesday, and so on. Y indicates that the day is selected. N indicates that the day is not selected.
   For example, the string NYNYNYN specifies Mondays, Wednesdays, and Fridays.

   
   

   TOD Mask limits the selected intervals within the specified time to those that end within a time-of-day range.

   TOD value	Description
   *	Retains the current time-of-day mask
   =	Allday, or Ad (all hours of the day)
   Times of the day	Primeshift or Ps (08:01 through 16:00) Swingshift or Ss (16:01 through 00:00) Graveyardshift or Gs (00:01 through 08:00)

   
   

   Note

   Alternatively, you can specify an eleven-character string consisting of the start and end times in 24-hour clock notation separated by a dash.
   For example, the string 10:01-14:00 specifies intervals ending between 10:01 A.M. and 2:00 P.M.

6. Press Enter to display the historical data based on the parameters that you set.