CS_LOCATOR 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, use cs_locator_drop() to free its memory.
CS_LOCATOR variables can be reused, however, the current locator value in Adaptive Server is valid only until the transaction ends.
CS_TEXTLOCATOR_TYPE – for text LOBs.
CS_IMAGELOCATOR_TYPE – for image LOBs.
CS_UNITEXTLOCATOR_TYPE – for unitext LOBs.
Use cs_convert() to retrieve the locator’s prefetched data and the character representation of the locator value from the CS_LOCATOR variable. Converting CS_LOCATOR to a CS_CHAR returns the locator’s hexadecimal value as a string. Converting the locator to CS_TEXT_TYPE, CS_IMAGE_TYPE, or CS_UNITEXT_TYPE returns the locator’s prefetched data.