Sun Microsystems 5800 User Manual

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_RESULT_SET

hc_qrs_get_query_integrity_time

Returns a time that helps get more detail on which store index exceptions might still be
unresolved.

hcerr_t hc_qrs_get_query_integrity_time(hc_query_result_set_t *rset,

hc_long_t *query_timep);

If the query integrity time is non-zero, then all store index exceptions whose object creation
time falls before the query integrity time have been resolved. Stored objects from before that
time should show up in all matching query result sets. Store index exceptions that occurred
after that time may not yet have been resolved, and hence might still be missing from a
matching query result set. If the Query Integrity Time is zero, then the set of results in this
ResultSet

is not known to be complete. Note that hc_is_query_complete will return a

non-zero completep value if and only if hc_get_query_integrity_time would set
query_timep

to non-zero query integrity time.

Time values from getQueryIntegrityTime can be compared to object creation time values
returned in the creation_time field of the hc_system_record_t structure to determine if a
particular store operation has been resolved. Note: the query integrity time as reported may well
be earlier than the actual oldest time of a still-unresolved store index exception. The query
integrity time can even go backwards, in other words, a later query can report an earlier query
integrity time.

rset

Updated to point to the new query result set. See

HCERR_OK

HCERR_BAD_REQUEST

Synchronous C API Functions

Sun StorageTek 5800 System Client API Reference Manual • June 2008

98