Sun Microsystems Sun StorageTek 5800 - Manual (Page 90)

Description
checkIndexed is intended as way to resolve a store index exception under program control (see
“The 5800 System Query Integrity Model” on page 21 ). Once a store index exception occurs (as
indicated by a non-zero value of the is_indexed field in the hc_system_record_t returned
from a store operation) then hc_check_indexed_ez can be called repeatedly until it returns
with *resultp set to any non-zero value. This will ensure that the metadata for the object has
been inserted into the query engine; the object should then start to show up in matching
queries.
Parameters
session
IN: The session for the host and port to talk to.
oid
IN: An identifier of object data to which the metadata record is attached.
resultp
OUT: Points to an int that is updated to a value that indicates if the metadata for this object has
been inserted into the query engine. The returned value of *resultp is set to -1 if the object was
already present in the query engine, and is set to 0 if the object was not already in the query
engine and could not be added, and to 1 if the object was just now added to the query engine. In
other words, a non-zero value of resultp indicates that the store index exception has been
resolved.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_NULL_SESSION
HCERR_INVALID_SESSION
HCERR_INVALID_OID
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008 90