Global Call API for HMP on Windows Programming Guide — August 2006 109
9
9.Real Time Configuration
Management
This chapter describes the Global Call Real Time Configuration Manager (RTCM). Topics include
the following:
•Real Time Configuration Manager Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
•RTCM Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
•Using RTCM Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
•Getting and Setting Parameter Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
•Handling RTCM Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
•Configuration Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
•Sample Scenarios Using the RTCM API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

9.1 Real Time Configuration Manager Overview

The Global Call Real Time Configuration Management (RTCM) system manages run time
configuration for Global Call components. The RTCM feature is used when the application needs
to retrieve (E1, T1 and ISDN technology only) or modify (all technologies) configuration data. If
the configuration data is not modified, the application uses the initial values for the configuration.
Note: Not all technologies support the RTCM feature. Refer to the appropriate Global Call Technology
Guide to determine if RTCM is supported.
The Global Call RTCM system allows applications to:
•Get (E1, T1 or ISDN technologies only) or set (all technologies) the configuration of a
protocol dynamically. For example, the default values of CDP parameters can be retrieved or
updated with new values.
•Get (E1, T1 or ISDN technologies only) or set (all technologies) the configuration of a
physical or logical entity dynamically. The entity can be a system (that is, all boards), board,
network interface, channel, or call.
•Get (E1, T1 or ISDN technologies only) or set (all technologies) the configuration of a call
control library dynamically. For example, the default call state mask value of a channel can be
retrieved or updated with a new value.
•Query (E1, T1 or ISDN technologies only) the protocol ID from the given protocol name or
CDP parameter ID from the given CDP parameter name.
In addition, the RTCM feature provides Global Call applications with the ability to retrieve
configuration parameter information. Some of the ways this information can be used include:
•Efficient network management