DataDirect OpenAccess SDK Help

dam_getJoinColValue

Save PDF

dam_getJoinColValue

Save PDF

Last Updated: May 12, 2026
1 minute read

OpenAccess SDK
Version 9.0
Documentation

This method returns the column value of the table already processed. This method is used by the IP to get values for the join conditions for use in processing the inner table.

Object dam_getJoinColValue(
       long   hstmt, 
       long   hcol, 
       int    iColNum, 
       int    iXoType,
       xo_int piValLen,
       xo_int piValStatus)

Parameters for dam_getJoinColValue

Parameter	Type	Description
INPUT
hstmt	long	The statement handle.
hcol	long	The column handle.
iColNum	int	The column number of the column for which the value is being requested.
iXoType	int	The data type in which to return the column.
OUTPUT
piValLen	xo_int	The length of the data in the returned object. XO_NULL_DATA - null data XO_NTS - null terminated string>= 0 - length of the data
piValStatus	xo_int	The status of the method call. DAM_SUCCESS - all data retrieved. DAM_SUCCESS_WITH_RESULT_PENDING - more data is available and can be retrieved by calling this method again. This will occur for large LONGVARBINARY data. DAM_FAILURE - error in getting the data. It is possible that the data cannot be converted to the XO_Type asked for.
RETURN
	Object	The object that represents the data portion of the column value; the format of the data depends on the type of the iXoType specified. Use this object only if piValLen is not set to XO_NULL_DATA. See Table How the methods for Java return a value as an object.