Using the TIME command

When you issue the TIME command with no parameters, MainView for z/OS prompts you for the parameters on a pop-up window.
The syntax for the TIME command is

TIME [date time [duration | NEXT | PREV]] [dowMask todMask]

where

Variable	Description
date	Is the ending date of the data that you want to view. This is a required parameter. An asterisk (*) gives you the default value, the current date. Specify the date in the same format as the current date, which always appears in the upper left corner of the screen. You can change the format of the date by selecting Option 0 on the MainView Selection Menu, and then selecting Option 4 on the MainView Parameter Editors Menu.
time	Is the ending time of the data that you want to view. This is a required parameter. An asterisk (*) gives you the default value, the current time. Specify the time in the format hh:mm.
duration	Is the time period over which you want your data summarized. This is parameter is optional. The default is one recording interval (usually 15 or 30 minutes for interval data). Specify the duration in the format nnnnu, where:
	nnnn	indicates the number of hours, minutes, or intervals in the duration
	u	indicates the unit of time: I (intervals), M (minutes), H (hours), D (up to 416 days), or W (up to 59 weeks)
	TODAY or TDAY	specifies today’s intervals since midnight
	MONTH	specifies one month
NEXT	is specified instead of the duration parameter NEXT uses the duration value currently in effect to cycle forward by the duration amount.
PREV	is specified instead of the duration parameter PREV uses the duration value currently in effect to cycle backward by the duration amount.
dowMask	limits the selected intervals to end on specific days of the week
todMask	limits the selected intervals to end within a specific time of the day

Tip

In place of the date, time, or duration parameters, you can use

an asterisk (*)—to specify the default value. The default values are current date, current time, and one recording interval
an equal sign (=)—to specify the most recently requested date, time, or duration

Note

If you issue the command TIME * * 1I for long-term history data, you will not retrieve any data because the current interval cannot be viewed until it has been written to the long-term history file. (The long-term interval is usually one hour.)

If you issue the command TIME * * for short-term history data, you will retrieve data for the most recent completed short-term interval. When short-term data collection is active, pressing Enter when another short-term interval has been completed displays the data for the new interval; in other words, the view moves forward automatically to the most recently.

For examples demonstrating several different uses of the TIME command, see Examples-demonstrating-different-use-of-the-TIME-command.

The appearance of the date depends on the date format in use. The format for the date in these examples is mm/dd/yyyy.

Using the TIME command

MainView for z/OS 6.1

On this page