Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-148
CONVERTTIMESTAMP Procedure
julian-timestamp input
FIXED:value
is a four-word Julian timestamp to be converted.
direction input
INT:value
indicates what time form or timestamp to return. You can specify one of the
following values for
direction.
0 GMT to LCT
1 GMT to LST
2 LCT to GMT
3 LST to GMT
If
direction is omitted, 0 is used. If direction is out of range, a value of -3 is
returned in
error.
node input
INT:value
is the number of the node at which the conversion is to take place. If the
node
parameter is omitted or -1, the caller’s node is used. If the specified node does not
exist, the value of
ret-time is not changed.
error output
INT:ref:1
returns one of the following values:
-5 Value of
node is out of range
-4 Timestamp not supplied or has invalid value
-3 Invalid value supplied for
direction
-2 Impossible LCT
-1 Ambiguous LCT
0 No errors, successful
1 DST range error
2 DST table not loaded
>2 File-system error (attempting to reach
node)
Considerations
•
A local timestamp can be in either of two forms: LCT (with DST correction) or LST
(without DST correction).
•
Network and local timestamp
Local timestamp (with LCT and LST) should be used with caution if any network
use is anticipated. The reason is that another node can be in another time zone or
in an area with different DST rules (LCT only).