Synchronous C API Functions

HCERR_OOM

HCERR_INVALID_NVR

HCERR_ILLEGAL_ARGUMENT

Storing Data and Metadata

The following functions are defined to store data and metadata and to enforce indexing of metadata where necessary:

“hc_store_both_ez” on page 87

“hc_store_metadata_ez” on page 88

“hc_check_indexed_ez” on page 89

Note – The is_indexed value in the returned system record (hc_system_record_t) indicates whether this record was successfully inserted in the query engine at the time of store, and is hence available for query. Objects that were not inserted into the query engine at time of store are called store index exceptions. Until they are resolved, store index exceptions may or may not show up in the result sets of queries that match the store. A store index exception is resolved once the metadata for that object has been successfully inserted into the query engine, after which the object will definitely show up in the result sets of queries that match the store. The “hc_check_indexed_ez” on page 89 method may be used to attempt to resolve a store index exception under program control. Store index exceptions will also be resolved automatically (eventually) by ongoing system healing.

hc_store_both_ez

Stores a metadata record and associated data.

Synopsis

hcerr_t hc_store_both_ez (hc_session_t *session,

*data_source_reader,

void *cookie,

hc_nvr_t *nvr,

hc_system_record_t *system_record);

Description

This function stores both object data and metadata and returns a system_record descriptor. The status from this operation can be reclaimed using “hc_session_get_status” on page 55.

Chapter 3 • Sun StorageTek 5800 System C Client API

87

Page 87
Image 87
Sun Microsystems 5800 manual Storing Data and Metadata, Hcstorebothez