3 Sun StorageTek 5800System CClient API ....................................................................................... 39
Overview of the 5800 System C Client API ...................................................................................... 39
Architecture .................................................................................................................................. 40
Interfaces ....................................................................................................................................... 40
Retrying Operations .................................................................................................................... 40
Multithreaded Access .................................................................................................................. 40
Performance and Scalability .......................................................................................................40
Memory Usage ............................................................................................................................. 41
Updating Schema Denitions .................................................................................................... 41
Session Management ................................................................................................................... 41
C Client Application Deployment ..................................................................................................... 43
Nonblocking C API ............................................................................................................................. 43
Synchronous C API ............................................................................................................................. 44
Changes for the 1.1 Release .........................................................................................................44
Limitations .................................................................................................................................... 45
Synchronous C Data Types ................................................................................................................ 46
hc_string_t ................................................................................................................................. 46
hc_long_t ..................................................................................................................................... 46
hc_double_t ................................................................................................................................. 46
hc_type_t ..................................................................................................................................... 47
hc_value_t ................................................................................................................................... 47
hc_schema_t ................................................................................................................................. 48
hc_nvr_t ....................................................................................................................................... 48
hc_session_t ............................................................................................................................... 48
hc_pstmt_t ................................................................................................................................... 49
hc_query_result_set_t ............................................................................................................ 49
read_from_data_source ............................................................................................................ 49
write_to_data_destination ................................................................................................... 50
hcerr_t ......................................................................................................................................... 51
Synchronous C API Functions .......................................................................................................... 53
Managing 5800 System Sessions ................................................................................................ 53
hc_session_create_ez .............................................................................................................. 53
hc_session_free ........................................................................................................................ 55
hc_session_get_status ............................................................................................................ 55
hc_session_get_schema ............................................................................................................ 56
hc_session_get_host ................................................................................................................ 57
Contents
SunStorageTek 5800SystemClientAPIReferenceManual • June 20084