HP OpenVMS DCL Dictionary


Previous Contents Index


SET TIME

Resets the system clock, which is used as a timer to record intervals between various internal events and as a source clock for displaying the time of day.

Requires both OPER (operator) and LOG_IO (logical I/O) privileges.


Format

SET TIME [=time]


Parameter

time

Specifies a date in the format day-month-year, or a time in the format hour:minute:second.hundredth, or both. These fields accept the following values:
Field Type Values
Day Integer 1 to 31
Month String JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC
Year Integer 1858 to 9999
Hour Integer 0 to 23
Minute Integer 0 to 59
Second Integer 0 to 59
Hundredth Integer 0 to 99

The hyphens (-), colons (:), and period (.) are required delimiters. Separate the date and time, when both are specified, with a colon. The syntax is sometimes specified as follows:

[dd-mmm-yyyy[:]] [hh:mm:ss.cc]

Alpha systems also allow a 2-digit year format:

[dd-mmm-yy[:]] [hh:mm:ss.cc]

The century applied to the 2-digit year format is determined by the corresponding year in the supported Alpha date range (1957-2056). A 2-digit year in the range 57-99 is assumed to mean the years 1957-1999; a 2-digit year in the range 00-56 is assumed to mean the years 2000-2056. (To specify years outside the 1957-2056 range, you must enter a 4-digit year.)

If the explicit time value is not specified, the interval system clock is automatically reset according to the time-of-year clock.

Note that the time-of-year clock is optional for some VAX processors. For further information about the time-of-year clock, see the hardware documentation for your computer.

Note

Alpha systems maintain system time during power failures and system down time. When a system is booted, if the time is known to be earlier than the time value of the last time modification, or greater than five years in the future, you are prompted to enter the time at the console prompt.

Description

Resets the system clock, which is used as a timer to record intervals between various internal events and as a source clock for displaying the time of day.

Note

The SET TIME command will not work if there is a time service available on your system or OpenVMS Cluster.

Qualifier

/CLUSTER

Requires OPER and LOG_IO privilege, and in an OpenVMS Cluster environment, SYSLCK privilege.

Sets the time on all nodes in a cluster to the same system time. The format of the SET TIME /CLUSTER command is the following:


Format

SET TIME[=time] [/CLUSTER]


Examples

#1

$ SET TIME=14-DEC-2001:19:31:0.0
      

The SET TIME command in this example sets the date and time to December 14, 2001, 7:31 P.M.

#2

$ SET TIME
$ SHOW TIME
14-DEC-2001 03:21:27.53
      

The SET TIME command in this example sets the system time according to the time-of-year clock. The SHOW TIME command requests a display of the current time.

#3

$ SET TIME=14-DEC-2001:15:31:0.0/CLUSTER
      

This example sets the date and time to December 14, 2001, 3:31 P.M. on all nodes in the cluster where the command was entered.


Previous Next Contents Index