Sun Microsystems 5800 User Manual

checkIndexed

is intended as way to resolve a store index exception under program control (see

). 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.

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.

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