Sun Microsystems 5800 manual Hcqrsgetqueryintegritytime

Synchronous C API Functions

Return Codes

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.

Synopsis

hcerr_t hc_qrs_get_query_integrity_time(hc_query_result_set_t *rset,

hc_long_t *query_timep);

Description

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.

Parameter

rset

Updated to point to the new query result set. See “hc_query_result_set_t” on page 49.

Return Codes

HCERR_OK

HCERR_BAD_REQUEST

98 Sun StorageTek 5800 System Client API Reference Manual • June 2008