Global Call API for HMP on Windows Programming Guide — August 2006 119
Real Time Configuration Management
•Getting or Setting Line Device Configuration in Synchronous Mode
•Setting Line Device Configuration in Asynchronous Mode
•Setting Board Device Configuration in Asynchronous Mode (IP Technology)
9.7.1 Getting or Setting GCLib 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 GCLib even before any line device is opened. Figure27 shows the procedure for
synchronous mode.
Figure 27. Getting or Setting GCLib Configuration in Synchronous Mode
The following describes the procedure for getting or setting the configuration of the GCLib in
synchronous mode:
1. Load the GCLib (after the gc_Start( ) function is called).
2. 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.
3. Call the gc_GetConfigData( ) or gc_SetConfigData( ) function with: target_type =
GCTGT_GCLIB_SYSTEM
target_id = 0
time_out = 0
mode = EV_SYNC
Application GlobalCall
Library
gc_Start ()
gc_util_insert_parm_ref () or
gc_util_insert_parm_val ()
Load GCLib
Create Target Data for Retrieving
or Updating GCLib Parameters
Get the Current Values or Set New
Values of the GCLib Parameters
Get the Parameters from the Target Data Block
for the gc_GetConfigData () Function
gc_GetConfigData ()
or
gc_SetConfigData ()
gc_util_next_parm ()