TACL Reference Manual

UTILS:TACL Commands and Functions
HP NonStop TACL Reference Manual—429513-018
8-198
SETTIME Command (Super-Group Only)
Considerations
•
The valid date range is from 01 January 1975 0:00:00.000000 to 31 December
4000 23:59:59.999999.
•
If you execute this command while a system monitoring measurement is in process
by the XRAY facility, invalid measurements result.
•
The CONVERTTIMESTAMP system procedure is invoked while setting the system
clock. See #CONVERTTIMESTAMP Built-In Function on page 9-79 for
descriptions of the error messages that CONVERTTIMESTAMP could display.
•
SETTIME calls the #SETSYSTEMCLOCK built-in function, which in turn calls the
SETSYSTEMCLOCK system procedure. If you use SETTIME to set the system
clock forward or backward two minutes or less, the system adjusts the clock in
small increments rather than setting it to the new time. Adjusting the clock forward
two minutes takes about 33 hours. Adjusting the clock back two minutes takes
about 14 days.
If you issue two SETTIME commands in less than ten seconds, the system stops
any ongoing adjustment and sets the clock to the value specified in the second
call.
•
The valid date range is from 01 January 1975 0:00:00.000000 to 31 December
9999 23:59:59.999999. If the system does not support the maximum value for year
(9999), the SETTIME command returns the error message:
Invalid date and/or time format.
Example
1. To set the system clock to 8:01 p.m. on July 9, 2004, enter:
34> SETTIME JUL 9 2004, 20:01
2. You can see the new time by entering the TIME command:
35> TIME
July 09, 2004 20:01:ss