Open Server supports large object (LOB) locators. A LOB locator contains a logical pointer to LOB data in Adaptive Server rather than the data itself, thereby reducing the amount of data that passes through the network between Adaptive Server and its clients.
The CS_LOCATOR datatype supports LOB locator. The CS_LOCATOR datatype is an opaque datatype that stores locator values and optional prefetched data. Use cs_locator_alloc() to allocate memory for a CS_LOCATOR variable before binding the incoming locator to the variable, otherwise, an error occurs. When the variable is no longer needed, free its memory using cs_locator_drop().
CS_LOCATOR variables can be reused. However, the current locator value in Adaptive Server is valid only until the transaction ends. The CS_LOCATOR datatype has three type constants—CS_TEXTLOCATOR_TYPE, CS_IMAGELOCATOR_TYPE, and CS_UNITEXTLOCATOR_TYPE.
