Sun Microsystems 5800 User Manual

A multiplatform synchronous C API in which operations are accomplished in a few simple
function calls is provided for the 5800 system. The API calls include operations for storing,
retrieving, deleting, and querying of data and metadata records. Multiple threads are supported,
and operations block until they complete.

You must call hc_init (once per process) and

(once per

thread) prior to making any other API calls.

All functions in the 5800 system C API return an hc_err. Any value other than HCERR_OK
indicates failure.

This section discusses the following topics for the 5800 system synchronous C API.

■

■

This release of the synchronous C API contains the following changes:

■

Handling is added for storing, retrieving and querying the following new metadata types:

– char — for Latin 1 character set
– unicode
– binary
– date
– time
– timestamp

Query and queryplus are merged

■

Prepared statements (pstmts) are introduced to handle values of queries that cannot be
placed inline, and a new query is introduced to handle them.

■

The following new functions have been added to the API:

–

–

–

–

–

–

–

–

–

–

Synchronous C API

Sun StorageTek 5800 System Client API Reference Manual • June 2008

44