Guardian Procedure Calls Reference Manual

Returned Value
INT(32)
Result of the comparison. One of these values:
TS_LESS_THAN0
The value of ts1 is less than the value of ts2. This value is returned only if ts1 and ts2 are created on the
same CPU.
TS_IDENTICAL1
The value of ts1 is identical to the value of ts2. This value is returned only if ts1 and ts2 are created on
the same CPU.
TS_GREATER_THAN2
The value of ts1 is greater than the value of ts2. This value is returned only if ts1 and ts2 are created on
the same CPU.
TS_AMBIGUOUS3
The values for ts1 and ts2 are nearly identical. This value is returned when ts1 and ts2 are created on
the same system, but not the same CPU. If ts1 and ts2 are created on different systems, the difference in
their creation time is less than one minute.
TS_PROBABLY_LESS_THAN4
The value of ts1 is probably less than the value of ts2. This value is returned when ts1 and ts2:
• Are created on the same system, but not the same CPU. The difference in their creation time is greater
than one second. ts1 was probably created before ts2.
or
• Are created on different systems. The difference in their creation time is probably more than one minute.
ts1 was probably created before ts2.
TS_PROBABLY_GREATER_THAN5
The value of ts1 is probably greater than the value of ts2. This value is returned when ts1 and ts2:
• Are created on the same system, but not the same CPU. The difference in their creation time is greater
than one second. ts1 was probably created before ts2.
or
• Are created on different systems. The difference in their creation time is probably more than one minute.
ts1 was probably created after ts2.
The constants TS_... are defined within an enumerated type TS_CompareResults in header file
$SYSTEM.ZGUARD.DTIMEH. The ZGUARD subvolume is distributed in the RVU, but its installation
is optional.
Considerations
• When timestamps are generated in different CPUs or on different systems in the same EXPAND
network you can use the TS_UNIQUE_CONVERT_TO_JULIAN_ Procedure (page 1430) to compare
timestamps and obtain a close-to-exact result. TS_UNIQUE_CONVERT_TO_JULIAN_ allows
you to extract the Julian timestamps from the unique timestamp and compare them using the
normal compare operations. When using this method, the results are only as accurate as the
time synchronization between the CPUs. This method does not allow you to determine which
timestamp was created first when derived Julian timestamps are equal.
TS_UNIQUE_COMPARE_ Procedure 1429