Guardian Procedure Calls Reference Manual

SETSYSTEMCLOCK Procedure (Superseded by the SYSTEMCLOCK_SET_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Condition Code Settings
Example
Related Programming Manual
Summary
The SETSYSTEMCLOCK procedure allows you to change the system clock if you are a member of
the super group. As of the H06.25 and J06.14 RVUs, SETSYSTEMCLOCK is superseded by the
SYSTEMCLOCK_SET_ Procedure (page 1408), which calls the same parameters.
Syntax for C Programmers
#include <cextdecs(SETSYSTEMCLOCK)>
_cc_status SETSYSTEMCLOCK ( long long julian-gmt
,short mode
,short tuid );
• The function value returned by SETSYSTEMCLOCK, which indicates the condition code, can
be interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the file
tal.h).
• In native C/C++, _cc_status is a typedef for int and the _cc_status value can also
be treated directly as a result code: the value is 0 for success, <0 for failure, never > 0.
◦ Beginning with the H06.25 and J06.14 RVUs, the _cc_status value is the result from
the SYSTEMCLOCK_SET_ Procedure (page 1408), and never -1.
◦ On an earlier version of the NonStop Kernel, the error result is always -1. (For TNS C
callers, the _cc_status encoding is different, and all errors are reported using the CCL
value defined in tal.h.).
Syntax for TAL Programmers
CALL SETSYSTEMCLOCK ( julian-gmt ! i
,mode ! i
,[ tuid ] ); ! i
NOTE: The parameters to and operations of SETSYSTEMCLOCK are exactly the same as described
for SYSTEMCLOCK_SET_ Procedure (page 1408); see that procedure for details.
Condition Code Settings
indicates that an error occurred.< (CCL)
indicates that SETSYSTEMCLOCK is successful.= (CCE)
SETSYSTEMCLOCK Procedure (Superseded by the SYSTEMCLOCK_SET_ Procedure) 1357