Specifications

60 System Software Diagnostics Guide — September 2006

Tracing Multiple ISDN Trunks Using Global Call

9.6 Setting the Trace Queue Size Using

gc_SetConfigData( )

The gc_SetConfigData( ) API is used for setting the size of the trace buffer in the host DM3 call

control library if overruns (overflow) occur. If the trace data queue in the host DM3 cclib

overflows, the data at the front of the queue will get overwritten and the cause value associated with

that data will be set to GCRV_QUEUE_OVERFLOW.

Notes: 1. gc_GetConfigData( ) can be used to retrieve the trace queue size.

2. Previously, the gc_GetConfigData( ) and gc_SetConfigData( ) APIs were not supported on

DM3 architecture boards.

To set the trace queue size, the gc_util_insert_parm_val( ) function must be used to populate the

GC_PARM_BLK with the following parameter values:

• setID = CCSET_TRACEDATA

• parmID = CCPARM_TRACEQ_SIZE

• data_size = sizeof(int)

• data = integer value

Once the GC_PARM_BLK has been populated with the desired values, the gc_SetConfigData( )

function can be issued to perform the configuration. The parameter values for the

gc_SetConfigData( ) function are as follows:

• target_type = GCTGT_CCLIB_NETIF

• target_id = the trunk line device handle

• target_datap = GC_PARM_BLKP parameter pointer, as constructed by the utility function

gc_util_insert_parm_val( )

• time_out = time interval (in seconds) during which the target object must be updated with the

data. If the interval is exceeded, the update request is ignored. This parameter is supported in

synchronous mode only, and it is ignored when set to 0.

• update_cond = GCUPDATE_IMMEDIATE

• request_idp = pointer to the location for storing the request ID

• mode = EV_ASYNC for asynchronous execution or EV_SYNC for synchronous execution

Sample application code

Note: The following sample code was written for an application running on a system in which an Intel

NetStructure DMT160TEC board was used as the network interface, an Intel NetStructure

DMV2400A board was used as a play/record resource board, and the boards were connected via a

CT Bus.

GC_PARM_BLKP ParmBlkp = NULL;

long id;

gc_util_insert_parm_val(&ParmBlk, CCSET_TRACEDATA, CCPRM_TRACEQ, sizeof(int), 500);

Note: The maximum value is 1000 and default is 32.