Powered by Zoomin Software. For more details please contactZoomin

DataDirect OpenAccess SDK Help

dam_addLOBLocatorValToRow

  • Last Updated: May 12, 2026
  • 1 minute read
    • OpenAccess SDK
    • Version 9.0
    • Documentation

This method is used to getting LOB data from the IP, based on a request from the client. The IP calls this method to add the locator value. When a client requests data, OpenAccess SQL Engine invokes dam_addLOBLocatorValToRow, which is then exported from the IP.

The IP layer can call this method to set a LOB locator value for the long data column specified by hCol in the row specified by hRow. Setting a LOB locator as the column value in the row allows the long data value for that column to be fetched in pieces. Fetching the long data in pieces can greatly reduce the amount of memory needed to process a query result because the entire long data value does not need to be held in memory.

int dam_addLOBLocatorValToRow(
int64 dam_hstmt,
int64 hRow,
int64 hCol,
int iXOType,
Object pColVal,
long lColValLen)

Parameters for dam_addLOBLocatorValToRow

Parameter Type Description
IN    
dam_hstmt int64 The statement handle
hRow int64 The row handle
hCol int64 The column handle
iXOType int xo type of the stream.
pColVal Object LOB locator value, for example, File Handle.
IColValLen long The LOB locator value length.
RETURN    
  int DAM_SUCCESS – added the value to the row.
DAM_FAILURE – error adding the value.
TitleResults for “How to create a CRG?”Also Available inAlert