9.8.4 Getting or Setting Line Device Configuration in Synchronous Mode

The Global Call RTCM feature also allows the customer application to retrieve or change the default configuration of a line device in synchronous mode. Synchronous mode can be used effectively in any of the following cases:

• The request is to retrieve parameters.
• The request is to update parameters that are NOT call related.
• The request is to update parameters that are call related but there is no active call on the target object.
• The target type is neither GCTGT_FIRMWARE_CHAN nor GCTGT_FIRMWARE_NETIF (that is, the parameters are not maintained in the firmware).

Figure 39 shows the procedure for getting or setting line device configuration in synchronous mode.

Figure 39. Getting or Setting Line Device Configuration in Synchronous Mode

The following describes the procedure for getting or setting the configuration of a Line Device:

1. Open the line device (by calling the gc_OpenEx( ) function) and get the line device ID.
2. If the parameters of the line device are protocol CDP parameters, use an approach similar to getting the CDP parameter ID described in the "Getting or Setting Protocol Configuration in Synchronous Mode" section.
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. See the Global Call API Library Reference for more information on the utility functions.
4. Call the gc_GetConfigData( ) or gc_SetConfigData( ) function with:
   target_type = GCTGT_CCLIB_NETIF,GCTGT_PROTOCOL_NETIF, GCTGT_CCLIB_CHAN or GCTGT_PROTCOL_CHAN
   target_id = Global Call line device ID
   time_out > 0
   mode = EV_SYNC
   update condition = GCUPATE_IMMEDIATE (gc_SetConfigData( ) function only)
5. If the gc_GetConfigData( ) function returns successfully, 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 then correct it.

Click here to contact Telecom Support Resources