Guardian Procedure Calls Reference Manual

direction
input
INT:value
indicates what time form or timestamp to return. You can specify one of these values for
direction:
GMT to LCT0
GMT to LST1
LCT to GMT2
LST to GMT3
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 these values:
Value of node is out of range.-5
Timestamp not supplied or has invalid value.-4
Invalid value supplied for direction.-3
Impossible LCT.-2
Ambiguous LCT.-1
No errors, successful.0
DST range error.1
DST table not loaded.2
File-system error (attempting to reach node).>2
Returned Value
FIXED
The converted Julian timestamp.
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).
222 Guardian Procedure Calls (C)