Guardian Procedure Calls Reference Manual

mode
input
INT:value
specifies the mode and source as follows:
julian-gmt ValueActionZSYSTAL identifierMode
absolute GMTset/adjust timeZSYS^VAL^SCS^OPR^IN^ABS0
absolute GMTset/adjust timeZSYS^VAL^SCS^HRDWR^CLK^ABS1
relative GMTset/adjust timeZSYS^VAL^SCS^OPR^IN^REL2
relative GMTset/adjust timeZSYS^VAL^SCS^HRDWR^CLK^REL3
relative GMTset timeZSYS^VAL^SCS^FORCE^SET^REL5
relative GMTadjust timeZSYS^VAL^SCS^FORCE^ADJ^REL6
absolute GMTset timeZSYS^VAL^SCS^FORCE^SET^ABS7
ignored, optionalstop time adjustmentZSYS^VAL^SCS^STOP^TIMEADJ8
rate adjustmentadjust rateZSYS^VAL^SCS^ADJ^CLK^RATE9
ignored, optionalclear rate adjustmentZSYS^VAL^SCS^RESET^CLK^RATE10
The mode parameter must be specified. If it is omitted, the default is 0.
Absolute mode means that the julian-gmt parameter contains the actual time in microseconds
to which you want to set the system clock, expressed as a Julian GMT value in microseconds.
Relative mode means that the julian-gmt parameter contains the microsecond correction
by which you want to change the system clock; it is not an actual timestamp. This mode is used
for precise time synchronization with a hardware clock or for a moderately precise method of
operator time adjustment.
Beginning with the H06.25 and J06.14 RVUs, the mode literal identifiers are defined in
ZSYSTAL, as shown, and in ZSYSC, where the names are the same except _ replaces ^. These
header files are installed in the ZSYSDEFS subvolume.
Mode considerations are:
• Modes 0 through 3 reset the clock or adjust it conditionally: if the specified time change
exceeds two minutes, the time is set abruptly; otherwise it is adjusted gradually, unless the
time has previously been set or adjusted within the last ten seconds. See also Adjusting
the Clock Using Modes 0, 1, 2, 3, and 6 below.
• Modes 1 and 3 were originally documented for use with a hardware clock, while modes
0 and 2 were for operator input. However, the procedure makes no distinction between
modes 0 and 1 or between modes 2 and 3.
• Modes 5 and 7 set the time abruptly, regardless of the magnitude of the change.
• Mode 6 adjusts the time gradually, regardless of the magnitude of the change, which
cannot exceed one hour.
• Mode 8 stops any time adjustment in process. It does not affect any rate adjustment.
• Modes 9 and 10 are available beginning with the H06.25 and J06.14 RVUs:
Mode 9 specifies a clock rate (frequency) adjustment, specified in parts per million
million (PPMM), i.e. parts per trillion.
◦
◦ Mode 10 resets any rate adjustment to 0. It does not affect any time adjustment.
SYSTEMCLOCK_SET_ Procedure 1409