120 Global Call API for HMP on Windows Programming Guide — August 2006
Real Time Configuration Management
4. If the gc_GetConfigData( ) function returns successfully, then obtain the individual parameter
data by calling the gc_util_get_next_parm( ) function. If an error occurs, call the
gc_ErrorInfo() function to find the error and correct it.
9.7.2 Getting or Setting CCLib Configuration in Synchronous Mode
Note: This section applies to E1, T1 and ISDN technologies only.
The Global Call RTCM feature allows the customer application to retrieve or change the default
configuration of a CCLib even before any line device is opened. Figure28 shows the procedure for
synchronous mode.
Figure 28. Getting or Setting CCLib Configuration in Synchronous Mode
The following describes the procedure for getting or setting the configuration of a CCLib in
synchronous mode.
1. Load the call control library after the gc_Start( ) function is called.
2. Find the CCLib ID using its name by calling the gc_CCLibNameToID( ) function. If the
application has doubt about the CCLib name, it can call the gc_GetCCLibStatusAll( )
function to verify whether the CCLib has been started.
3. Create the target object data (a GC_PARM_BLK data structure) with the appropriate set ID,
parm ID, value size, and value, if applicable, by calling the Global Call utility functions
gc_util_insert_parm_ref( ) or gc_util_insert_parm_val( ). See the Global Call API Library
Reference for more information.
Application GlobalCall
Library
gc_Start ()
gc_CCLibNameToID ()
gc_util_insert_parm_ref () or
gc_util_insert_parm_val ()
Load CCLib
Get CCLib ID
Create Target Data for Retrieving
or Upddating CCLib Parameters
Get the Current Values or Set New
Values of the CCLib Parameters
Get the Parameters from the Target Data Block
for the gc_GetConfigData () Function
gc_GetConfigData ()
or
gc_SetConfigData ()
gc_util_next_parm ()