Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-52
JULIANTIMESTAMP Procedure
If type = 3, the value returned is the number of microseconds since the last
system load. To convert this
retval to a more usable form, use the
INTERPRETINTERVAL procedure.
type input
INT:value
is one of the following values specifying the type of time requested:
0Current GMT
1 System-load GMT
2 SYSGEN GMT
3 Microseconds since system load
If
type is not supplied, then type 0 is used. If type is out of range (that is, not 0,
1, 2, or 3), then a
retval of -1F and an error of -1 are returned.
tuid output
INT:ref:1
is a time-update ID. This is used when calling the SETSYSTEMCLOCK procedure
with relative GMT (see the SETSYSTEMCLOCK procedure).
error output
INT:ref:1
is returned only from a remote system with one exception: a value of -1 is returned
when
type is out of range.
node input
INT:value
is the system number of the remote node from which you want the timestamp. A
value of -1 indicates that this parameter is not present and that the current node
should be used.
Considerations
•
System message -10 (SETTIME) allows processes to determine the magnitude of
and the reason for a time change. Refer to the
Guardian Procedure Errors and
Messages Manual for descriptions of interprocess system messages sent to
processes.
•
A 64-bit Julian timestamp is based on the Julian Date. It is a quantity equal to the
number of microseconds since 12:00 (noon) Greenwich mean time (Julian
proleptic calendar) January 1, 4713 B.C. This timestamp can represent either
Greenwich mean time, local standard time, or local civil time. There is no way to
examine a Julian timestamp and determine which of the three times it represents.