Client-Library Changes

The CS_LOCATOR datatype supports LOB locator. The cs_locator_alloc() and cs_locator_drop() APIs allocate and deallocate memory for CS_LOCATOR variables. cs_locator() has been added to retrieve information from a CS_LOCATOR variable.

Client-Library routines cs_convert() and ct_bind() have been enhanced to handle CS_LOCATOR variables.

• CS_LOCATOR
  CS_LOCATOR is an opaque datatype that stores locator values and optional prefetched data.
• cs_locator()
  Retrieves information from a CS_LOCATOR variable, such as prefetched data, the total length of the LOB in the server, or the character representation of the locator pointer.
• cs_locator_alloc()
  Allocates a CS_LOCATOR datatype structure.
• cs_locator_drop()
  Deallocates a CS_LOCATOR datatype structure.
• isql Enhancement
  isql displays the LOB locator value in its hexadecimal character form. Prefetched data stored in CS_LOCATOR does not appear.