DataDirect OpenAccess SDK Help

tm_dumpHex

Save PDF

tm_dumpHex

Save PDF

Last Updated: May 12, 2026
1 minute read

OpenAccess SDK
Version 8.1
Documentation

This function displays the input data buffer in hexadecimal digits to the trace file.

void tm_dumpHex(
     TM_ModuleCB  mod, 
     TM_Mask      mask, 
     char      *  str, 
     void      *  data, 
     Sint16       length)

For example, to dump the value of sDatasourceName, you can call:

OAWCHAR *sDatasourceName;
tm_dumpHex(mem_tm_Handle, UL_TM_INFO, "DataSourceName", 
    sDatasourceName, oawcslen(sDatasourceName)*sizeof(OAWCHAR));

This results in a log file showing

SQLDRV :  c:\program files\datadirect\oaserver810\ip\oac\memory\src\mem_drv.c:820 DataSourceName
    0: 6d 00 65 00 6d 00 6f 00 72 00 79 00               |  m.e.m.o.r.y.

Parameters for tm_dumpHex

Parameter	Type	Description
IN
mod	TM_ModuleCB
mask	TM_Mask	A mask defined by the combination of using one or more of the masks listed Table Trace Flag Masks for use in tm_trace().
char	str *	A prefix to identify the hex data
data	void *	A pointer to data whose data needs to be dumped as hexadecimal digits
length	Sint16	The length of data to be dumped.
RETURN
	int	Function call status: DAM_SUCCESS - values set DAM_FAILURE - values not set. One of the values was null when it cannot be.