Global Call API for HMP on Windows Programming Guide – August 2006 5
Contents
8.2.1 Generation of Events for Blocking Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
8.2.2 Generation of Alarm Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
8.2.3 Configuration of Alarm Properties and Characteristics. . . . . . . . . . . . . . . . . . . . 101
8.2.4 Starting and Stopping Alarm Transmission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
8.2.5 Retrieving Alarm Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
8.3 Sample Ala rm Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
8.3.1 Scenario 1: Application Notified of First and Last Blocking Alarm . . . . . . . . . . . 105
8.3.2 Scenario 2: Default Behavior for Alarm Notification . . . . . . . . . . . . . . . . . . . . . . 107
8.3.3 Scenario 3: Alarm Transmission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
9 Real Time Configuration Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
9.1 Real Time Co nfiguration Manager Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
9.2 RTCM Comp onents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
9.2.1 Customer Application Using Global Call RTCM . . . . . . . . . . . . . . . . . . . . . . . . . 111
9.2.2 Global Call RTCM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
9.2.3 RTCM Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
9.3 Using RTCM Par ameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
9.3.1 Parameter Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
9.3.2 Parameter Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
9.4 Getting a nd Setting Parameter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
9.4.1 GC_PARM_BLK Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
9.4.2 Control Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
9.5 Handling R TCM Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
9.6 Configura tion Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
9.7 Sample Scen arios Using the RTCM API Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
9.7.1 Getting or Setting GCLib Configuration in Synchronous Mode. . . . . . . . . . . . . . 119
9.7.2 Getting or Setting CCLib Configuration in Synchronous Mode. . . . . . . . . . . . . . 120
9.7.3 Getting or Setting Line Device Configuration in Synchronous Mode . . . . . . . . . 121
9.7.4 Setting Line Device Configuration in Asynchronous Mode. . . . . . . . . . . . . . . . . 123
9.7.5 Setting Board Device Configuration in Asynchronous Mode (IP Technology) . . 124
10 Handling Service Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
10.1 Service Request Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
10.2 Service Request Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
10.3 Service Request Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
10.4 General Service Request Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
11 Using Global Call to Implement Call Transfer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
11.1 Introduction to Call Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
11.1.1 Blind Call Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
11.1.2 Supervised Call Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
11.2 Call Transfer State Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 32
12 Building Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
12.1 Compiling and Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
12.1.1 Include Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
12.1.2 Required Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
12.1.3 Variables for Compiling and Linking Commands . . . . . . . . . . . . . . . . . . . . . . . . 140
12.1.4 Dynamically Loaded Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
13 Debugging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141