TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-361
#SETSYSTEMCLOCK Built-In Function (Super-
Group Only)
#SETSYSTEMCLOCK Built-In Function (Super-Group Only)
Use #SETSYSTEMCLOCK to change the setting of the system clock. To use this
function, you must have a group ID of 255.
julian-gmt
is the current Julian timestamp.
mode
is a number that specifies the mode and source, as follows:
A relative mode implies that the julian-gmt parameter contains a microsecond-based
time adjustment, not a timestamp. This mode is used for precise time synchronization to a
hardware clock or for a moderately precise method for the operator to adjust the time. For
details about these modes, see the description of procedure SYSTEMCLOCK_SET_ in the
Guardian Procedure Calls Reference Manual.
Modes 9 and 10 are valid only if the system library contains the SYSTEMCLOCK_SET_
Guardian procedure.
tuid
is a time update ID obtained from #JULIANTIMESTAMP; use it with modes 2 and 3
to avoid conflicting changes.
Result
#SETSYSTEMCLOCK returns zero if it sets the system clock successfully; otherwise,
it returns a negative error result. If the system library contains the
SYSTEMCLOCK_SET_ Guardian procedure, #SETSYSTEMCLOCK returns the error
result defined in the "Result Codes (Error Returns)" subsection of the
#SETSYSTEMCLOCK julian-gmt mode [ tuid ]
Number Mode Source
0 Absolute Greenwich mean time Operator input
1 Absolute GMT Hardware clock
2 Relative GMT Operator input
3 Relative GMT Hardware clock
5 Relative GMT Force set
6 Relative GMT Force adjustment
7 Absolute GMT Force set
8 Ignored, optional Stop time adjustment
9 Rate adjustment Adjust rate
10 Ignored, optional Clear rate adjustment