1.9. Run Time Configuration Management

The Global Call Run Time Configuration Management (RTCM) feature allows the dynamic modification of call control-related elements as well as protocol-related parameters.

Note: When developing applications that use DM3 boards, RTCM is not supported. However, some RTCM capabilities are achieved by other means as described in the sections following.

There are three Global Call RTCM functions:

• gc_GetConfigData( ) - used to obtain configuration parameter data for a given target object
• gc_SetConfigData( ) - used to update configuration parameter data for a given target object
• gc_QueryConfigData( ) - used to obtain other related data based on the source data from a target object

Target objects are identified by the target_type parameter, which consists of the type of physical entity (for example, a board device) and the software module that controls it (for example, cclib), and the target_id parameter, which is the identifier of the specific target object (for example, a line device ID). The target_datap parameter specifies the pointer to the GC_PARM_BLK structure. The structure contains the parameter configuration data to be retrieved or updated. It is the Global Call application's responsibility to allocate an appropriate-size data block memory for the configuration parameters (GC_PARM_BLK) and to insert parameter information (such as the set ID, parm ID, value buffer size, value buffer, and value data) into the GC_PARM_BLK data block.

The sections below provide a list of ISDN parameters that can be retrieved or updated using the RCTM functions. The table lists all the parameters and type of value_buf in the target_datap (of type GC_PARM_BLK) argument of the gc_GetConfigData() and gc_SetConfigData() functions. The set and parameter IDs are described in Chapter 4, ISDN-Specific Parameter Set Reference.

Click here to contact Telecom Support Resources