Sun Microsystems 5800 Computer Drive User Manual


 
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 eld 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 identier 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
SynchronousCAPI Functions
SunStorageTek 5800SystemClientAPIReferenceManual June 200890