You are on page 1of 530

Global Call Country Dependent Parameters (CDP) Reference

Copyright 2002 Intel Corporation 05-0870-006

COPYRIGHT NOTICE
Copyright 2002 Intel Corporation. All Rights Reserved. Information in this document is provided in connection with Intel products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes no liability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warranties relating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel products are not intended for use in medical, life saving, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice. This document as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without express written consent of Intel Corporation. Some names, products, and services mentioned herein are the trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other names and brands may be claimed as the property of others. Publication Date: July, 2002 Part Number: 05-0870-006 Intel Converged Communications, Inc. 1515 Route 10 Parsippany NJ 07054 For Technical Support, visit the Intel Telecom Support Resources website at: http://developer.intel.com/design/telecom/support/ For Products and Services Information, visit the Intel Communications Systems Products website at: http://www.intel.com/network/csp/ For Sales Offices and other contact information, visit the Intel Telecom Building Blocks Sales Offices page at: http://www.intel.com/network/csp/sales/

Table of Contents
1. How to Use This Guide.................................................................................... 1 1.1. Parameter Files ............................................................................................... 2 1.2. Protocol File Naming Convention .................................................................. 2 1.3. Protocols Supported........................................................................................ 4 1.4. Retrieving the Protocol Version for SpringWare Applications .................... 16 Protocol Version String Format ...................................................................... 17 Retrieving the Version String in Linux Systems ............................................. 17 Retrieving the Version String in Windows Systems ....................................... 17 Retrieving the Version String Using the Global Call API............................... 18 2. Alcatel 4400 Switch E-1 FXS Bidirectional for PDKRT ............................ 21 2.1. Protocol Limitations ..................................................................................... 22 2.2. Inbound and Outbound Parameters............................................................... 22 3. Alcatel VPS for 4x00 Switch Bidirectional for PDKRT ............................. 25 3.1. Protocol Limitations ..................................................................................... 25 3.2. Inbound and Outbound Parameters............................................................... 26 4. Argentina R2 Bidirectional for PDKRT ...................................................... 29 4.1. Protocol Limitations ..................................................................................... 30 4.2. R2 Inbound and Outbound Parameters ......................................................... 30 5. Argentina R2 for ICAPI................................................................................ 35 5.1. Protocol Limitations ..................................................................................... 35 5.2. R2 Inbound Parameters................................................................................. 36 5.3. R2 Outbound Parameters .............................................................................. 37 6. Argentina R2 Bidirectional for ICAPI ......................................................... 39 6.1. Protocol Limitations ..................................................................................... 39 6.2. R2 Inbound and Outbound Parameters ......................................................... 40 7. Australia R2 for ICAPI ................................................................................. 43 7.1. Protocol Limitations ..................................................................................... 43 7.2. R2 Inbound Parameters................................................................................. 44 7.3. R2 Outbound Parameters .............................................................................. 44 8. Austria E-1 for ICAPI ................................................................................... 47 8.1. Protocol Limitations ..................................................................................... 47 8.2. E-1 Inbound Parameters ............................................................................... 48 8.3. E-1 Outbound (CO Emulation) Parameters .................................................. 48
iii

Global Call Country Dependent Parameters (CDP) Reference

9. Belgium R2 Inbound/DTMF Outbound for ICAPI .................................... 51 9.1. Protocol Limitations ..................................................................................... 52 9.2. R2 Inbound Parameters................................................................................. 52 9.3. DTMF Outbound Parameters ....................................................................... 53 10. Belgium CO Emulation for ICAPI ............................................................. 55 10.1. Protocol Limitations ................................................................................... 55 10.2. DTMF Inbound Parameters ........................................................................ 55 10.3. R2 Outbound Parameters ............................................................................ 56 11. Brazil R2 Bidirectional for PDKRT ........................................................... 59 11.1. Protocol Limitations ................................................................................... 60 11.2. R2 Inbound and Outbound Parameters ....................................................... 60 12. Brazil R2 for ICAPI .................................................................................... 67 12.1. Protocol Limitations ................................................................................... 67 12.2. R2 Inbound Parameters............................................................................... 68 12.3. R2 Outbound Parameters ............................................................................ 71 13. Brazil R2 Bidirectional for ICAPI ............................................................. 75 13.1. Protocol Limitations ................................................................................... 75 13.2. R2 Inbound and Outbound Parameters ....................................................... 75 14. Bulgaria R2 for ICAPI ................................................................................ 79 14.1. Protocol Limitations ................................................................................... 79 14.2. R2 Inbound Parameters............................................................................... 79 14.3. R2 Outbound Parameters ............................................................................ 80 15. CCITT R2 Bidirectional for PDKRT ......................................................... 83 15.1. Protocol Limitations ................................................................................... 83 15.2. Inbound and Outbound Parameters............................................................. 84 16. Chile R2 Bidirectional for ICAPI ............................................................... 87 16.1. Protocol Limitations ................................................................................... 87 16.2. R2 Inbound and Outbound Parameters ....................................................... 87 17. China R2 Bidirectional for PDKRT ........................................................... 91 17.1. Protocol Limitations ................................................................................... 92 17.2. R2 Inbound and Outbound Parameters ....................................................... 92 18. China R2 for ICAPI .................................................................................... 97 18.1. Protocol Limitations ................................................................................... 97 18.2. R2 Inbound Parameters............................................................................... 98 18.3. R2 Outbound Parameters .......................................................................... 101

iv

Table of Contents

19. China R2 Bidirectional for ICAPI ........................................................... 105 19.1. Protocol Limitations ................................................................................. 105 19.2. R2 Inbound and Outbound Parameters ..................................................... 106 20. Colombia R2 Bidirectional for PDKRT ................................................... 109 20.1. Protocol Limitations ................................................................................. 110 20.2. R2 Inbound and Outbound Parameters ..................................................... 110 21. Colombia R2 for ICAPI ............................................................................ 115 21.1. Protocol Limitations ................................................................................. 115 21.2. R2 Inbound Parameters............................................................................. 115 21.3. R2 Outbound Parameters .......................................................................... 116 22. Croatia R2 for ICAPI ................................................................................ 119 22.1. Protocol Limitations ................................................................................. 119 22.2. R2 Inbound Parameters............................................................................. 119 22.3. R2 Outbound Parameters .......................................................................... 120 23. Czech Republic R2 for ICAPI .................................................................. 123 23.1. Protocol Limitations ................................................................................. 123 23.2. R2 Inbound Parameters............................................................................. 123 23.3. R2 Outbound Parameters .......................................................................... 124 24. Czech Republic R2 Bidirectional for ICAPI ........................................... 127 24.1. Protocol Limitations ................................................................................. 127 24.2. R2 Inbound and Outbound Parameters ..................................................... 128 25. DC5A Delay Start Bidirectional for ICAPI ............................................. 131 25.1. Protocol Limitations ................................................................................. 131 25.2. R2 Inbound and Outbound Parameters ..................................................... 132 26. DC5A Immediate Start Bidirectional for ICAPI .................................... 135 26.1. Protocol Limitations ................................................................................. 135 26.2. R2 Inbound and Outbound Parameters ..................................................... 136 27. DC5A Wink Start Bidirectional for ICAPI ............................................. 139 27.1. Protocol Limitations ................................................................................. 139 27.2. R2 Inbound and Outbound Parameters ..................................................... 140 28. Finland R2 Bidirectional for PDKRT ...................................................... 143 28.1. Protocol Limitations ................................................................................. 144 28.2. R2 Inbound and Outbound Parameters ..................................................... 144 29. Finland R2 for ICAPI................................................................................ 149 29.1. Protocol Limitations ................................................................................. 149
v

Global Call Country Dependent Parameters (CDP) Reference

29.2. R2 Inbound Parameters............................................................................. 150 29.3. R2 Outbound Parameters.......................................................................... 151 30. France E-1 for ICAPI................................................................................ 153 30.1. Protocol Limitations ................................................................................. 153 30.2. MF Socotel E-1 Inbound Parameters ........................................................ 154 30.3. MF Socotel E-1 Outbound CO Emulation Parameters ............................. 154 31. Georgia R2 for ICAPI ............................................................................... 157 31.1. Protocol Limitations ................................................................................. 157 31.2. R2 Inbound Parameters............................................................................. 157 32. Greece E-1 for ICAPI ................................................................................ 159 32.1. Protocol Limitations ................................................................................. 159 32.2. E-1 Inbound Parameters ........................................................................... 160 32.3. E-1 Outbound Parameters ......................................................................... 161 33. Hong Kong DTMF Bidirectional for PDKRT ......................................... 163 33.1. Protocol Limitations ................................................................................. 164 33.2. Inbound and Outbound Parameters........................................................... 164 34. Hungary R2 for ICAPI.............................................................................. 165 34.1. Protocol Limitations ................................................................................. 165 34.2. R2 Inbound Parameters............................................................................. 166 34.3. R2 Outbound Parameters .......................................................................... 166 35. India R2 Bidirectional for PDKRT .......................................................... 169 35.1. Protocol Limitations ................................................................................. 170 35.2. R2 Inbound and Outbound Parameters ..................................................... 170 36. India R2 for ICAPI .................................................................................... 175 36.1. Protocol Limitations ................................................................................. 175 36.2. R2 Inbound Parameters............................................................................. 176 36.3. R2 Outbound Parameters .......................................................................... 177 37. Indonesia E&M for ICAPI ....................................................................... 179 37.1. Protocol Limitations ................................................................................. 179 37.2. E-1 E&M Inbound Parameters ................................................................. 180 37.3. E-1 E&M Outbound Parameters ............................................................... 181 38. Indonesia E&M Bidirectional for PDKRT .............................................. 185 38.1. Protocol Limitations ................................................................................. 186 38.2. Inbound and Outbound Parameters........................................................... 186 39. Indonesia R2 for ICAPI ............................................................................ 189

vi

Table of Contents

39.1. Protocol Limitations ................................................................................. 189 39.2. R2 Inbound Parameters - Answer Signal Used ......................................... 190 39.3. R2 Outbound Parameters - Answer Signal Used ...................................... 191 39.4. R2 Inbound Parameters - Answer Signal Not Used .................................. 192 39.5. R2 Outbound Parameters - Answer Signal Not Used ............................... 193 40. Israel R2 Bidirectional for PDKRT ......................................................... 195 40.1. Protocol Limitations ................................................................................. 196 40.2. R2 Inbound and Outbound Parameters ..................................................... 196 41. Israel R2 for ICAPI ................................................................................... 201 41.1. Protocol Limitations ................................................................................. 201 41.2. R2 Inbound Parameters............................................................................. 202 41.3. R2 Outbound Parameters .......................................................................... 203 42. Israel R2 CO Emulation for ICAPI ......................................................... 205 42.1. Protocol Limitations ................................................................................. 205 42.2. R2 Inbound Parameters............................................................................. 205 42.3. R2 Outbound Parameters .......................................................................... 206 43. Italy E-1 Bidirectional for PDKRT .......................................................... 209 43.1. Protocol Limitations ................................................................................. 210 43.2. E-1 Inbound and Outbound Parameters .................................................... 210 44. Italy E-1 for ICAPI .................................................................................... 213 44.1. Protocol Limitations ................................................................................. 213 44.2. Inbound Parameters .................................................................................. 214 44.3. Outbound Parameters................................................................................ 215 45. Kazakhstan R2 for ICAPI......................................................................... 217 45.1. Protocol Limitations ................................................................................. 217 45.2. R2 Inbound Parameters............................................................................. 217 45.3. R2 Outbound Parameters .......................................................................... 218 46. Korea R2 for ICAPI .................................................................................. 221 46.1. Protocol Limitations ................................................................................. 221 46.2. R2 Inbound Parameters............................................................................. 222 46.3. R2 Outbound Parameters .......................................................................... 222 47. Korea R2 Bidirectional for PDKRT ........................................................ 225 47.1. Protocol Limitations ................................................................................. 225 47.2. Inbound and Outbound Parameters........................................................... 226 48. Kuwait R2 for ICAPI ................................................................................ 229 48.1. Protocol Limitations ................................................................................. 229
vii

Global Call Country Dependent Parameters (CDP) Reference

48.2. R2 Inbound Parameters............................................................................. 230 48.3. R2 Outbound Parameters .......................................................................... 231 49. Latvia R2 for ICAPI .................................................................................. 233 49.1. Protocol Limitations ................................................................................. 233 49.2. R2 Inbound Parameters............................................................................. 233 49.3. R2 Outbound Parameters .......................................................................... 234 50. Lebanon R2 for ICAPI .............................................................................. 237 50.1. Protocol Limitations ................................................................................. 237 50.2. R2 Inbound Parameters............................................................................. 237 50.3. R2 Outbound Parameters .......................................................................... 238 51. Lithuania R2 for ICAPI ............................................................................ 241 51.1. Protocol Limitations ................................................................................. 241 51.2. R2 Inbound Parameters............................................................................. 241 51.3. R2 Outbound Parameters .......................................................................... 242 52. Lucent Lineside E-1 Bidirectional for PDKRT ....................................... 245 52.1. Protocol Limitations ................................................................................. 246 52.2. Inbound and Outbound Parameters........................................................... 246 53. Malaysia R2 for ICAPI ............................................................................. 249 53.1. Protocol Limitations ................................................................................. 249 53.2. R2 Inbound Parameters............................................................................. 250 53.3. R2 Outbound Parameters .......................................................................... 250 54. Malaysia R2 Bidirectional for PDKRT .................................................... 253 54.1. Protocol Limitations ................................................................................. 254 54.2. Inbound and Outbound Parameters........................................................... 254 55. Malta R2 for ICAPI................................................................................... 257 55.1. Protocol Limitations ................................................................................. 257 55.2. R2 Inbound Parameters............................................................................. 258 55.3. R2 Outbound Parameters .......................................................................... 259 56. MELCAS Bidirectional Terminal Equipment for ICAPI ...................... 261 56.1. Protocol Limitations ................................................................................. 262 56.2. R2 Inbound and Outbound Parameters ..................................................... 262 57. MELCAS Network Side for ICAPI .......................................................... 265 57.1. Protocol Limitations ................................................................................. 265 57.2. R2 Inbound and Outbound Parameters ..................................................... 266 58. Mexico R2 Bidirectional for PDKRT ....................................................... 269

viii

Table of Contents

58.1. Protocol Limitations ................................................................................. 270 58.2. R2 Inbound and Outbound Parameters ..................................................... 270 59. Mexico R2 for ICAPI ................................................................................ 275 59.1. Protocol Limitations ................................................................................. 275 59.2. R2 Inbound Parameters............................................................................. 275 59.3. R2 Outbound Parameters .......................................................................... 276 60. Mexico R2 Bidirectional for ICAPI ......................................................... 279 60.1. Protocol Limitations ................................................................................. 279 60.2. R2 Inbound and Outbound Parameters ..................................................... 279 61. Morocco R2 for ICAPI .............................................................................. 283 61.1. Protocol Limitations ................................................................................. 283 61.2. R2 Inbound Parameters............................................................................. 284 61.3. R2 Outbound Parameters .......................................................................... 285 62. Netherlands Bidirectional Terminal Equipment Side for ICAPI .......... 287 62.1. Protocol Limitations ................................................................................. 288 62.2. R2 Inbound and Outbound Parameters ..................................................... 288 63. Netherlands Network Side for ICAPI ...................................................... 291 63.1. Protocol Limitations ................................................................................. 291 63.2. R2 Inbound and Outbound Parameters ..................................................... 292 64. Nigeria R2 for ICAPI ................................................................................ 295 64.1. Protocol Limitations ................................................................................. 295 64.2. R2 Inbound Parameters............................................................................. 296 64.3. R2 Outbound Parameters .......................................................................... 297 65. Nortel Meridian Lineside E-1 Bidirectional for PDKRT ....................... 299 65.1. Protocol Limitations ................................................................................. 300 65.2. Inbound and Outbound Parameters........................................................... 300 66. North American Analog Bidirectional for PDKRT ................................ 303 66.1. Protocol Limitations ................................................................................. 303 66.2. Inbound and Outbound Parameters........................................................... 304 67. Norway R2 for ICAPI ............................................................................... 307 67.1. Protocol Limitations ................................................................................. 307 67.2. R2 Inbound Parameters............................................................................. 308 67.3. R2 Outbound Parameters.......................................................................... 309 68. Pakistan R2 Bidirectional for PDKRT .................................................... 311 68.1. Protocol Limitations ................................................................................. 312

ix

Global Call Country Dependent Parameters (CDP) Reference

68.2. Inbound and Outbound Parameters........................................................... 312 69. Philippines R2 for ICAPI .......................................................................... 315 69.1. Protocol Limitations ................................................................................. 315 69.2. R2 Inbound Parameters............................................................................. 316 69.3. R2 Outbound Parameters .......................................................................... 317 70. Philippines R2 Bidirectional for PDKRT ................................................ 319 70.1. Protocol Limitations ................................................................................. 320 70.2. Inbound and Outbound Parameters........................................................... 320 71. Poland R2 for ICAPI ................................................................................. 323 71.1. Protocol Limitations ................................................................................. 323 71.2. R2 Inbound Parameters............................................................................. 324 71.3. R2 Outbound Parameters .......................................................................... 325 72. Portugal R2 for ICAPI .............................................................................. 327 72.1. Protocol Limitations ................................................................................. 327 72.2. R2 Inbound Parameters............................................................................. 328 72.3. R2 Outbound Parameters .......................................................................... 329 73. Romania R2 for ICAPI ............................................................................. 331 73.1. Protocol Limitations ................................................................................. 331 73.2. R2 Inbound Parameters............................................................................. 332 73.3. R2 Outbound Parameters .......................................................................... 333 74. Saudi Arabia R2 for ICAPI ...................................................................... 335 74.1. Protocol Limitations ................................................................................. 335 74.2. R2 Inbound Parameters............................................................................. 336 74.3. R2 Outbound Parameters .......................................................................... 337 75. Singapore R2 for ICAPI............................................................................ 339 75.1. Protocol Limitations ................................................................................. 339 75.2. R2 Inbound Parameters............................................................................. 340 75.3. R2 Outbound Parameters .......................................................................... 340 76. Singapore R2 Bidirectional for PDKRT .................................................. 343 76.1. Protocol Limitations ................................................................................. 344 76.2. Inbound and Outbound Parameters........................................................... 344 77. Slovakia R2 for ICAPI .............................................................................. 347 77.1. Protocol Limitations ................................................................................. 347 77.2. R2 Inbound Parameters............................................................................. 348 77.3. R2 Outbound Parameters .......................................................................... 349

Table of Contents

78. South Africa R2 for ICAPI ....................................................................... 351 78.1. Protocol Limitations ................................................................................. 351 78.2. R2 Inbound Parameters............................................................................. 352 78.3. R2 Outbound Parameters .......................................................................... 353 79. South Africa R2 (CO Emulation) for ICAPI ........................................... 355 79.1. Protocol Limitations ................................................................................. 355 79.2. R2 Inbound Parameters............................................................................. 356 79.3. R2 Outbound Parameters .......................................................................... 357 80. Spain E-1 for ICAPI .................................................................................. 361 80.1. Protocol Limitations ................................................................................. 361 80.2. E-1 Inbound Parameters ........................................................................... 362 80.3. E-1 Outbound Parameters ......................................................................... 362 81. Spain E-1 (2 of 6) for ICAPI ..................................................................... 365 81.1. Protocol Limitations ................................................................................. 365 81.2. E-1 Inbound Parameters ........................................................................... 366 81.3. E-1 Outbound Parameters ......................................................................... 367 82. Spain E-1 CO Emulation for ICAPI ........................................................ 369 82.1. Protocol Limitations ................................................................................. 369 82.2. E-1 Inbound Parameters ........................................................................... 370 82.3. E-1 Outbound Parameters ......................................................................... 371 83. Sweden P7 Bidirectional for PDKRT ...................................................... 373 83.1. Protocol Limitations ................................................................................. 373 83.2. Inbound and Outbound Parameters........................................................... 374 84. Sweden P7 PBX Bidirectional for PDKRT .............................................. 377 84.1. Protocol Limitations ................................................................................. 377 84.2. Inbound and Outbound Parameters........................................................... 378 85. Sweden CO Emulation for ICAPI ............................................................ 381 85.1. Protocol Limitations ................................................................................. 381 85.2. R2 Inbound Parameters............................................................................. 382 85.3. R2 Outbound Parameters .......................................................................... 383 86. Sweden E-1 for ICAPI............................................................................... 385 86.1. Protocol Limitations ................................................................................. 385 86.2. R2 Inbound Parameters............................................................................. 386 86.3. R2 Outbound Parameters .......................................................................... 387 87. Taiwan T-1 E&M Bidirectional for PDKRT .......................................... 389

xi

Global Call Country Dependent Parameters (CDP) Reference

87.1. Protocol Limitations ................................................................................. 389 87.2. Inbound and Outbound Parameters........................................................... 389 88. Taiwan Modified R1 Bidirectional for PDKRT ...................................... 391 88.1. Protocol Limitations ................................................................................. 392 88.2. Inbound and Outbound Parameters........................................................... 392 89. Taiwan T-1 for ICAPI ............................................................................... 393 89.1. Protocol Limitations ................................................................................. 393 89.2. Inbound Parameters .................................................................................. 393 89.3. Outbound Parameters................................................................................ 396 90. Thailand R2 TOT for ICAPI .................................................................... 399 90.1. Protocol Limitations ................................................................................. 399 90.2. R2 Inbound Parameters............................................................................. 400 90.3. R2 Outbound Parameters .......................................................................... 401 91. Thailand R2 CFT for ICAPI .................................................................... 403 91.1. Protocol Limitations ................................................................................. 403 91.2. R2 Inbound Parameters............................................................................. 404 91.3. R2 Outbound Parameters .......................................................................... 405 92. Thailand R2 Bidirectional for PDKRT .................................................... 407 92.1. Protocol Limitations ................................................................................. 408 92.2. Inbound and Outbound Parameters........................................................... 408 93. Tunisia R2 for ICAPI ................................................................................ 411 93.1. Protocol Limitations ................................................................................. 411 93.2. R2 Inbound Parameters............................................................................. 412 93.3. R2 Outbound Parameters .......................................................................... 413 94. Turkey E-1 (1-bit) Bidirectional for ICAPI ............................................. 415 94.1. Protocol Limitations ................................................................................. 415 94.2. E-1 E&M Inbound and Outbound Parameters .......................................... 416 95. Turkey E-1 (2-bits) Bidirectional for ICAPI ........................................... 421 95.1. Protocol Limitations ................................................................................. 421 95.2. E-1 E&M Inbound and Outbound Parameters .......................................... 422 96. United Kingdom E-1 CallStream for ICAPI ........................................... 427 96.1. Protocol Limitations ................................................................................. 427 96.2. R2 Inbound Parameters............................................................................. 428 96.3. R2 Outbound Parameters .......................................................................... 428 97. United Kingdom E-1 Mercury for ICAPI ............................................... 431

xii

Table of Contents

97.1. Protocol Limitations ................................................................................. 431 97.2. R2 Inbound Parameters............................................................................. 432 97.3. R2 Outbound Parameters .......................................................................... 432 98. United Kingdom E-1 Mercury Bidirectional for ICAPI ........................ 435 98.1. Protocol Limitations ................................................................................. 436 98.2. Inbound and Outbound Parameters........................................................... 436 99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD).......................................................................................................... 439 99.1. Protocol Limitations ................................................................................. 439 99.2. Inbound and Outbound Parameters........................................................... 440 100. United States T-1 FXS/LS Bidirectional for PDKRT ........................... 451 100.1. Protocol Limitations ............................................................................... 452 100.2. Modifiable Parameters............................................................................ 452 100.3. FXS Signaling Bit States ........................................................................ 456 100.4. FXS Call Scenarios................................................................................. 457 101. United States T-1 for ICAPI ................................................................... 463 101.1. Protocol Limitations ............................................................................... 463 101.2. Inbound Parameters ................................................................................ 463 101.2.1. Inbound Parameter Values for Feature Group Support .................. 467 101.3. Outbound Parameters.............................................................................. 467 101.3.1. Outbound Parameter Values for Feature Group Support ............... 469 102. United States T-1 Bidirectional for ICAPI ............................................ 471 102.1. Protocol Limitations ............................................................................... 471 102.2. Inbound and Outbound Parameters......................................................... 472 103. United States T-1 Rockwell for ICAPI .................................................. 477 103.1. Protocol Limitations ............................................................................... 477 103.2. Inbound Parameters ................................................................................ 478 103.3. Outbound Parameters.............................................................................. 479 104. Uzbekistan R2 for ICAPI ........................................................................ 481 104.1. Protocol Limitations ............................................................................... 481 104.2. R2 Inbound Parameters........................................................................... 482 104.3. R2 Outbound Parameters ........................................................................ 483 105. Uzbekistan R2 Bidirectional for ICAPI ................................................. 485 105.1. Protocol Limitations ............................................................................... 485 105.2. R2 Inbound and Outbound Parameters ................................................... 486 106. Venezuela R2 for ICAPI ......................................................................... 489
xiii

Global Call Country Dependent Parameters (CDP) Reference

106.1. Protocol Limitations ............................................................................... 489 106.2. R2 Inbound Parameters........................................................................... 490 106.3. R2 Outbound Parameters ........................................................................ 491 107. Vietnam R2 Bidirectional for PDKRT ................................................... 493 107.1. Protocol Limitations ............................................................................... 494 107.2. Inbound and Outbound Parameters......................................................... 494 108. Vietnam R2 for ICAPI ............................................................................ 497 108.1. Protocol Limitations ............................................................................... 497 108.2. R2 Inbound Parameters........................................................................... 498 108.3. R2 Outbound Parameters ........................................................................ 498 Index .................................................................................................................. 501

xiv

List of Tables
Table 1. Protocol File Naming Convention ........................................................... 3 Table 2. Protocols Supported ................................................................................ 4 Table 3. Alcatel 4400 Switch E-1 FXS Bidirectional for PDKRT Protocol Modules ....................................................................................................... 21 Table 4. Alcatel VPS for 4x00 Switch Bidirectional for PDKRT Protocol Modules ....................................................................................................... 25 Table 5. Argentina R2 Bidirectional for PDKRT Protocol Modul es................... 29 Table 6. Argentina R2 Protocol Modules ............................................................ 35 Table 7. Argentina R2 Bidirectional Protocol Modules ...................................... 39 Table 8. Australia R2 Protocol Modules ............................................................. 43 Table 9. Austria E-1 Protocol Modules ............................................................... 47 Table 10. Belgium R2 Inbound/DTMF Outbound Protocol Mod ules ................. 51 Table 11. Belgium R2 CO Emulation Protocol Modules .................................... 55 Table 12. Brazil R2 Bidirectional for PDKRT Protocol Modules ....................... 59 Table 13. Brazil R2 Protocol Modules ................................................................ 67 Table 14. Signaling Combinations....................................................................... 71 Table 15. Brazil R2 Bidirectional Protoc ol Modules .......................................... 75 Table 16. Bulgaria R2 Protocol Modules ............................................................ 79 Table 17. CCITT R2 Bidirectional for PDKRT Protocol Modules ..................... 83 Table 18. Chile R2 Bidirectional Protocol Modules ............................................ 87 Table 19. China R2 Bidirectional for PDKRT Protocol Modules ....................... 91 Table 20. CDP_CallingPartyCategory_KA Values for China ............................. 93 Table 21. China R2 for ICAPI Protocol Modules ............................................... 97 Table 22. China R2 Bidirectional for ICAPI Protocol Modules ........................ 105 Table 23. Colombia R2 Bidirectional for PDKRT Protocol Modules ............... 109 Table 24. Colombia R2 Protocol Modules ........................................................ 115 Table 25. Croatia R2 Protocol Modules ............................................................ 119 Table 26. Czech Republic R2 Protocol Modules ............................................... 123 Table 27. Czech R2 Bidirectional Protocol Modules ........................................ 127 Table 28. DC5A Delay Start Bidirectional Protocol Modules ........................... 131 Table 29. DC5A Immediate Start Protocol Modules ......................................... 135 Table 30. DC5A Wink Start Protocol Modules ................................................. 139 Table 31. Finland R2 Protocol Modules for PDKRT ........................................ 143 Table 32. Finland R2 Protocol Modules ............................................................ 149 Table 33. France E-1 MF Socotel Protocol Modules ........................................ 153 Table 34. Georgia R2 Protocol Modules ........................................................... 157

xv

Global Call Country Dependent Parameters (CDP) Reference

Table 35. Greece E-1 Protocol Modules ........................................................... 159 Table 36. Hong Kong DTMF Bidirectional for PDKRT Protocol Modules ..... 163 Table 37. Hungary R2 Protocol Modules .......................................................... 165 Table 38. India R2 Bidirectional for PDKRT Protocol Modules ...................... 169 Table 39. India R2 Protocol Modules ................................................................ 175 Table 40. Indonesia E&M Protocol Modules .................................................... 179 Table 41. Indonesia E&M Bidirectional for PDKRT Protocol Modules ........... 185 Table 42. Indonesia R2 Protocol Modules ........................................................ 189 Table 43. Israel R2 Protocol Modules for PDKRT ........................................... 195 Table 44. Israel R2 Protocol Modules ............................................................... 201 Table 45. Israel R2 CO Emulation Protocol Modules ....................................... 205 Table 46. Italy E-1 Protocol Modules for PDKRT ............................................ 209 Table 47. Italy E-1 Protocol Modules................................................................ 213 Table 48. Kazakhstan R2 Protocol Modules ..................................................... 217 Table 49. Korea R2 for ICAPI Protocol Modules ............................................. 221 Table 50. Korea R2 Bidirectional for PDKRT Protocol Modules ..................... 225 Table 51. Kuwait R2 Protocol Modules ............................................................ 229 Table 52. Latvia R2 Protocol Modules .............................................................. 233 Table 53. Lebanon R2 Protocol Modules .......................................................... 237 Table 54. Lithuania R2 Protocol Modules ......................................................... 241 Table 55. Lucent Lineside E-1 Bidirectional for PDKRT Protocol Modules .... 245 Table 56. Malaysia R2 Protocol Modules ......................................................... 249 Table 57. Malaysia R2 Bidirectional for PDKRT Protocol Modules ................ 253 Table 58. Malta R2 Protocol Modules............................................................... 257 Table 59. MELCAS Bidirectional Terminal Equipment Protocol Modules ...... 261 Table 60. MELCAS Network Side Protocol Modules....................................... 265 Table 61. Mexico R2 Bidirectional for PDKRT Protocol Modules .................. 269 Table 62. Mexico R2 Protocol Modules ............................................................ 275 Table 63. Mexico R2 Bidirectional Protocol Modules ...................................... 279 Table 64. Morocco R2 Protocol Modules ......................................................... 283 Table 65. Netherlands Bidirectional Terminal Equipment Protocol Modules ... 287 Table 66. Netherlands Network Side Protocol Modules.................................... 291 Table 67. Nigeria R2 Protocol Modules ............................................................ 295 Table 68. Nortel Meridian Lineside E-1 Bidirectional for PDKRT Protocol Modules ..................................................................................................... 299 Table 69. North American Analog Bidirectional for PDKRT Protocol Modules ..................................................................................................... 303 Table 70. Norway R2 Protocol Modules ........................................................... 307 Table 71. Pakistan R2 Bidirectional for PDKRT Protocol Modules ................. 311

xvi

List of Tables

Table 72. Philippines R2 Protocol Modules ...................................................... 315 Table 73. Philippines R2 Bidirectional for PDKRT Protocol Modules ............. 319 Table 74. Poland R2 Protocol Modules ............................................................. 323 Table 75. Portugal R2 Protocol Modules .......................................................... 327 Table 76. Romania R2 Protocol Modules.......................................................... 331 Table 77. Saudi Arabia R2 Protocol Modules ................................................... 335 Table 78. Singapore R2 Protocol Modules ........................................................ 339 Table 79. Singapore R2 Bidirectional for PDKRT Protocol Modules .............. 343 Table 80. Slovakia R2 Protocol Modules .......................................................... 347 Table 81. South Africa R2 Protocol Modules.................................................... 351 Table 82. South Africa R2 (CO Emulation) for ICAPI Protocol Modules ........ 355 Table 83. Spain E-1 for ICAPI Protocol Modules ............................................. 361 Table 84. Spain E-1 (2 of 6) for ICAPI Protocol Modules ................................ 365 Table 85. Spain E-1 CO Emulation for ICAPI Protocol Modules ..................... 369 Table 86. Sweden P7 Bidirectional for PDKRT Protocol Modules .................. 373 Table 87. Sweden P7 PBX Bidirectional Protocol for PDKRT Modules .......... 377 Table 88. Sweden CO Emulation R2 Protocol Modules.................................... 381 Table 89. Sweden E-1 Protocol Modules .......................................................... 385 Table 90. Taiwan T-1 E&M Bidirectional for PDKRT Protocol Modules ....... 389 Table 91. Taiwan Modified R1 Bidirectional for PDKRT Protocol Mod ules... 391 Table 92. Taiwan T-1 Protocol Modules ........................................................... 393 Table 93. Parameter Values for $22 .................................................................. 395 Table 94. Thailand R2 TOT Protocol Modules ................................................. 399 Table 95. Thailand R2 CFT Protocol Modules ................................................. 403 Table 96. Thailand R2 Bidirectional for PDKRT Protocol Mod ules ................ 407 Table 97. Tunisia R2 Protocol Modules ............................................................ 411 Table 98. Turkey E-1 (1-bit) Bidirectional for ICAPI Protocol Modules .......... 415 Table 99. Turkey E-1 (2-bit) Bidirectional for ICAPI Protocol Modules .......... 421 Table 100. United Kingdom E-1 CallStream Protocol Modules ....................... 427 Table 101. United Kingdom E-1 Mercury Protocol Modules............................ 431 Table 102. United Kingdom E-1 Mercury Bidirectional Protocol Modules ...... 435 Table 103. United States T-1 Bidirectional for PDKRT Protocol Modules ...... 439 Table 104. Parameter Values for Feature Groups A, B, and D .......................... 450 Table 105. United States T-1 FXS/LS Bidirectional for PDKRT Protocol Modules ..................................................................................................... 451 Table 106. FXS Signaling Bit States ................................................................. 456 Table 107. Outgoing Call from Voice Mail (FXS) ............................................ 457 Table 108. Incoming Call to Voice Mail (FXS) ................................................ 458 Table 109. Incoming Call to Voice Mail (FXS) and Transfer to Extension ...... 458

xvii

Global Call Country Dependent Parameters (CDP) Reference

Table 110. Incoming Call to Voice Mail (FXS) but Abandoned Before Transfer ...................................................................................................... 459 Table 111. Voice Mail (FXS) Disconnects Call ................................................ 460 Table 112. PBX (FXO) Disconnects Call.......................................................... 461 Table 113. United States T-1 Protocol Modules ............................................... 463 Table 114. Mask Bit Selections ......................................................................... 466 Table 115. Inbound Parameter Values for Feature Group Support ................... 467 Table 116. Outbound Parameter Values for Feature Group Support ................. 470 Table 117. United States T-1 Bidirectional Protocol Modules .......................... 471 Table 118. Mask Bit Selections ......................................................................... 476 Table 119. United States T-1 Rockwell Protocol Modules ............................... 477 Table 120. Uzbekistan R2 Protocol Modules .................................................... 481 Table 121. Uzbekistan R2 Bidirectional Protocol Modules .............................. 485 Table 122. Venezuela R2 Protocol Modules ..................................................... 489 Table 123. Vietnam R2 Bidirectional for PDKRT Protocol Modules ............... 493 Table 124. Vietnam R2 Protocol Modules ........................................................ 497

xviii

1. How to Use This Guide


This country dependent parameters (CDP) protocol reference manual is for users who use the Global Call Application Programming Interface (API) to develop Linux and Windows applications. Use this manual in conjunction with the Global Call API Library Reference and Global Call API Programming Guide for your operating system and with the Global Call Analog Technology Users Guide and Global Call E-1/T-1 Technology Users Guide. The information for each protocol is presented in individual chapters, listed alphabetically by type. This information includes the protocol files, any functions not supported by the particular protocol, the protocol name, and a description of each modifiable CDP parameter.
NOTE: Only the modifiable parameters in the .cdp file are listed and described.

The .cdp file contains additional parameters that are set to the value required to meet the approval of the local PTT and should not be changed. Each protocol is contained in a separate, modular binary file that can be installed and used as needed. User selectable options allow customization of the country dependent parameters to fit a particular application or configuration within a country (for example, switches within the same country may use the same protocol but may require different parameter values for local use). For the most up-todate list of available protocols, contact your nearest Intel Telecom Building Blocks Sales Office. Where differences exist between the implementation of a Global Call application in a Linux or Windows environment, these differences are indicated by qualifying specific items parenthetically or by presenting separate paragraphs/sections devoted to the implementation within a specific operating system environment.

Global Call Country Dependent Parameters (CDP) Reference

1.1. Parameter Files


The parameter files should be located only under the following installation directories: For Windows: .prm files - x:\program files\dialogic\data .cdp files - x:\program files\dialogic\cfg .psi files - x:\program files\dialogic\data .hot files - x:\program files\dialogic\cfg .qs files - x:\program files\dialogic\cfg

where x is a drive name. For Linux: .prm files - x:\usr\dialogic\data .cdp files - x:\usr\dialogic\cfg .psi files - x:\usr\dialogic\data .hot files - x:\usr\dialogic\cfg .qs files - x:\usr\dialogic\cfg

where x is a drive name.

1.2. Protocol File Naming Convention


When a protocol is installed on your system, several files are installed, including the protocol module(s), firmware parameter files, and country dependent parameter files. For most protocols, the files are named according to the convention in Table 1.

1. How to Use This Guide

Table 1. Protocol File Naming Convention File Name ccl_cc_tt_d.so or ccl_cc_tt_ffff_d.so ccl_cc_tt_d.dll or ccl_cc_tt_ffff_d.dll ccl_cc_tt_d.cdp or ccl_cc_tt_ffff_d.cdp ccl_cc_nn0.prm ccl_cc_tt.txt or cc_tt_ffff.txt ccl_cc_tt_d.psi or ccl_cc_tt_xxx_d.psi ccl_cc_tt_d.hot or ccl_cc_tt_xxx_d.hot ccl_cc_tt_d.qs or ccl_cc_tt_xxx_d.qs where: ccl indicates the call control library for which the protocol is written, for example, pdk represents the PDKRT call control library. For the ICAPI call control library, ccl is blank. cc is a two character ISO country code, regional code (for example, es = Spain, fr = France, mx = Mexico, na = North America etc.), or an indication of a switch-specific protocol. tt is a two character protocol type. Examples of valid types are: em - a T-1 protocol using E&M signaling with support for DTMF digits only mf - a T-1 protocol using E&M signaling with support for MF digits r2 - a protocol using R2MFC signaling Description shared ICAPI protocol module (for Linux systems) shared ICAPI protocol module (for Windows systems) country-dependent parameter file country-specific voice and network parameter file (SpringWare only) protocol package release note file (optional) SpringWare protocol state information file DM3 protocol files

Global Call Country Dependent Parameters (CDP) Reference

r1 - a protocol using R1MFC signaling e1 - a pulse, MF SOCOTEL, or other E-1 protocol sw - a protocol that is switch specific ls - a loop start protocol

ffff is optional and defines a special software or hardware feature supported by the protocol; 1 to 4 characters. If the protocol type is sw, then this field provides additional information about the switch. d is a one or two character direction indicator. Valid directions are: i - inbound o - outbound io - inbound/outbound

nn is the number of channels in a single span, typically 24 for T-1 and 30 for E-1.

1.3. Protocols Supported


The protocols supported are listed alphabetically by country or region in Table 2. The version released for each operating system is listed using the release number (for example, 1.00) followed by the release type (for example, Beta). In Table 2, CC is the two-character ISO country code or regional code.
NOTE: Unless otherwise noted, the inbound protocol for a country can be run

with the countrys outbound protocol on the same trunk. Table 2. Protocols Supported SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_sw_e1_a c4400_io Protocol Module Version

Country/ Protocol 1 Alcatel 4400 Switch E-1 FXS Bidirectional (PDKRT)

CC2 sw

pdk_sw_e1_fxs pdk_sw_e1_ac 5 _io 4400_io.cdp

1. How to Use This Guide

Country/ Protocol 1 Alcatel VPS 4x00 Bidirectional (PDKRT) Argentina R2 (ICAPI) Argentina R2 Bidirectional (ICAPI) Argentina R2 Bidirectional (PDKRT) Australia R2 (ICAPI) Austria E-1 (ICAPI)

CC2 sw

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name

Protocol Module Version

pdk_sw_vps_4 pdk_sw_vps_4 1 x00_io x00_io.cdp

ar ar

ar_r2_i ar_r2_o ar_r2_io

ar_r2_i.cdp ar_r2_o.cdp ar_r2_io.cdp

15 13 44

ar

pdk_ar_r2_io

pdk_r2_io

pdk_ar_r2_io. 11 cdp au_r2_i.cdp au_r2_o.cdp at_e1_i.cdp at_e1_o.cdp be_r2_o.cdp be_r2_i.cdp br_r2_i.cdp br_r2_o.cdp br_r2_io.cdp 7 6 4 4 44 44 12 7 44

au at

au_r2_i au_r2_o at_e1_i at_e1_o r2_out r2_in br_r2_i br_r2_o r2_io

Belgium DTMF be (ICAPI) Belgium R2 (ICAPI) Brazil R2 (ICAPI) Brazil R2 Bidirectional (ICAPI) Brazil R2 Bidirectional (PDKRT) be br br

br

pdk_br_r2_io

pdk_r2_io

pdk_br_r2_io. 11 cdp

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 Bulgaria R2 (ICAPI) CCITT R2 Bidirectional (PDKRT) Chile R2 Bidirectional (ICAPI) China R2 (ICAPI) China R2 Bidirectional (ICAPI) China R2 Bidirectional (PDKRT) Colombia R2 (ICAPI) Colombia R2 Bidirectional (PDKRT) Croatia R2 (ICAPI)

CC2 bg

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name r2_in r2_out bg_r2_i.cdp bg_r2_o.cdp

Protocol Module Version 44 44

ccitt pdk_ccitt_r2_i o cl

pdk_ccitt_r2_io pdk_ccitt_r2_i 3 o.cdp cl_r2_io cl_r2_io.cdp 9

cn cn

cn_r2_i cn_r2_o r2_io

cn_r2_i.cdp cn_r2_o.cdp cn_r2_io.cdp

20 12 44

cn

pdk_cn_r2_io

pdk_cn_r2_io

pdk_cn_r2_io. 3 cdp co_r2_i.cdp co_r2_o.cdp 44 44

co co

pdk_co_r2_io

r2_in r2_out pdk_r2_io

pdk_co_r2_io. 11 cdp hr_r2_i.cdp hr_r2_o.cdp cz_r2_i.cdp cz_r2_o.cdp cz_r2_io.cdp 44 44 44 44 44

hr

r2_in r2_out r2_in r2_out r2_io

Czech Republic cz R2 (ICAPI) Czech Republic cz R2 Bidirectional (ICAPI)

1. How to Use This Guide

Country/ Protocol 1 DC5A Delay Start (ICAPI)

CC2 NA

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name cas_io cas_io dc5ds_io.cdp dc5is_io.cdp

Protocol Module Version 12 12

NA DC5A Immediate Start Bidirectional (ICAPI) DC5A Wink Start Bidirectional (ICAPI) Finland R2 (ICAPI) Finland R2 Bidirectional (PDKRT) France E-1 (ICAPI) Georgia R2 (ICAPI) Greece E-1 (ICAPI) Hong Kong DTMF Bidirectional (PDKRT) Hungary R2 (ICAPI) NA

cas_io

dc5ws_io.cdp 12

fi fi

pdk_fi_r2_io

fi_r2_i fi_r2_o pdk_r2_io

fi_r2_i.cdp fi_r2_o.cdp

7 6

pdk_fi_r2_io.c 11 dp fr_e1_i.cdp fr_e1_o.cdp ge_r2_i.cdp gr_e1_i.cdp gr_e1_o.cdp 7 7 44 4 4

fr ge gr hk

pdk_hk_dtmf_ io

fr_e1_i fr_e1_o r2_in gr_e1_i gr_e1_o

pdk_hk_dtmf_i pdk_hk_dtmf_ 2 o io.cdp

hu

hu_r2_i hu_r2_o

hu_r2_i.cdp hu_r2_o.cdp

7 6

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 India R2 (ICAPI) India R2 Bidirectional (PDKRT)

CC2 in in

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_in_r2_io in_r2_i in_r2_o pdk_r2_io in_r2_i.cdp in_r2_o.cdp

Protocol Module Version 8 7

pdk_in_r2_io. 11 cdp id_em_i.cdp id_em_o.cdp 5 5

Indonesia E&M id (ICAPI) Indonesia E&M id Bidirectional (PDKRT) Indonesia R2 (with answer state) (ICAPI) Indonesia R2 (no answer state) (ICAPI) Israel R2 (ICAPI) Israel R2 CO Emulation (ICAPI) Israel R2 Bidirectional (PDKRT) Italy E-1 (ICAPI) Italy E-1 Bidirectional (PDKRT) id

pdk_id_em_io

id_em_i id_em_o pdk_id_em_io

pdk_id_em_io. 1 cdp id_r2_i.cdp id_r2_o.cdp id_r2_i1.cdp id_r2_o1.cdp il_r2_i.cdp il_r2_o.cdp il_co_i.cdp il_co_o.cdp 7 6 7 6 44 44 44 44

id_r2_i id_r2_o id_r2_i id_r2_o r2_in r2_out r2_in r2_out pdk_r2_io

id

il il

il

pdk_il_r2_io

pdk_il_r2_io.c 11 dp it_e1_i.cdp it_e1_o.cdp 5 5

it it

it_e1_i it_e1_o pdk_it_e1_io

pdk_it_e1_io.c 2 dp

1. How to Use This Guide

Country/ Protocol 1 Kazakhstan R2 (ICAPI) Korea R2 (ICAPI) Korea R2 Bidirectional (PDKRT) Kuwait R2 (ICAPI) Latvia R2 (ICAPI) Lebanon R2 (ICAPI) Lithuania R2 (ICAPI)

CC2 kz kr kr

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_kr_r2_io r2_in r2_out kr_r2_i kr_r2_o pdk_kr_r2_io kz_r2_i.cdp kz_r2_o.cdp kr_r2_i.cdp kr_r2_o.cdp

Protocol Module Version 44 44 10 8

pdk_kr_r2_io. 1 cdp kw_r2_i.cdp kw_r2_o.cdp lv_r2_i.cdp lv_r2_o.cdp lb_r2_i.cdp lb_r2_o.cdp lt_r2_i.cdp lt_r2_o.cdp 44 44 44 44 44 44 44 44

kw lv lb lt

pdk_sw_e1_lu ls_io

r2_in r2_out r2_in r2_out r2_in r2_out r2_in r2_out

Lucent Lineside sw E-1 Bidirectional (PDKRT) Malaysia R2 (ICAPI) Malaysia R2 Bidirectional (PDKRT) Malta R2 (ICAPI) my my

pdk_sw_e1_fxs pdk_sw_e1_lu 5 _io ls_io.cdp

pdk_my_r2_io

my_r2_i my_r2_o

my_r2_i.cdp my_r2_o.cdp

7 8

pdk_my_r2_io pdk_my_r2_io 2 .cdp r2_in r2_out mt_r2_i.cdp mt_r2_o.cdp 44 44

mt

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 MELCAS Bidirectional (ICAPI) MELCAS Network Side (ICAPI) Mexico R2 (ICAPI) Mexico R2 Bidirectional (ICAPI) Mexico R2 Bidirectional (PDKRT) Morocco R2 (ICAPI) Netherlands Network Bidirectional (ICAPI) Netherlands Terminal Bidirectional (ICAPI) Nigeria R2 (ICAPI)

CC2 mel

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name cas_io mel_io.cdp

Protocol Module Version 12

mel

cas_io

mel_nt_cdp

12

mx mx

mx_r2_i mx_r2_o r2_io

mx_r2_i.cdp mx_r2_o.cdp

12 11

mx_r2_io.cdp 44

mx

pdk_mx_r2_io

pdk_mx_r2_io pdk_mx_r2_io 2 .cdp r2_in r2_out cas_io ma_r2_i.cdp ma_r2_o.cdp alsnt_io.cdp 44 44 12

ma nl

nl

cas_io

alste_io.cdp

12

ng

r2_in r2_out

ng_r2_i.cdp ng_r2_o.cdp

44 44

10

1. How to Use This Guide

Country/ Protocol 1

CC2

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_sw_e1_nt md_io

Protocol Module Version

Nortel Meridian sw Lineside E-1 Bidirectional (PDKRT) North America Analog Bidirectional (PDKRT) Norway R2 (ICAPI) Pakistan R2 Bidirectional (PDKRT) Philippines R2 (ICAPI) Philippines R2 Bidirectional (PDKRT) Poland R2 (ICAPI) Portugal R2 (ICAPI) Romania R2 (ICAPI) na

pdk_sw_e1_fxs pdk_sw_e1_nt 5 _io md_io.cdp

pdk_na_an_io

pdk_na_an_io. 9 cdp

no pk

pdk_pk_r2_io

r2_in r2_out pdk_pk_r2_io

no_r2_i.cdp no_r2_o.cdp

44 44

pdk_pk_r2_io. 2 cdp ph_r2_i.cdp ph_r2_o.cdp 44 44

ph ph

pdk_ph_r2_io

r2_in r2_out pdk_ph_r2_io

pdk_ph_r2_io. 2 cdp po_r2_i.cdp po_r2_o.cdp pt_e1_i.cdp pt_e1_o.cdp ro_r2_i.cdp ro_r2_o.cdp sa_r2_i.cdp sa_r2_o.cdp sg_r2_i.cdp sg_r2_o.cdp 44 44 44 44 44 44 44 44 10 10

po pt ro

r2_in r2_out pt_e1_i pt_e1_o r2_in r2_out r2_in r2_out sg_r2_i sg_r2_o

Saudi Arabia R2 sa (ICAPI) Singapore R2 (ICAPI) sg

11

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 Singapore R2 Bidirectional (PDKRT) Slovakia R2 (ICAPI)

CC2 sg

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_sg_r2_io pdk_sg_r2_io

Protocol Module Version

pdk_sg_r2_io. 2 cdp sk_r2_i.cdp sk_r2_o.cdp za_r2_i.cdp za_r2_o.cdp za_co_i.cdp za_co_o.cdp es_e1_i.cdp es_e1_o.cdp es_26_i.cdp es_26_o.cdp es_co_i.cdp es_co_o.cdp se_co_i.cdp se_co_o.cdp se_e1_i.cdp se_e1_o.cdp 44 44 2 2 2 2 7 7 7 7 7 7 12 12 12 12

sk

r2_in r2_out za_r2_i za_r2_o za_r2_i za_r2_o es_e1_i es_e1_o es_e1_i es_e1_o es_e1_i es_e1_o cas_in cas_out cas_in cas_out pdk_se_p7_io

South Africa R2 za (ICAPI) South Africa R2 za CO Emulation (ICAPI) Spain E-1 (ICAPI) es

Spain E-1 2 of 6 es (ICAPI) Spain E-1 CO Emulation (ICAPI) Sweden CO Emulation (ICAPI) Sweden E-1 (ICAPI) Sweden P7 Bidirectional (PDKRT) es

se

se se

pdk_se_p7_io. 2 cdp

12

1. How to Use This Guide

Country/ Protocol 1 Sweden P7 PBX Bidirectional (PDKRT) Taiwan T-1 (ICAPI) Taiwan T-1 E&M Bidirectional (PDKRT) Taiwan Modified R1 Bidirectional (PDKRT) Thailand R2 CFT (ICAPI) Thailand R2 TOT (ICAPI) Thailand R2 Bidirectional (PDKRT) Tunisia R2 (ICAPI) Turkey E-1 1-bit Bidirectional (ICAPI)

CC2 se

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name

Protocol Module Version

pdk_se_p7_pbx pdk_se_p7_pb 2 _io x_io .cdp tw_mf_i tw_mf_o tw_mf_i.cdp tw_mf_o.cdp 3 3

tw tw

pdk_tw_em_io pdk_tw_em_io 2 .cdp

tw

pdk_tw_mr1_i o

pdk_tw_mr1_io pdk_tw_mr1_i 1 o.cdp

th th th

pdk_th_r2_io

r2_in r2_out r2_in r2_out pdk_th_r2_io

th_r2_ic.cdp th_r2_oc.cdp th_r2_i.cdp th_r2_o.cdp

44 44 44 44

pdk_th_r2_io. 2 cdp tn_r2_i.cdp tn_r2_o.cdp 44 44

tn tr

r2_in r2_out us_mf_io

tr_1bit_io.cdp 14

13

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 Turkey E-1 2-bits Bidirectional (ICAPI) United Kingdom E-1 Mercury Bidirectional (ICAPI) United Kingdom E-1 CallStream (ICAPI) United Kingdom E-1 Mercury (ICAPI) United States T-1 (ICAPI) United States T-1 Bidirectional (ICAPI) United States Loop Start FXS (PDKRT)

CC2 tr

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name us_mf_io

Protocol Module Version

tr_2bits_io.cd 14 p

uk

uk_mc_io

uk_mc_io.cdp 6

uk

uk_cs_i uk_cs_o

uk_cs_i.cdp uk_cs_o.cdp

4 4

uk

uk_mc_i uk_mc_o

uk_mc_i.cdp uk_mc_o.cdp

6 5

us us

us_mf_i us_mf_o us_mf_io

us_mf_i.cdp us_mf_o.cdp us_mf_io.cdp

25 24 14

us

pdk_us_ls_fxs _io

pdk_us_ls_fxs_ pdk_us_ls_fxs 9 io _io.cdp

14

1. How to Use This Guide

Country/ Protocol 1

CC2

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_us_mf_io pdk_us_mf_io

Protocol Module Version

us United States T-1 FGA/FGB/FGD /Loopstart Bidirectional (PDKRT) United States us T-1 Rockwell Switch (ICAPI) Uzbekistan R2 (ICAPI) Uzbekistan R2 Bidirectional (ICAPI) Venezuela R2 (ICAPI) Vietnam R2 (ICAPI) uz uz

pdk_us_mf_io. 12 cdp

us_rk_i us_rk_o r2_in r2_out r2_io

us_rk_i.cdp us_rk_o.cdp uz_r2_i.cdp uz_r2_o.cdp uz_r2_io.cdp

11 9 44 44 44

ve vn

r2_in r2_out vn_r2_i vn_r2_o

ve_r2_i.cdp v2_r2_o.cdp vn_r2_i.cdp vn_r2_o.cdp

44 44 4 4

15

Global Call Country Dependent Parameters (CDP) Reference

Country/ Protocol 1 Vietnam R2 Bidirectional (PDKRT)


1

CC2 vn

SpringWare DM3 Protocol Protocol CDP File Module Name3 Module Name3 Name pdk_vn_r2_io pdk_vn_r2_io

Protocol Module Version

pdk_vn_r2_io. 1 cdp

For the latest release or the most up-to-date list of available protocols, contact your nearest Intel Telecom Building Blocks Sales Office. Country code, the two-character ISO country code or regional code.

2 3

Base of the protocol module name, such as ar_r2_i. The full filename includes a suffix, which depends on the type of protocol module: PDK protocols: suffix .hot and .qs for DM3, suffix .psi for SpringWare Shared ICAPI protocol module objects (SpringWare only): suffix .so for Linux systems, suffix .dll for Windows systems

1.4. Retrieving the Protocol Version for SpringWare Applications


NOTE: The information in this section is for SpringWare users only and is not

applicable to DM3. Depending on the protocol type and operating system, the version number of a protocol may be embedded as a string in a .dll, .so (object), or .psi (PDKRT protocol state information) file. The following table shows the protocol module files associated with the ICAPI and PDKRT call control libraries on different operating systems.

Call Control Library ICAPI PDKRT


16

Linux

Windows

.so .psi

.dll .psi

1. How to Use This Guide

Protocol Version String Format On all platforms, the version string is in the following format: @(#) %filespec: ar_r2_i.c-15 % (%full_filespec: ar_r2_i.c-15:csrc:dnj5 %) This string indicates that the protocol version is 15. The following sections describe how this information can be obtained. Retrieving the Version String in Linux Systems Utilizing the strings utility, execute the following command on the ICAPI protocol module for which version information is desired. An example using the protocol for Argentina, ar_r2_o.so, is shown. strings ar_r2_o.so | grep ar_r2_o | grep filespec
NOTE: The strings utility cannot be used to retrieve the version string for a PDK

protocol. If you are using Dialogic System Release 5.0 or later, see also the section below about retrieving the protocol version using the Global Call API. Retrieving the Version String in Windows Systems If you have a Linux-compatible strings utility such as the one found in commercial products such as the MKS Toolkit, you may use the Linux procedure described above. If you do not have a strings utility, you may be able to obtain a free version on the Internet. For those with Microsoft Visual C++ 5.0 or later, the version string can be obtained in a more raw format using the dumpbin utility as shown. In this example, the utility uses the protocol for Argentina, ar_r2_o.so. dumpbin /rawdata ar_r2_o.o If you are using Dialogic System Release 5.0 or later, see also the section below about retrieving the protocol version using the Global Call API.
17

Global Call Country Dependent Parameters (CDP) Reference

Retrieving the Version String Using the Global Call API Support for the GCPR_PROTVER parameter was added to the gc_GetParm( ) function in System Release 5.0. This parameter makes it possible to retrieve the protocol version from a user program. The following example program retrieves and prints the version of a protocol.
#include <gclib.h> #include <gcerr.h> #include <srllib.h> int main() { LINEDEV ldev; GC_PARM parm; int retcode; METAEVENT metaevent; int gc_error; int cclibid; long cc_error; char* gc_msg; char* cc_msg; int mode = SR_STASYNC; parm.paddress = NULL; if (sr_setparm(SRL_DEVICE, SR_MODELTYPE, &mode) == -1) { /* Error processing */ } gc_Start(NULL); retcode=gc_Open(&ldev,":P_us_mf_io:N_dtiB1T1:V_dxxxB1C1", 0); if (retcode != GC_SUCCESS) /* Error processing */ sr_waitevt(50); if (retcode != GC_SUCCESS) { /* Error processing */ } if (metaevent.flags & GCME_GC_EVENT) { if (metaevent.evttype == GCEV_UNBLOCKED) { if (gc_GetParm(ldev, GCPR_PROTVER,&parm)==GC_SUCCESS) { printf("The protocol version: %s\n", parm.paddress); } else { /* Error processing */ gc_ErrorValue(&gc_error, &cclibid, &cc_error);

18

1. How to Use This Guide

gc_ResultMsg(LIBID_GC, (long)gc_error, &gc_msg); gc_ResultMsg(cclibid, cc_error, &cc_msg); printf("gc_GetParm(GCPR_PROTVER) failed! GC(0x%lx) - %s; CC(0x%lx) - %s\n", gc_error, gc_msg, cc_error, cc_msg); return (gc_error); } } } gc_Close(ldev); gc_Stop(); return(0); }

19

2. Alcatel 4400 Switch E-1 FXS Bidirectional for PDKRT


The Alcatel 4400 Switch E-1 FXS Bidirectional protocol is an OPS_FX protocol. The protocol modules and modifiable country dependent parameters (CDP) file (see Table 3) for the Alcatel 4400 Switch E-1 FXS Bidirectional protocol for PDKRT are described in this chapter. Table 3. Alcatel 4400 Switch E-1 FXS Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_sw_e1_ac 4400_io.hot pdk_sw_e1_ac 4400_io.qs SpringWare: pdk_sw_e1_fx s_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: fr_300.prm DM3 and SpringWare: pdk_sw_e1_ac 4400_io.cdp Windows DM3: pdk_sw_e1_ac 4400_io.hot pdk_sw_e1_ac 4400_io.qs SpringWare: pdk_sw_e1_fx s_io.psi SpringWare only: fr_300.prm DM3 and SpringWare: pdk_sw_e1_ac 4400_io.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

for handling inbound or outbound calls respectively. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

21

Global Call Country Dependent Parameters (CDP) Reference

2.1. Protocol Limitations


None.

2.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_sw_e1_ac4400_io CDP File Name: pdk_sw_e1_ac4400_io.cdp The modifiable parameters are: CDP_BlindXferTime: After sending the address digits on a BlindTransfer request, the FXS_IO protocol waits for the time specified by this parameter before sending CAS_ONHOOK and switching back to IDLE state. Value as released = 5000 (5 seconds). CDP_ConnectOnNoDialTone (Outbound): Determines how the protocol should proceed when dial tone is not detected. If the parameter is enabled (set to 1), and no dial tone is detected, a local collision with an inbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume local collision and disconnect the call if no dial tone is detected. 1 - Assume local collision and connect the perceived inbound call if no dial tone is detected (value as released). CDP_ConnectOnNoRingBack (Outbound): Determines how the protocol should proceed when no ringback tone is detected. If the parameter is enabled (set to 1), and no ringback is detected, a remote collision with a remote outbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume remote collision and disconnect the call if no ringback is detected. 1 Assume remote collision and connect the call if no ringback is detected (value as released).

22

2. Alcatel 4400 Switch E-1 FXS Bidirectional for PDKRT

CDP_DelayInDialling (Outbound): Specifies the delay time in dialing when the parameter CDP_WaitDialToneEnabled is not enabled. Value as released = 40. CDP_DialToneWaitTime (Outbound): Defines the time that the protocol waits for a dial tone before an outbound call can be made. This parameter is only applicable only if the WaitDialToneEnabled parameter is set to 1. If the time defined by this parameter is exceeded before dial tone is detected, the action taken depends on the value of the ConnectOnNoDialTone parameter as follows: If the ConnectOnNoDialTone parameter is set to 1, a local collision is assumed and the incoming call is connected. If the ConnectOnNoDialTone parameter is set to 0, the call attempt fails and a disconnect event is forwarded with a reason of no dial tone.

Value as released = 10000 (10 seconds). CDP_MinPBXHangupTime (Inbound): This parameter specifies the length of the ring cycle and is used to determine if the remote end (that is, the PBX) has dropped an incoming call. The value of this parameter is typically set to 6 seconds which corresponds to the complete ring cycle (2 seconds on and 4 seconds of silence). The timer is reset at the start of each ring cycle. If the timer expires without resetting, ringing has been acknowledged to stop indicating the PBX has dropped the call, as the caller has abandoned the call before it was answered. Value as released = 5000 (5 seconds). CDP_PBXDiscEnabled: Determines if the remote PBX can initiate call disconnection via CAS line signaling. Possible values are: 0 - Disable call disconnect supervision, since it is not supported by the PBX. 1 - Enable call disconnect supervision provided by the PBX(value as released). CDP_ProtocolStopsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) when the protocol stops after gc_Close( ). Possible values are: 0 - Set the hook switch state to OnHook(value as released). 1 - Set the hook switch state to OffHook.

23

Global Call Country Dependent Parameters (CDP) Reference

CDP_WaitDialToneEnabled (Outbound): Determines if the protocol should wait for a dial tone before dialing. Note this parameter does not apply to supervised transfers (consultation calls) in which case the dial tone is not verified. Possible values are: 0 - Do not wait for dial tone before dialing (value as released). 1 - Have the FXS wait for dial tone before dialing.

24

3. Alcatel VPS for 4x00 Switch Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 4) for the Alcatel VPS for 4x00 Switch Bidirectional Protocol for PDKRT are described in this chapter. Table 4. Alcatel VPS for 4x00 Switch Bidirectional for PDKRT Protocol Modules File Type Protocol Module Voice and Network Parameter Country Dependent Parameter Linux pdk_sw_vps_4 x00_io.psi r2_300.prm Windows pdk_sw_vps_4 x00_io.psi r2_300.prm Description The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

pdk_sw_vps_4 x00_io.cdp

pdk_sw_vps_4 x00_io.cdp

NOTES: 1. This protocol is supported on SpringWare boards only.

2. File names that have _io before the extension indicate a protocol file that can handle both inbound and outbound calls. 3. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

3.1. Protocol Limitations


None.

25

Global Call Country Dependent Parameters (CDP) Reference

3.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_sw_vps_4x00_io CDP File Name: pdk_sw_vps_4x00_io.cdp The modifiable parameters are: CDP_BlindXferTime: After sending the address digits on a BlindTransfer request, the FXS_IO protocol waits for the time specified by this parameter before sending CAS_ONHOOK and switching back to IDLE state. Value as released = 5000 (5 seconds). CDP_MinPBXHangupTime (Inbound): This parameter specifies the length of the ring cycle and is used to determine if the remote end (that is, the PBX) has dropped an incoming call. The value of this parameter is typically set to 6 seconds which corresponds to the complete ring cycle (2 seconds on and 4 seconds of silence). The timer is reset at the start of each ring cycle. If the timer expires without resetting, ringing has been acknowledged to stop indicating the PBX has dropped the call, as the caller has abandoned the call before it was answered. Value as released = 5000 (5 seconds). CDP_OnhookTime (Outbound): If FXS is outbound only and starts in the offhook state, it remains in the OFFHOOK state until it receives a MakeCall. This parameter specifies the time during which FXS should remain ONHOOK before processing the MakeCall. Value as released = 500 (0.5 seconds). CDP_PBXDiscEnabled: Determines if the remote PBX can initiate call disconnection via CAS line signaling. Possible values are: 0 - Disable call disconnect supervision, since it is not supported by the PBX. 1 - Enable call disconnect supervision provided by the PBX(value as released). CDP_PreDialingWaitMode: This parameter specifies the behavior of the FXS prior to dialing. Possible values are: 0 - Wait for CDP_PreDialingWaitTime specified timer. 1 - Wait for start dialing DTMF code from PBX(value as released).

26

3. Alcatel VPS for 4x00 Switch Bidirectional for PDKRT

CDP_PreDialingWaitTime: If CDP_PreDialingWaitMode is set to 0, the FXS will wait this specified time (milliseconds) prior to dialing. Value as released = 500 (0.5 seconds). CDP_ProtocolStartsOnHook: This parameter is used in following two conditions: When the protocol starts in the in-service outbound channel state When alarm is released and channel state requested is in-service outbound

Possible values are: 0 - Send CAS_OFFHOOK signal on the line. 1 - Send CAS_ONHOOK signal on the line (value as released). CDP_ProtocolStopsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) when the protocol stops after gc_Close( ). Possible values are: 0 - Set the hook switch state to OnHook(value as released). 1 - Set the hook switch state to OffHook.

27

4. Argentina R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 5) for the Argentina R2 Bidirectional for PDKRT Protocol is described in this chapter. Table 5. Argentina R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_ar_r2_io. hot pdk_ar_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: ar_300.prm DM3 and SpringWare: pdk_ar_r2_io. cdp Windows DM3: pdk_ar_r2_io. hot pdk_ar_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: ar_300.prm DM3 and SpringWare: pdk_ar_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

29

Global Call Country Dependent Parameters (CDP) Reference

4.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

4.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_ar_r2_io CDP File Name: pdk_ar_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol as released = 16.

30

4. Argentina R2 Bidirectional for PDKRT

NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. 0 - Request (inbound) or send (outbound) ANI digits without area code (value as released). 1 - Request (inbound) or send (outbound) area code with ANI digits. CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies whether ANI digits and area code are sent to the inbound side. 0 - The requested information denied tone is sent to the inbound side (value as released). 1 - ANI digits with area code are sent to the inbound. CDP_AreaCode: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the area code of the Local Exchange where the subscriber is connected. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. Some typical values are: 1 - Subscriber without priority (value as released) 2 - Subscriber with priority 3 - Maintenance equipment 4 - Coinbox or subscriber with charge metering 5 - Telephone Operator 6 - Data transmission 11 - C. P. T. P. 12 - Special line 13 - Mobile users 14 - Virtual private network line
31

Global Call Country Dependent Parameters (CDP) Reference

15 - Special line CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. Values are: 0 - Nonchargeable 1 - Chargeable (value as released) CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. At the inbound side, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. At the outbound side, ANI digits are passed directly or the inbound side is informed of the availability (status) first. 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side (value as released). 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request.

32

4. Argentina R2 Bidirectional for PDKRT

CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released).

CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Non-zero - The number of DNIS digits received before category information is received. 0 - Category has to be received after complete DNIS (value as released). If this parameter is set to non-zero, the following sequence of events applies: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED is 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3.

33

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: Non-zero - The number of ANI digits expected. This number should always be less than CDP_ANI_MaxDigits. 0 - ANI collection is terminated by an I-15 tone (value as released).

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: Non-zero - The number of DNIS digits. This value should always be less than CDP_DNIS_MaxDigits (value as released = 4). 0 - DNIS collection is terminated by an I-15 tone (value as released).

CDP_REJECT_WITH_A3B4 (Inbound): Determines if the call is rejected when an R2MF tone error is received during call setup. 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone, which means that the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then, the category is received and in response, a B-4 tone is sent to reject the call.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only.

CDP_TrunkPrefixNumber: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Trunk number used to dial to local exchange. Value as released = 9.

34

5. Argentina R2 for ICAPI


The protocol modules (see Table 6) and the modifiable inbound and outbound country dependent parameters (CDP) for the Argentina R2 Protocol for ICAPI are described in this chapter. Table 6. Argentina R2 Protocol Modules File Type Protocol Modules Linux ar_r2_i.so ar_r2_o.so ar_r2_i.dll ar_r2_o.dll Voice and Network Parameter Country Dependent Parameter ar_300.prm ar_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ar_r2_i.cdp ar_r2_o.cdp

ar_r2_i.cdp ar_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

5.1. Protocol Limitations


The following function is not supported by this protocol: gc_CallAck( )

35

Global Call Country Dependent Parameters (CDP) Reference

5.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ar_r2_i CDP File Name: ar_r2_i.cdp The modifiable parameters are: $4: Metering pulse length in 10-msec units. Value as released = 13. $6: Time-out for incoming calls in seconds. Value as released = 15. $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 8. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for idle pattern on the line. Value as released = 70. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0. $44: Set to 1 to enable quick release of the line at disconnection time. Release accomplished by sending the release pattern (parameter @57) on inbound disconnection. This speeds up release of the line and reduces the possibility of additional charges after terminal disconnection. Set to 0 to use normal disconnection procedure. Value as released = 1. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

36

5. Argentina R2 for ICAPI

Global Tone Detection Usage: None.

5.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ar_r2_o CDP File Name: ar_r2_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 40. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time between two rings in 10-msec units to detect answer. Value as released = 0. $4: Metering pulse length in 10-msec units. Value as released = 13. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $11: Time-out during digit in seconds for outbound calls. Value as released = 15. $12: Time-out between digits in seconds for outbound calls. Value as released = 24. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the

37

Global Call Country Dependent Parameters (CDP) Reference

GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ). condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

NOTE: This protocol does not require call analysis, because the called party

38

6. Argentina R2 Bidirectional for ICAPI


The protocol modules (see Table 7) and the modifiable inbound and outbound country dependent parameters (CDP) for the Argentina R2 Bidirectional Protocol for ICAPI are described in this chapter. Table 7. Argentina R2 Bidirectional Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol module to be dynamically loaded as required. r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

ar_300.prm

ar_300.prm

ar_r2_io.cdp

ar_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

6.1. Protocol Limitations


None.

39

Global Call Country Dependent Parameters (CDP) Reference

6.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: ar_r2_io CDP File Name: ar_r2_io.cdp The modifiable parameters are: $1 NDDI [I]: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI [I]: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $21 MAXRING [O]: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect a ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB [O]: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

40

6. Argentina R2 Bidirectional for ICAPI

Global Tone Detection Usage: Tone IDs 103-105 and 141 are used by this protocol.

41

7. Australia R2 for ICAPI


The protocol modules (see Table 8) and the modifiable inbound and outbound country dependent parameters (CDP) for the Australia R2 Protocol for ICAPI are described in this chapter. Table 8. Australia R2 Protocol Modules File Type Protocol Modules Linux au_r2_i.so au_r2_o.so au_r2_i.dll au_r2_o.dll Voice and Network Parameter Country Dependent Parameter au_300.prm au_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

au_r2_i.cdp au_r2_o.cdp

au_r2_i.cdp au_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

7.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
43

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

7.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: au_r2_i CDP File Name: au_r2_i.cdp The modifiable parameters are: $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

Global Tone Detection Usage: None.

7.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: au_r2_o CDP File Name: au_r2_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the

44

7. Australia R2 for ICAPI

application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 200. $1: Number of ringback tones before returning: GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between two rings to detect an answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 120. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 0.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ). Value as released = 60.

45

Global Call Country Dependent Parameters (CDP) Reference

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

46

8. Austria E-1 for ICAPI


The protocol modules (see Table 9) and the modifiable inbound and outbound country dependent parameters (CDP) for the Austria E-1 Protocol for ICAPI are described in this chapter. Table 9. Austria E-1 Protocol Modules File Type Protocol Modules Linux at_e1_i.so at_e1_o.so at_e1_i.dll at_e1_o.dll Voice and Network Parameter Country Dependent Parameter at_300.prm at_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

at_e1_i.cdp at_e1_o.cdp

at_e1_i.cdp at_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

8.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
47

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

8.2. E-1 Inbound Parameters


gc_Open( ) Protocol Name: at_e1_i CDP File Name: at_e1_i.cdp The modifiable parameters are: $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $11: Type of hardware, set to 1 if the protocol is to run on a D/300SC -E-1, set to 0 for a DTI/212-AT. Value as released = 1. This parameter must be set to 1. $14: DDI method: 0 for pulse, 1 for DTMF. Normal value is 0, pulse dialing. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

8.3. E-1 Outbound (CO Emulation) Parameters


gc_Open( ) Protocol Name: at_e1_o

Caution This protocol is not designed to work on the public network. It is intended to test the inbound protocol.

48

8. Austria E-1 for ICAPI

CDP File Name: at_e1_o.cdp


NOTE: This protocol requires call analysis. Maximum time for call analysis is

given in parameter $6 instead of $13, and there is no inter-ring delay detection. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 40. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $6: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 80. $11: Type of hardware, set to 1 if the protocol is to run on a D/300SC -E-1, set to 0 for a DTI/212-AT. Value as released = 0. This parameter must be set to 1. $14: DDI method: 0 for pulse, 1 for DTMF. Must match the inbound selection. Normal value is 0, pulse dialing. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

49

9. Belgium R2 Inbound/DTMF Outbound for ICAPI


The protocol modules (see Table 10) and the modifiable inbound and outbound country dependent parameters (CDP) for the Belgium R2 Protocol for ICAPI are described in this chapter. These protocols can be used on the public network, but not run against each other. Use the CO emulation protocols to test these protocols disconnected from the public network. Table 10. Belgium R2 Inbound/DTMF Outbound Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

be_r2_i.cdp be_r2_o.cdp

be_r2_i.cdp be_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

51

Global Call Country Dependent Parameters (CDP) Reference

9.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

9.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: be_r2_i CDP File Name: be_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified

52

9. Belgium R2 Inbound/DTMF Outbound for ICAPI

by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

9.3. DTMF Outbound Parameters


gc_Open( ) Protocol Name: be_r2_o CDP File Name: be_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

53

10. Belgium CO Emulation for ICAPI


The protocol modules (see Table 11) and the modifiable inbound country dependent parameters (CDP) for the Belgium R2 CO Emulation Protocol for ICAPI are described in this chapter. Table 11. Belgium R2 CO Emulation Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

be_co_i.cdp be_co_o.cdp

be_co_i.cdp be_co_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

10.1. Protocol Limitations


None.

10.2. DTMF Inbound Parameters


gc_Open( ) Protocol Name: be_co_i

55

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: be_co_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

10.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: be_co_o CDP File Name: be_co_o.cdp

56

10. Belgium CO Emulation for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

57

11. Brazil R2 Bidirectional for PDKRT


The protocol modules (see Table 12) and modifiable country dependent parameters (CDP) file for the Brazil R2 Protocol is described in this chapter. Table 12. Brazil R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_br_r2_io. hot pdk_br_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: br_300.prm DM3 and SpringWare: pdk_br_r2_io. cdp Windows DM3: pdk_br_r2_io. hot pdk_br_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: br_300.prm DM3 and SpringWare: pdk_br_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

59

Global Call Country Dependent Parameters (CDP) Reference

11.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

11.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_br_r2_io CDP File Name: pdk_br_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 0 or 1. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol. Value as released = 16.

60

11. Brazil R2 Bidirectional for PDKRT

NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. Possible values are: 0 - Request (inbound) or send (outbound) ANI digits without area code (value as released). 1 - Request (inbound) or send (outbound) area code with ANI digits. CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies whether ANI digits and area code are sent to the inbound side. Possible values are: 0 - The requested information denied tone is sent to the inbound side (value as released). 1 - ANI digits with area code are sent to the inbound. CDP_AreaCode: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Area code of the Local Exchange where the subscriber is connected. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. Some typical values are: 1 - General subscriber (value as released) 2 - Subscriber with priority 3 - Maintenance equipment 4 - Local public telephone 5 - Telephone Operator 6 - Equipment of Data transmission 7- Intercity Public Telephone 11 - Subscriber with transference facility

61

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_DOUBLE_ANSWER_FLAG (Inbound): Specifies whether to enable the double answer feature that is used to block collect calls. Possible values are: 0 - Enable double answer feature (value as released). 1 - Disable double answer feature. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. Possible values are: 1 - Chargeable (value as released). 5 - Nonchargeable. 6 - Chargeable, but the clearing of the call is under called party control. CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. In the inbound protocol, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. In the outbound protocol, ANI digits are passed directly or the inbound side is informed of the availability (status) first. Possible values are: 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side (value as released). 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are
62

11. Brazil R2 Bidirectional for PDKRT

available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request. CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. Possible values are: 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released). CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Possible values are: 0 - Category has to be received after complete DNIS (value as released). Non-zero - The number of DNIS digits received before category information is received. If this parameter is set to non-zero, the following sequence of events occurs: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED = 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

63

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3. CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone. Non-zero - The number of ANI digits expected. This number should always be less than CDP_ANI_MaxDigits. Value as released = 4.

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone (value as released). Non-zero - The number of DNIS digits. This value should always be less than CDP_DNIS_MaxDigits (value as released = 2).

CAS_PULSE_DOUBLE_ANSWER (Inbound): Double answer signal. When answering a call, the double answer signal is sent to the CO to block collect calls. This parameter is valid is only if CDP_DOUBLE_ANSWER_FLAG is set to 1. The default double answer signal comprises the following: 1. 2. 3. An initial answer signal with signaling bits AB = 01 for 1000 msec (signaling bits ABCD = 0101). A backward clear signal (signaling bits AB = 11) for 2000 msec (signaling bits ABCD = 1101). A return to answer state with signaling bits AB = 01 (signaling bits ABCD = 0101).

Values as released = 0101, 1101, 900, 50, 900, 80, 1800, 2000, 2200. The eighth argument of this parameter, 2000, is the time between the two answers. The seventh (1800) and ninth (2200) arguments should be set to approximately 90% and 110%, respectively, of argument number 8. CDP_REANSWER_TIMEOUT (Outbound): Defines the amount of time the protocol should wait before sending a DISCONNECTED event to the application. This prevents the outbound side from getting disconnected when

64

11. Brazil R2 Bidirectional for PDKRT

a DOUBLE ANSWER signal is received from the remote end in the connected state. Possible values are: 0 - Do not wait to report a DISCONNECTED event to the application when a remote DISCONNECT signal (CAS_CLEARBWD) line signal is received (value as released). Non-zero - Wait for the specified amount of time when receiving a DISCONNECT signal (CAS_CLEARBWD) before sending the DISCONNECTED event to the application. In the Connected state, receiving a DISCONNECT signal (CAS_CLEARBWD) from the remote end does not cause a transition to the Disconnected state immediately. If during this period, the Answer (CAS_ANSWER) signal is received, no DISCONNECTED event is reported to the application and the protocol remains in the Connected state only. A typical value is about 2000 milliseconds. CDP_RECV_CALL_EVENT_SENT_WITH_FIRST_ANSWER (Inbound): Specifies if the call state is changed to CONNECTED after first or second answer. This parameter is valid only if CDP_DOUBLE_ANSWER_FLAG is set to 1. Possible values are: 0 - Change call state to the CONNECTED state after the second answer. 1 - Change the call state to the CONNECTED state after the first answer (value as released). CDP_REJECT_WITH_A3B4 (Inbound): Determines if call is rejected when R2MF tone error is received during call setup. Possible values are: 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone combination, which means the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then the category is received and in response, a B-4 tone is sent to reject the call. CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released).

65

Global Call Country Dependent Parameters (CDP) Reference

1 - If the protocol is used as inbound only. CDP_TrunkPrefixNumber: Trunk number used to dial to local exchange. Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Value as released = 9.

66

12. Brazil R2 for ICAPI


The protocol modules (see Table 13) and the modifiable inbound and outbound country dependent parameters (CDP) for the Brazil R2 Protocol for ICAPI are described in this chapter. Table 13. Brazil R2 Protocol Modules File Type Protocol Modules Linux br_r2_i.so br_r2_o.so br_r2_i.dll br_r2_o.dll Voice and Network Parameter Country Dependent Parameter br_300.prm br_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

br_r2_i.cdp br_r2_o.cdp

br_r2_i.cdp br_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

12.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
67

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued. This implementation only supports line signaling according to CCITT standards. Pulsed single bit line signaling is not currently supported.

12.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: br_r2_i CDP File Name: br_r2_i.cdp The modifiable parameters are: $7: Minimum number of DDI digits, depends on the trunk (check with your local PTT) and your application. This protocol supports variable DDI digit length. You can decide on a call basis the length of the DDI string with the gc_CallAck( ) function. The value specified here is the minimum number of digits to collect. The gc_CallAck( ) function can be used after the GCEV_OFFERED event to acquire more DDI digits or the call can be accepted. Value as released = 2. $8: Maximum number of ANI digits. Use a value at least equal to the ANI string length to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 0. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. The normal value is 0 or -1, check with local PTT. Value as released = 0.

68

12. Brazil R2 for ICAPI

$46: Double answer flag. Set to 1 to enable the double answer feature that is used to block collect calls. Set to 0 to disable the double answer feature. See parameter $47 for a description of the string that defines the signaling cycle for the double answer feature. Value as released = 0. $47: Double answer signal. When answering a call, this signal is sent to the CO to indicate that all collect calls are to be rejected. The default double answer signal comprises the following: Initial answer signal with signaling bits AB = 01 for 1000 msec (signaling bits DCBA = 1010), then Backward clear signal (signaling bits AB = 11) for 2000 msec (signaling bits DCBA = 1011), and finally Return to answer state with signaling bits AB = 01 (signaling bits DCBA = 1010).

Then, the call connection returns to the application. Eight bits are used to define the signaling bits to transmit. The upper 4 bits represent the signaling bits DCBA, respectively. When an upper bit is set to 1, then the corresponding lower bit value (0 or 1) is transmitted as the signaling bit. When an upper bit is set to 0, then the current value of the corresponding signaling bit is sent (the lower bit value is ignored for that signaling bit). Typically, the upper 4 bits are enabled by setting them to 1111 (hex value = F) and the DCBA signaling bits sent are equivalent to the lower 4 bits. Signaling bits C and D are only used in E-1 signaling. For other signaling protocols, the C and D signaling bits are ignored (set the upper 4 bits to 00xx, where xx is replaced by the desired value for the B and A signaling bits). When all signaling bits are enabled (for example, the upper 4 bits are set to 1111), the signaling combinations in Table 14 are available. The double answer signal is defined by a parameter string of the format: G<w>,<d0>,<rep#>,<s1>,<d1>,<s2>,<d2>,<s3>,<d3> where the default parameter string is: G0,0,1,FA,200,FB,400,FA,0 This default parameter string responds to a request for a connection by sending an initial answer signal with signaling bits DCBA = 1010 (FA) for 1000 msec (200 x 5 msec), then a backward clear signal with signaling bits

69

Global Call Country Dependent Parameters (CDP) Reference

DCBA = 1011 (FB) for 2000 msec (400 x 5 msec), and finally an answer signal with signaling bits DCBA = 1010 (FA). The double answer signal parameters are: <w> defines the wait-for-signaling pattern. When set to 0, then the double answer signal is immediately initiated. Any other value defines the signaling bit pattern that must be detected before the double answer signal is initiated. <d0> numeric value that defines the amount of time to wait (in 5 msec units) after recognizing a wait-for-signaling pattern before transmitting the double answer signal. When G<w> is set to G0, then defines the amount of time to wait after receiving a request for connection. <rep#> numeric value that defines the number of times to repeat the double answer signal. <s1> defines the signaling bits to be sent as the initial answer signal, see above table. <d1>, <d2> define the amount of time (in 5 msec units) during which the corresponding signaling pattern (<s1>, <s2> respectively) is sent to the CO. <s2> defines the signaling bits to be sent as the backward clear signal, see above table. <s3> defines the signaling bits to be sent as the second answer signal of the cycle, see above table. <d3> must be set to 0. The <s1>, <s2>, <s3> signaling bit values can be defined using decimal or hex values. The default is decimal. Hex values A through F entered for the leading digit will automatically be recognized as hex. Otherwise, hex values must be prefixed with an x or X (for example, x9 for 1001). in the state defined by the second answer signal.

NOTE: At the conclusion of the double answer signal, the signaling bits are left

70

12. Brazil R2 for ICAPI

Table 14. Signaling Combinations Lower 4 bit value 0000 0001 0010 0011 0100 0101 0110 0111 1000 1001 1010 1011 1100 1101 1110 1111 Signaling Bits Sent DCBA = 0000 (AB = 00, CD = 00) DCBA = 0001 (AB = 10, CD = 00) DCBA = 0010 (AB = 01, CD = 00) DCBA = 0011 (AB = 11, CD = 00) DCBA = 0100 (AB = 00, CD = 10) DCBA = 0101 (AB = 10, CD = 10) DCBA = 0110 (AB = 01, CD = 10) DCBA = 0111 (AB = 11, CD = 10) DCBA = 0000 (AB = 00, CD = 00) DCBA = 0000 (AB = 00, CD = 00) DCBA = 1010 (AB = 01, CD = 01) DCBA = 1011 (AB = 11, CD = 01) DCBA = 1100 (AB = 00, CD = 11) DCBA = 1101 (AB = 10, CD = 11) DCBA = 1110 (AB = 01, CD = 11) DCBA = 1111 (AB = 11, CD = 11) Decimal 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Hex 0 1 2 3 4 5 6 7 8 9 A B C D E F

Global Tone Detection Usage: Tone IDs 105, 433-437, 451-453, and 497-511 are used by this protocol.

12.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: br_r2_o

71

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: br_r2_o.cdp


NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning: GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

72

12. Brazil R2 for ICAPI

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 103-105, 433-442, and 497-511 are used by this protocol.

73

13. Brazil R2 Bidirectional for ICAPI


The protocol modules (see Table 15) and the modifiable inbound and outbound country dependent parameters (CDP) for the Brazil R2 Protocol for ICAPI for ICAPI are described in this chapter. Table 15. Brazil R2 Bidirectional Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol module to be dynamically loaded as required. r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

br_300.prm

br_300.prm

br_r2_io.cdp

br_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

13.1. Protocol Limitations


None.

13.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: br_r2_io

75

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: br_r2_io.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

76

13. Brazil R2 Bidirectional for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

77

14. Bulgaria R2 for ICAPI


The protocol modules (see Table 16) and the modifiable inbound and outbound country dependent parameters (CDP) for the Bulgaria R2 Protocol for ICAPI are described in this chapter. Table 16. Bulgaria R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

bg_r2_i.cdp bg_r2_o.cdp

bg_r2_i.cdp bg_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

14.1. Protocol Limitations


None.

14.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: bg_r2_i

79

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: bg_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

14.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: bg_r2_o CDP File Name: bg_r2_o.cdp

80

14. Bulgaria R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

81

15. CCITT R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 17) for the CCITT R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 17. CCITT R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_ccitt_r2_i o.hot pdk_ccitt_r2_i o.qs SpringWare: pdk_ccitt_r2_i o.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_ccitt_r2_i o.cdp Windows DM3: pdk_ccitt_r2_i o.hot pdk_ccitt_r2_i o.qs SpringWare: pdk_ccitt_r2_i o.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_ccitt_r2_i o.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

15.1. Protocol Limitations


None.

83

Global Call Country Dependent Parameters (CDP) Reference

15.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_ccitt_r2_io CDP File Name: pdk_ccitt_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0 Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2.

84

15. CCITT R2 Bidirectional for PDKRT

CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

85

16. Chile R2 Bidirectional for ICAPI


The protocol modules (see Table 18) and the modifiable inbound/outbound country dependent parameters (CDP) for the Chile R2 Bidirectional Protocol for ICAPI are described in this chapter. Table 18. Chile R2 Bidirectional Protocol Modules File Type Protocol Modules Linux cl_r2_io.so Windows Description The shared protocol module to be dynamically loaded as required. cl_r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

cl_300.prm

cl_300.prm

cl_r2_io.cdp

cl_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

16.1. Protocol Limitations


None.

16.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: cl_r2_io

87

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: cl_r2_io.cdp


NOTES: 1. Inbound call parameters are identified with (Inbound); outbound call

parameters with (Outbound). 2. This protocol does not require a call analysis, because the called party condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0 (Outbound): Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 40. $1 (Outbound): Number of ringback tones before returning: GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $7 (Inbound): Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $8 (Inbound): Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 9. $9 (Inbound): Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $13 (Outbound): Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80.

88

16. Chile R2 Bidirectional for ICAPI

$16 (I/O): Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32 (Inbound): Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. The normal value is 0 or -1, check with the local PTT. Value as released = 0. $41 (Outbound): Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42 (Outbound): Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $44 (Outbound): Set to 1 to quickly release the line at disconnection time. This reduces the possibility of additional charges after terminal disconnection. Set to 0 to use normal disconnection procedure. Value as released = 1. $47 (Inbound): Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. $49 (Outbound): Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

89

Global Call Country Dependent Parameters (CDP) Reference

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

90

17. China R2 Bidirectional for PDKRT


The protocol modules (see Table 19)) and the modifiable inbound and outbound country dependent parameters (CDP) for the China R2 Bidirectional for PDKRT Protocol is described in this chapter. Table 19. China R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_cn_r2_io. hot pdk_cn_r2_io. qs SpringWare: pdk_cn_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: cn_300.prm DM3 and SpringWare: pdk_cn_r2_io. cdp Windows DM3: pdk_cn_r2_io. hot pdk_cn_r2_io. qs SpringWare: pdk_cn_r2_io. psi SpringWare only: cn_300.prm DM3 and SpringWare: pdk_cn_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

91

Global Call Country Dependent Parameters (CDP) Reference

17.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

17.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_cn_r2_io CDP File Name: pdk_cn_r2_io.cdp A parameter can be inbound, outbound, or both inbound and outbound. An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED: Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol. If this value is set to 0, the behavior of the protocol is not predictable. Value as released = 16.

92

17. China R2 Bidirectional for PDKRT

CDP_CallingPartyCategory_KA: The category of the calling subscriber. Table 20 shows some typical values. Value as released = 3. Table 20. CDP_CallingPartyCategory_KA Values for China

KA (Switch step by step) 1 - regular, fixed delay 2 - regular, immediate 3 - regular, business 4 - priority #1 5 - free 6 - small PBX 7 - priority #1, fixed delay 8 - priority #2, fixed delay 9 - privileged local 10 - non-privileged local

KA (Switch crossbar/electronic) voice/fax/data fixed delay voice/fax/data immediate voice/fax/data business voice/fax/data priority #1 free small PBX voice/fax/data priority #1, fixed delay voice/fax/data priority #2, fixed delay voice/fax/data priority #1, business free

CDP_CallingPartyCategory_KD: The category of the calling subscriber. Some typical values are: 1 - Long Distance operator, semi-automatic (value as released) 2 - Long Distance, automatic switching 3 - Local exchange, voice 4 - Local exchange, fax and data 5 - Semi-automatic, verify calling ID 6 - Test

93

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_DIGITS_BEFORE_ANI: Determines the number of DNIS digits that are to be received before any ANI digits are received . Possible values are: 0 - Indicates that ANI digits must be received after all DNIS digits are received (value as released). If this parameter is set to non-zero, the following sequence of events occurs: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digit(s) are received. Remaining DNIS digits are received. ANI digits are received. Category digits are received again.

Note also that the behavior of the protocol will not be predictable, unless the following occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: the CDP_NUM_OF_DNIS_DIGITS (if non-zero), DNIS_MaxDigits, and the actual DNIS digits to be received.

CDP_DNIS_ENABLED: Enable or disable the reception of DNIS digits. Possible values are: 1 - Enable the reception of DNIS digits (value as released). 0 - Disable the reception of DNIS digits.
NOTE: If this parameter is set to 0, the first forward tone being received will

be First DNIS digit only. CDP_DNIS_MaxDigits: The maximum number of DNIS digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. This tone is sent on receipt

94

17. China R2 Bidirectional for PDKRT

of the category for Group II. After this tone, the sequence of R2MF tone exchange is over and call is connected. This is the last R2MF tone in establishment of a call. Possible values are: 0 - Nonchargeable 1 - Chargeable (value as released) CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_NO_ANI_CAT_KA_ENABLED: If there are no ANI digits (that is, CDP_ANI_ENABLED = 0), then Cat_KA can be requested by sending an A-6 tone before Cat_KD is sent in response to an A-3 tone (change over to Group B). Possible values are: 0 - if ANI is not enabled (value as released). 1 - if ANI is enabled = 0.
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_NUM_OF_DNIS_DIGITS: The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone. Non-zero - The number of DNIS digits. This value should always be less than CDP_DNIS_MaxDigits (value as released = 4). CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bidirectional (value as released). 1 - If the protocol is used as inbound only.

95

18. China R2 for ICAPI


The protocol modules (see Table 21) and the modifiable inbound and outbound country dependent parameters (CDP) for the China R2 Protocol for ICAPI are described in this chapter. Table 21. China R2 for ICAPI Protocol Modules File Type Protocol Modules Linux cn_r2_i.so cn_r2_o.so cn_r2_i.dll cn_r2_o.dll Voice and Network Parameter Country Dependent Parameter cn_300.prm cn_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

cn_r2_i.cdp cn_r2_o.cdp

cn_r2_i.cdp cn_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

18.1. Protocol Limitations


The inbound China protocol was enhanced to provide support for receiving a variable number of DDI digits. The gc_CallAck( ) function is supported by this protocol and should be used to collect the extra digits (that is, the digits that come after the first n digits, where n is the number of DDI digits specified in parameter $7 of the cn_r2_i.cdp file).

97

Global Call Country Dependent Parameters (CDP) Reference

The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

18.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: cn_r2_I CDP File Name: cn_r2_i.cdp
NOTES: 1. This protocol differs from other R2 protocols in the number of

sequences it supports. It connects directly into a local or national transit center. Hence, this protocol receives much more complex R2 sequences than ordinary end user protocols. However, this protocol does not perform routing, that is, it does not interpret the phone number and choose the sequence which applies on a call basis. You must select appropriate sequences in consultation with the PTT. 2. Different sequences can be supported on the same trunk if they are received on different time slots and the user creates several variations of this protocol and uses them on the corresponding time slots. To create a variation, copy the .cdp file to another file, change the parameters, and use the .cdp file name without path and extension as a new protocol. 3. Parameters $7, $16, $32, $46 and $47 determine the exact sequence to be used. See the Supported Sequences section below to determine the values for the supported sequences.

98

18. China R2 for ICAPI

The modifiable parameters are: $7: Local number size, excluding repeated P or R digit. Value as released = 4. Possible values for the various sequences are: 1XY: 3 ABCD: 4 (Kc)QABCD: 5 (Kc)PQABCD: 6 [Kc|P]PQABCD: 6 (Kc)RPQABCD: 7 [Kc|R]RPQABCD: 7

$8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. The normal ANI string length is 7 and the normal value for this parameter is 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the calling party number is part of the sequence, set to 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits. Value as released = 0. Possible values are: 1 = after first DDI digit, 2 =after second DDI digit, etc. 0 = after the number of digits specified in parameter $7 -1 = after the number specified in $7 minus one, -2 = after the number specified in $7 minus two, etc.

$46: Specifies the size of the area code. If the area code is not part of the sequence, set to 0. Value as released = 0.

99

Global Call Country Dependent Parameters (CDP) Reference

$47 protocol bit mask: The following decimal values may be added together to enable the corresponding functions (equivalent to ORing the equivalent bits as individual switches): 1 (0x01): A3 must always be sent in pulse form (200 msec) 2 (0x02): Detect service calls (1XY instead of (R)PQABCD) 4 (0x04): Accept KC as first local phone number digit (KC)(R)PQABCD 8 (0x08): Accept KE as first local phone number digit (KE)(R)PQABCD 16 (0x10): First local phone number digit is repeated [KC|P]PQABCD or [KC|R]RPQABCD (not compatible with value 4 or 8 (Bit 2 and 3)) 32 (0x20): Skip initial 0 before area code if any (0)X1X2...

Global Tone Detection Usage: None. Supported Sequences:


R2 sequence CO tones above replied tones below Local terminating exchange: A B C D KD A1 A1 A1 A3 KB Local transit exchange, intra city call: [H12/H11](R) P Q A B C D [ A1 ](A1)A1 A1 A1 A1 A1 A3 KD KB 6/7* 0 N/A 0 10 $7 $16 $32 $46 $47

N/A

6/7* 0

N/A

Local transit exchange, intra city call + detection of service call: [H12/H11](R) P Q A B C D KD [ A1 ](A1)A1 A1 A1 A1 A1 A3 KB or [H12/H11]1 X Y KD [ A1 ]A1 A1 A3 KB International semi-automatic transit exchange: 1 X Y KOA [R'] P' Q' A' B' C' D' 15 A1 A1 A6 A1 [A1] A1 A1 A1 A1 A1 A1 A3 KD KB

Long distance transit exchange + service call: [0] X1 X2 P KA [R'] P' Q' A'... D' 15 Q A...D [A1] A1 A1 A6 A1 [A1] A1 A1 A1... A1 A1 A1 A1..A1A3p or [0] X1 X2 1 KA [R'] P' Q' A'... D' 15 X Y [A1] A1 A1 A6 A1 [A1] A1 A1 A1... A1 A1 A1 A1 A3p

6/7* 1 KD KB KD KB 6/7* 0

2** 35

End to end long distance transit exchange+service call: [0] X1 X2 P/KC P Q A B C D KD

N/A

2** 51

100

18. China R2 for ICAPI

[A1] [0] [A1]

A1 X1 A1

A1 or X2 A1

A1 1/KC A1

A1 1 A1

A1 X A1

A1 Y A1

A1 A3p

A1 KD KB

A1

A3p

KB

Link by link long distance transit exchange+service call: [0] X1 X2 [KC] P Q A B C D KD [A1] A1 A1 [A1] A1 A1 A1 A1 A1 A1 A3p KB or [0] X1 X2 [KC] 1 X Y KD [A1] A1 A1 [A1] A1 A1 A1 A3p KB

6/7* 0

N/A

2** 39

Legend: 1XY: represents a 3-digit service call X1, X2: represent the area code digits (R)PQABCD: represents the local phone number KA, KC and KD: are category tones (R')P'Q'A'B'C'D': are calling party digits H12, H11: are routing digits 15: is the end-of-pulsing digit A1, A3, A6: are the replied group A digits A3p: is A3 in pulse form KB: is the group B response tone [xx]: means that the protocol will support calls with or without digit xx (xx): means that calls with and without digit xx are different and require different set of parameters N/A: means that this parameter is not applicable and the value is ignored RPQABCD. ** this is the area code size, the protocol will accept any area code as long as it has this size. *** the protocol detects a service call and changes the local number size to 3 on a call basis when the first local number digit is 1.

NOTE: * use 6 if the local number format is PQABCD, 7 if the format is

18.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: cn_r2_o CDP File Name: cn_r2_o.cdp

101

Global Call Country Dependent Parameters (CDP) Reference

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 200. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for a gc_DropCall( ) function before disconnecting. Set this parameter to 1, and the protocol disconnects the line when it sends a GCEV_DISCONNECTED event. The application still needs gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within the time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60. Caution Global Call does not fully support this operation at this time. This value should be set to zero.
102

18. China R2 for ICAPI

$49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

103

19. China R2 Bidirectional for ICAPI


The protocol modules (see Table 22) and the modifiable inbound and outbound country dependent parameters (CDP) for the China R2 Protocol for ICAPI are described in this chapter. Table 22. China R2 Bidirectional for ICAPI Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol module to be dynamically loaded as required. r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

r2_300.prm

r2_300.prm

cn_r2_io.cdp

cn_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

19.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
105

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

19.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: cn_r2_io CDP File Name: cn_r2_io.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. Possible values for the various sequences are: 1XY: 3 ABCD: 4 (Kc)QABCD: 5 (Kc)PQABCD: 6 [Kc|P]PQABCD: 6 (Kc)RPQABCD: 7 [Kc|R]RPQABCD: 7 Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

106

19. China R2 Bidirectional for ICAPI

$2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

107

20. Colombia R2 Bidirectional for PDKRT


The protocol modules (see Table 23) and the modifiable inbound and outbound country dependent parameters (CDP) for the Colombia R2 Protocol is described in this chapter. Table 23. Colombia R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_co_r2_io. hot pdk_co_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_co_r2_io. cdp Windows DM3: pdk_co_r2_io. hot pdk_co_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_co_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

109

Global Call Country Dependent Parameters (CDP) Reference

20.1. Protocol Limitations


None.

20.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_co_r2_io CDP File Name: pdk_co_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. Possible values are: 0 - Request (inbound) or send (outbound) ANI digits without area code (value as released). 1 - Request (inbound) or send (outbound) area code with ANI digits.

110

20. Colombia R2 Bidirectional for PDKRT

CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies whether ANI digits and area code are sent to the inbound side. Possible values are: 0 - the requested information denied tone is sent to the inbound side (value as released). 1 - ANI digits with area code are sent to the inbound.

CDP_AreaCode: Area code of the Local Exchange where the subscriber is connected. Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. One of the Group II forward signals. Some typical values are: 1 - National Long Distance 2 - Subscriber without priority (value as released) 3 - Payphone or kiosk 4 - Immediate billing information (kiosk) 5 - Available 6 - Available 7 - Available 8 - Available 9 - Available 10 - Available 15 - Special line

CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. This tone is sent on receipt
111

Global Call Country Dependent Parameters (CDP) Reference

of the Category for Group II. After this tone, the sequence of R2MF tone exchange is over and the call is connected. This is the last R2MF tone in establishment of a call. Possible values are: 1 - Chargeable (value as released) 5 - Line free, nonchargeable CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. At the inbound side, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. At the outbound side, ANI digits are passed directly or the inbound side is informed of the availability (status) first. Possible values are: 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side (value as released). 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request. CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. Possible values are: 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released).

112

20. Colombia R2 Bidirectional for PDKRT

CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Possible values are: 0 - Category has to be received after complete DNIS (value as released). Non-zero - The number of DNIS digits received before category information is received. The following sequence of events occurs: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED is 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3. CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone. Non-zero - The number of ANI digits expected. This number should always be less than CDP_ANI_MaxDigits.

113

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone. Non-zero - The number of DNIS digits. This value should always be less than CDP_DNIS_MaxDigits. Value as released = 4.

CDP_REJECT_WITH_A3B4 (Inbound): Determines if call is rejected when R2MF tone error is received during call setup. Possible values are: 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone, which means the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then the category is received and in response, a B-4 tone is sent to reject the call.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only.

CDP_TrunkPrefixNumber: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Trunk number used to dial to local exchange. Value as released = 9.

114

21. Colombia R2 for ICAPI


The protocol modules (see Table 24) and the modifiable inbound and outbound country dependent parameters (CDP) for the Colombia R2 Protocol for ICAPI are described in this chapter. Table 24. Colombia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

co_r2_i.cdp co_r2_o.cdp

co_r2_i.cdp co_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

21.1. Protocol Limitations


None.

21.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: co_r2_in

115

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: co_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

21.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: co_r2_out CDP File Name: co_r2_o.cdp

116

21. Colombia R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

117

22. Croatia R2 for ICAPI


The protocol modules (see Table 25) and the modifiable inbound and outbound country dependent parameters (CDP) for the Croatia R2 Protocol for ICAPI are described in this chapter. Table 25. Croatia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_i.dll r2_o.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

hr_r2_i.cdp hr_r2_o.cdp

hr_r2_i.cdp hr_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

22.1. Protocol Limitations


None.

22.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: hr_r2_in

119

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: hr_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

22.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: hr_r2_o CDP File Name: hr_r2_o.cdp

120

22. Croatia R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

121

23. Czech Republic R2 for ICAPI


The protocol modules (see Table 26) and the modifiable inbound and outbound country dependent parameters (CDP) for the Czech Republic R2 Protocol for ICAPI are described in this chapter. Table 26. Czech Republic R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

cz_r2_i.cdp cz_r2_o.cdp

cz_r2_i.cdp cz_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

23.1. Protocol Limitations


None.

23.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: cz_r2_i

123

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: cz_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

23.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: cz_r2_o CDP File Name: cz_r2_o.cdp

124

23. Czech Republic R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

125

24. Czech Republic R2 Bidirectional for ICAPI


The protocol modules (see Table 27) and the modifiable inbound and outbound country dependent parameters (CDP) for the Czech Republic R2 Bidirectional Protocol for ICAPI are described in this chapter. Table 27. Czech R2 Bidirectional Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol module to be dynamically loaded as required. r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

r2_300.rpm

r2_300.rpm

cz_r2_io.cdp

cz_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

24.1. Protocol Limitations


None.

127

Global Call Country Dependent Parameters (CDP) Reference

24.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: cz_r2_io CDP File Name: cz_r2_io.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned.

128

24. Czech Republic R2 Bidirectional for ICAPI

If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

129

25. DC5A Delay Start Bidirectional for ICAPI


The protocol modules (see Table 28) and the modifiable inbound and outbound country dependent parameters (CDP) for the DC5A Delay Start Bidirectional Protocol for ICAPI are described in this chapter. Table 28. DC5A Delay Start Bidirectional Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol module to be dynamically loaded as required. cas_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

dc5a_300.prm

dc5a_300.prm

dc5ds_io.cdp

dc5ds_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

25.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

131

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

25.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: dc5ds_io CDP File Name: dc5ds_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0.

132

25. DC5A Delay Start Bidirectional for ICAPI

$20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

133

26. DC5A Immediate Start Bidirectional for ICAPI


The protocol modules (see Table 29) and the modifiable inbound and outbound country dependent parameters (CDP) for the DC5A Immediate Start Bidirectional Protocol for ICAPI are described in this chapter. Table 29. DC5A Immediate Start Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol module to be dynamically loaded as required. cas_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

dc5a_300.prm

dc5a_300.prm

dc5is_io.cdp

dc5is_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

26.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

135

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

26.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: dc5is_io CDP File Name: dc5is_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0.

136

26. DC5A Immediate Start Bidirectional for ICAPI

$20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

137

27. DC5A Wink Start Bidirectional for ICAPI


The protocol modules (see Table 30) and the modifiable inbound and outbound country dependent parameters (CDP) for the DC5A Wink Start Bidirectional Protocol for ICAPI are described in this chapter. Table 30. DC5A Wink Start Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol module modules to be dynamically loaded as required. cas_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

dc5a_300.prm

dc5a_300.prm

dc5ws_io.cdp

dc5ws_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

27.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

139

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

27.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: dc5ws_io CDP File Name: dc5ws_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0.

140

27. DC5A Wink Start Bidirectional for ICAPI

$20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

141

28. Finland R2 Bidirectional for PDKRT


The protocol modules (see Table 31) and modifiable country dependent parameters (CDP) file for the Finland R2 Bidirectional for PDKRT protocol is described in this chapter. Table 31. Finland R2 Protocol Modules for PDKRT File Type Protocol Modules Linux DM3: pdk_fi_r2_io. hot pdk_fi_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: fi_300.prm DM3 and SpringWare: pdk_fi_r2_io.c dp Windows DM3: pdk_fi_r2_io. hot pdk_fi_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: fi_300.prm DM3 and SpringWare: pdk_fi_r2_io.c dp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

143

Global Call Country Dependent Parameters (CDP) Reference

28.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

28.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_fi_r2_io CDP File Name: pdk_fi_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol. Value as released = 16.

144

28. Finland R2 Bidirectional for PDKRT

NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. Possible values are: 0 - Request (inbound) or send (outbound) ANI digits without area code. 1 - Request (inbound) or send (outbound) area code with ANI digits (value as released). CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies whether ANI digits and area code are sent to the inbound side. If this parameter is set to 1, ANIWITHAC is sent to the Inbound (same as CLIP). If this parameter is set to 0, the requested information denied tone is sent to the inbound side (same as CLIR). Possible values are: 0 - The requested information denied tone is sent to the inbound side (value as released). 1 - ANI digits with area code are sent to the inbound. CDP_AreaCode: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Area code of the Local Exchange where the subscriber is connected. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. Some typical values are: 1 - Ordinary Subscriber (value as released) 2 - Subscriber with priority 3 - Test equipment 4 - Payphone 5 - Telephone operator 6 - Data subscriber 11 - Redirect call 13 - Digital connectivity required
145

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. This tone is sent on receipt of Category for Group II. After this tone, the sequence of R2MF tone exchange is over and call is connected. This is the last R2MF tone in establishment of a call. Values are: 1 - Line free, chargeable malicious call identification. 6 - Line free, chargeable (value as released). CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. At the inbound side, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. At the outbound side, ANI digits are passed directly or the inbound side is informed of the availability (status) first. Possible values are: 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side (value as released). 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request.

146

28. Finland R2 Bidirectional for PDKRT

CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. Possible values are: 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released).

CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Possible values are: 0 - Category has to be received after complete DNIS (value as released). Non-zero - The number of DNIS digits received before category information is received. If this parameter is set to non-zero, the following sequence of events occurs: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED is 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3.
147

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone. Non-zero - The number of ANI digits expected. This parameter should always be less than or equal to CDP_ANI_MaxDigits. Value as released = 4.

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone (value as released). Non-zero - The number of DNIS digits. This value should always be less than or equal to CDP_DNIS_MaxDigits (value as released = 2).

CDP_REJECT_WITH_A3B4 (Inbound): Determines if call is rejected when R2MF tone error is received during call setup. Possible values are: 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone, which means the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then the category is received and in response, a B-4 tone is sent to reject the call.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only.

CDP_TrunkPrefixNumber: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Trunk number used to dial to local exchange. Value as released = 9.

148

29. Finland R2 for ICAPI


The protocol modules (see Table 32) and the modifiable inbound and outbound country dependent parameters (CDP) for the Finland R2 Protocol for ICAPI are described in this chapter. Table 32. Finland R2 Protocol Modules File Type Protocol Modules Linux fi_r2_i.so fi_r2_o.so fi_r2_i.dll fi_r2_o.dll Voice and Network Parameter Country Dependent Parameter fi_300.prm fi_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

fi_r2_i.cdp fi_r2_o.cdp

fi_r2_i.cdp fi_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

29.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
149

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

29.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: fi_r2_i CDP File Name: fi_r2_i.cdp The modifiable parameters are: $7: Minimum number of DDI digits, depends on the trunk (check with your local PTT) and your application. This protocol supports variable DDI digit length. You can decide on a call basis the length of the DDI string with the gc_CallAck( ) function. The value specified here is the minimum number of digits to collect. The gc_CallAck( ) function can be used after the GCEV_OFFERED event to acquire more DDI digits or the call can be accepted. Value as released = 3. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. The normal value is 0 or -1, check with the local PTT. Value as released = 1. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

150

29. Finland R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 105, 433-439, 441, 451-454, and 497-511 are used by this protocol.

29.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: fi_r2_o CDP File Name: fi_r2_o.cdp
NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 40. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 4. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 120. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0.
151

Global Call Country Dependent Parameters (CDP) Reference

$42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 103-105, 433-442, and 497-511 are used by this protocol.

152

30. France E-1 for ICAPI


The protocol modules (see Table 33) and the modifiable inbound and outbound country dependent parameters (CDP) for the France MF Socotel E -1 Protocol for ICAPI are described in this chapter. Table 33. France E-1 MF Socotel Protocol Modules File Type Protocol Modules Linux fr_e1_i.so fr_e1_o.so fr_e1_i.dll fr_e1_o.dll Voice and Network Parameter Country Dependent Parameter fr_300.prm fr_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

fr_e1_i.cdp fr_e1_o.cdp

fr_e1_i.cdp fr_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

30.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
153

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

30.2. MF Socotel E-1 Inbound Parameters


gc_Open( ) Protocol Name: fr_e1_i CDP File Name: fr_e1_i.cdp The modifiable parameters are: $7: Number of DDI digits, normally 4. Check with local PTT. This inbound parameter must match parameter $7 on the CO side of the trunk or $7 of the fr_e1_o.cdp file used by the CO Simulator to test the application. Value as released = 4. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1.

Global Tone Detection Usage: Tone IDs 103, 105, and 496-506 are used by this protocol.

30.3. MF Socotel E-1 Outbound CO Emulation Parameters


gc_Open( ) Protocol Name: fr_e1_o

Caution This protocol is not designed to work on the public network. It is intended to test the inbound protocol.

CDP File Name: fr_e1_o.cdp


154

30. France E-1 for ICAPI

NOTE: This protocol does not require call analysis because the called party

condition is received via SOCOTEL tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using SOCOTEL tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $1: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a line basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 60. $5: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $7: Number of digits to send on inbound side request. This outbound parameter must match parameter $7 of the fr_e1_i.cdp file used by the CO Simulator to test the application. Value as released = 4. $10: Time in seconds to wait for Idle. Value as released = 10.

Global Tone Detection Usage: Tone IDs 103, 105, and 496-506 are used by this protocol.

155

31. Georgia R2 for ICAPI


The protocol modules (see Table 34) and the modifiable country dependent parameters (CDP) for the Georgia R2 Protocol for ICAPI are described in this chapter. Table 34. Georgia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so Windows Description The shared protocol module to be dynamically loaded as required. r2_in.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

r2_300.prm

r2_300.prm

ge_r2_i.cdp

ge_r2_i.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

31.1. Protocol Limitations


None.

31.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ge_r2_i

157

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: ge_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

158

32. Greece E-1 for ICAPI


The protocol modules (see Table 35) and the modifiable inbound and outbound country dependent parameters (CDP) for the Greece E-1 Protocol for ICAPI are described in this chapter. Table 35. Greece E-1 Protocol Modules File Type Protocol Modules Linux gr_e1_i.so gr_e1_o.so gr_e1_i.dll gr_e1_o.dll Voice and Network Parameter Country Dependent Parameter gr_300.prm gr_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

gr_e1_i.cdp gr_e1_o.cdp

gr_e1_i.cdp gr_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

32.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
159

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

32.2. E-1 Inbound Parameters


gc_Open( ) Protocol Name: gr_e1_i CDP File Name: gr_e1_i.cdp The modifiable parameters are: $6: Maximum duration of DDI phase in seconds. Value as released = 15. $7: Minimum number of DDI digits. Value as released = 4. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10. $11: Dialed number reception acknowledgment used. Value as released = 1. $12: Ringback generated by terminal. Possible values: 0 (no) and 1 (yes) Value as released = 1. $13: Hardware used. Possible values: 0 (DTI/212) and 1 (D/300SC-E-1). Value as released = 1. This parameter must be set to 1. $14: DDI method. Possible values: 0 (pulse) and 1 (DTMF). Value as released = 1. $15: Time in seconds between metering pulses (for testing only). Value as released = 0 (no pulse). $16: Mean duration of metering pulse in 10-msec units. Value as released = 12. $17: Minimum duration of metering pulse in 10-msec units. Value as released = 9.

160

32. Greece E-1 for ICAPI

$18: Maximum duration of metering pulse in 10-msec units. Value as released = 16.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

32.3. E-1 Outbound Parameters


gc_Open( ) Protocol Name: gr_e1_o CDP File Name: gr_e1_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time between two rings in 10-msec units to detect answer. Value as released = 0. $6: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 15. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $11: Hardware used. Possible values are: 0 (DTI/212), 1 (D/300SC-E-1, DTI/300SC or DTI/301SC). Value as released = 1. This parameter must be set to 1. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter

161

Global Call Country Dependent Parameters (CDP) Reference

on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $14: DDI method. Possible values are: 0 (pulse) and 1 (DTMF). Value as released = 0. $16: Mean duration of metering pulse in 10-msec units. Value as released = 12. $17: Minimum duration of metering pulse in 10-msec units. Value as released = 9. $18: Maximum duration of metering pulse in 10-msec units. Value as released = 16.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

162

33. Hong Kong DTMF Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 36) for the Hong Kong DTMF Bidirectional Protocol for PDKRT are described in this chapter. Table 36. Hong Kong DTMF Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_hk_dtmf_ io.hot pdk_hk_dtmf_ io.qs SpringWare: pdk_hk_dtmf_ io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_hk_dtmf_ io.cdp Windows DM3: pdk_hk_dtmf_ io.hot pdk_hk_dtmf_ io.qs SpringWare: pdk_hk_dtmf_ io.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_hk_dtmf_ io.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

163

Global Call Country Dependent Parameters (CDP) Reference

33.1. Protocol Limitations


None.

33.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_hk_dtmf_io CDP File Name: pdk_hk_dtmf_io.cdp The modifiable parameters are: CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling without Delay Dial, DNIS, ANI 1 - Delay Dial Method with DNIS (HKTA2017) 2 - Delay Dial Method with DNIS, ANI (HKTA2018) (value as released) CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_ANSWER signal once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 10000 (10 seconds).

164

34. Hungary R2 for ICAPI


The protocol modules (see Table 37) and the modifiable inbound and outbound country dependent parameters (CDP) for the Hungary R2 Protocol for ICAPI are described in this chapter. Table 37. Hungary R2 Protocol Modules File Type Protocol Modules Linux hu_r2_i.so hu_r2_o.so hu_r2_i.dll hu_r2_o.dll Voice and Network Parameter Country Dependent Parameter hu_300.prm hu_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

hu_r2_i.cdp hu_r2_o.cdp

hu_r2_i.cdp hu_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

34.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
165

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

34.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: hu_r2_i CDP File Name: hu_r2_i.cdp The modifiable parameters are: $6: Time-out in seconds for an incoming call. Value as released = 18. $7: Minimum number of DDI digits. Value as released = 4. $8: Maximum number of ANI digits. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10. $16: Determines in ANI is supported. Possible values are 0 (ANI not supported) and 1 (ANI supported). Value as released = 1. $32: Number of DDI digits to collect before collecting ANI. Possible values are: 0 (collect ANI after all DDI digits), 1 (collect ANI after 1 DDI digit), or -1 (collect ANI after all DDI digits but one). Value as released = 0.

Global Tone Detection Usage: Tone IDs 105, 433-439, 451, 452, 454, and 497511 are used by this protocol.

34.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: hu_r2_o CDP File Name: hu_r2_o.cdp
166

34. Hungary R2 for ICAPI

The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 40. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $11: Time-out during digit in seconds for outbound calls. Value as released = 15. $12: Time-out between digits in seconds for outbound calls. Value as released = 24. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

167

Global Call Country Dependent Parameters (CDP) Reference

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 105, 433-440, and 497-511 are used by this protocol.

168

35. India R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 38) for the India R2 Bidirectional for PDKRT Protocol is described in this chapter. Table 38. India R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_in_r2_io. hot pdk_in_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: in_300.prm DM3 and SpringWare: pdk_in_r2_io. cdp Windows DM3: pdk_in_r2_io. hot pdk_in_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: in_300.prm DM3 and SpringWare: pdk_in_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

169

Global Call Country Dependent Parameters (CDP) Reference

35.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

35.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_in_r2_io CDP File Name: pdk_in_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol. Value as released = 16.

170

35. India R2 Bidirectional for PDKRT

NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. Possible values are: 0 - Request (inbound) or send (outbound) ANI digits without area code (value as released). 1 - Request (inbound) or send (outbound) area code with ANI digits. CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Specifies whether ANI digits and area code are sent to the inbound side. Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. If this parameter is set to 1, ANIWITHAC is sent to the inbound side (same as CLIP). If this parameter is set to 0, the requested information denied tone is sent to the Inbound (same as CLIR). Possible values are: 0 - The requested information denied tone is sent to the inbound side (value as released). 1 - ANI digits with area code are sent to the inbound. CDP_AreaCode: Area code of the Local Exchange where the subscriber is connected. Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. Some typical values are: 1 - Ordinary Subscriber (value as released) 2 - Subscriber with priority 3 - Maintenance equipment calls (may be used in the future) 4 - STD (Subscriber's Trunk Dialing - equivalent to Long Distance Call, may be used in the future) 5 - Coin Box (may be used in future) 6 - Telephone operator

171

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol. If this value is set to 0, the behavior of the protocol is not predictable. Value as released = 16. CDP_GrpB_Tone (Inbound): After receiving the tone, this parameter determines whether the sender should be charged. This tone is sent on receipt of the category for Group II. After this tone, the sequence of R2MF tone exchange is over and the call is connected. This is the last R2MF tone in the establishment of a call. Possible values are: 6 - Line free, chargeable (value as released). 7 - Line free, nonchargeable.

CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated.

CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. At the inbound side, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. At the outbound side, ANI digits are passed directly or the inbound side is informed of the availability (status) first. . Possible values are: 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side. 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request (value as released).

172

35. India R2 Bidirectional for PDKRT

CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. Possible values are: 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released).

CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Possible values are: 0 - Category has to be received after complete DNIS (value as released). Non-zero - The number of DNIS digits received before category information is received. Value as released = 1. If this parameter is set to non-zero, the following sequence of events occurs: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED is 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3.
173

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone. Non-zero - The number of ANI digits expected. This number should always be less than or equal to CDP_ANI_MaxDigits. Value as released = 7.

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone. Non-zero - The number of DNIS digits. This value should always be less than or equal to CDP_DNIS_MaxDigits. Value as released = 2.

CDP_REJECT_WITH_A3B4 (Inbound): Determines if call is rejected when R2MF tone error is received during call setup. Possible values are: 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone combination, which means the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then the category is received and in response, a B-4 tone is sent to reject the call.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only.

CDP_TrunkPrefixNumber: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Trunk number used to dial to local exchange. Value as released = 9.

174

36. India R2 for ICAPI


The protocol modules (see Table 39) and the modifiable inbound and outbound country dependent parameters (CDP) for the India R2 Protocol for ICAPI are described in this chapter. Table 39. India R2 Protocol Modules File Type Protocol Modules Linux in_r2_i.so in_r2_o.so in_r2_i.dll in_r2_o.dll Voice and Network Parameter Country Dependent Parameter in_300.prm in_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

in_r2_i.cdp in_r2_o.cdp

in_r2_i.cdp in_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

36.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
175

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

36.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: in_r2_i CDP File Name: in_r2_i.cdp The modifiable parameters are: $4: Wink length in 10-msec units. Generates a wink after seizure acknowledgment. Set to 0 to disable. Value as released = 22. $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. The normal ANI string length is 7 and the normal value for this parameter is 10. Value as released = 7. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the CO supports ANI; 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0. $46: Selects semi-compelled signaling. Default is 1, semi-compelled signaling selected. Otherwise, select 0 for compelled signaling. Value as released = 1. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol; it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 10.

176

36. India R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, 141, 433-439, 441, 451454, and 497-511 are used by this protocol.

36.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: in_r2_o CDP File Name: in_r2_o.cdp
NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $4: Wink length in 10-msec units. Generates a wink after seizure acknowledgment. Set to 0 to disable. Value as released = 22. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80.

177

Global Call Country Dependent Parameters (CDP) Reference

$42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not re-answered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 101, 103-105, 141, 177-186, 195, 196, 198, and 209-223 are used by this protocol.

178

37. Indonesia E&M for ICAPI


The protocol modules (see Table 40) and the modifiable inbound and outbound country dependent parameters (CDP) for the Indonesia E&M Protocol for ICAPI are described in this chapter. Table 40. Indonesia E&M Protocol Modules File Type Protocol Modules Linux id_em_i.so id_em_o.so id_em_i.dll id_em_o.dll Voice and Network Parameter Country Dependent Parameter id_300.prm id_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

id_em_i.cdp id_em_o.cdp

id_em_i.cdp id_em_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

37.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
179

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued. This implementation only supports line signaling according to CCITT standards. Pulsed single bit line signaling is not currently supported.

37.2. E-1 E&M Inbound Parameters


gc_Open( ) Protocol Name: id_em_i CDP File Name: id_em_i.cdp The modifiable parameters are: $4: Wink length in 10-msec units. Value as released = 15. $6: Time-out for incoming calls in seconds. Value as released = 13. $7: Number of DDI digits. Default value 10. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for idle pattern on the line. Value as released = 10. $16: Specifies if ANI is supported. Possible values are: 0 (ANI not supported) or 1 (ANI supported). Value as released = 1. $19: Wink debounce in 10-msec units. Used to distinguish between short and long winks. Value as released = 30.

180

37. Indonesia E&M for ICAPI

$32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits. Value as released = 2. $43: DEBOUNCE_BLOCKING time in 55-msec units. This time is used to distinguish between a long wink (600 +/- 120 msec) and a blocking signal (that is, a continuous ABCD = 0101 signaling pattern). For E&M protocols, the value should be 14 x 55 = 770 msec. For Loop protocols, the value must be 0. Value as released = 18. $44: Maximum wink time in 10-msec units. Value as released = 18. $45: Minimum wink time in 10-msec units. Value as released = 12. $46: Supervision time in seconds before forced release after answer. Value as released = 6. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103, 105, 433-439, 441, 451-545, and 497-511 are used by this protocol.

37.3. E-1 E&M Outbound Parameters


gc_Open( ) Protocol Name: id_em_o CDP File Name: id_em_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 90. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of

181

Global Call Country Dependent Parameters (CDP) Reference

tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $2: Minimum idle time in 10-msec units. Value as released = 120. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $4: Metering pulse length in 10-msec units. Value as released = 14. $10: Time in seconds to wait for Idle. Value as released = 10. $11: Time-out in seconds during digit for outbound calls. Value as released = 15. $12: Time-out in seconds between digits for outbound calls. Value as released = 28. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 120. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $19: Wink debounce in 10-msec units. Used to distinguish between short and long winks. Value as released = 30. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60. $43: DEBOUNCE_BLOCKING time in 55-msec units. This time is used to distinguish between a long wink (600 +/- 120 msec) and a blocking signal (that is, a continuous ABCD = 0101 signaling pattern). For E&M protocols,

182

37. Indonesia E&M for ICAPI

the value should be 14 x 55 = 770 msec. For Loop protocols, the value must be 0. Value as released = 18. $44: Maximum wink time in 10-msec units. Value as released = 18. $45: Minimum wink time in 10-msec units. Value as released = 12. $47: Determines if the CO goes to answer state??? Possible values are: 0 (no) and 1 (yes). Value as released = 1. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 103-105, 433-442, and 497-511 are used by this protocol.

183

38. Indonesia E&M Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 41) for the Indonesia E&M Bidirectional Protocol for PDKRT are described in this chapter. Table 41. Indonesia E&M Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_id_em_io .hot pdk_id_em_io .qs SpringWare: pdk_id_em_io .psi Voice and Network Parameter Country Dependent Parameter SpringWare only: id_300.prm DM3 and SpringWare: pdk_id_em_io .cdp Windows DM3: pdk_id_em_io .hot pdk_id_em_io .qs SpringWare: pdk_id_em_io .psi SpringWare only: id_300.prm DM3 and SpringWare: pdk_id_em_io .cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

185

Global Call Country Dependent Parameters (CDP) Reference

38.1. Protocol Limitations


None.

38.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_id_em_io CDP File Name: pdk_id_em_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

186

38. Indonesia E&M Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

187

39. Indonesia R2 for ICAPI


The protocol modules (see Table 42) and the modifiable inbound and outbound country dependent parameters (CDP) for the Indonesia R2 Protocol for ICAPI are described in this chapter. Table 42. Indonesia R2 Protocol Modules File Type Protocol Modules Linux id_r2_i.so id_r2_o.so id_r2_i.dll id_r2_o.dll Voice and Network Parameter Country Dependent Parameter id_300.prm id_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

id_r2_i.cdp id_r2_o.cdp id_r2_i1.cdp id_r2_o1.cdp

id_r2_i.cdp id_r2_o.cdp id_r2_i1.cdp id_r2_o1.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

39.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
189

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued. This implementation only supports line signaling according to CCITT standards. Pulsed single bit line signaling is not currently supported.

39.2. R2 Inbound Parameters - Answer Signal Used


gc_Open( ) Protocol Name: id_r2_i CDP File Name: id_r2_i.cdp The modifiable parameters are: $7: Minimum number of DDI digits, depends on the trunk (check with your local PTT) and your application. This protocol supports variable DDI digit length. You can decide on a call basis the length of the DDI string with the gc_CallAck( ) function. The value specified here is the minimum number of digits to collect. The gc_CallAck( ) function can be used after the GCEV_OFFERED event to acquire more DDI digits or the call can be accepted. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103, 105, 433-439, 441, 451, 452, 454, and 497-511 are used by this protocol.

190

39. Indonesia R2 for ICAPI

39.3. R2 Outbound Parameters - Answer Signal Used


gc_Open( ) Protocol Name: id_r2_o CDP File Name: id_r2_o.cdp
NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 60. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 120. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0.
191

Global Call Country Dependent Parameters (CDP) Reference

$42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero.

Global Tone Detection Usage: Tone IDs 103-105, 433-442, and 497-511 are used by this protocol.

39.4. R2 Inbound Parameters - Answer Signal Not Used


gc_Open( ) Protocol Name: id_r2_i1 CDP File Name: id_r2_i1.cdp The actual protocol module is the same as the protocol module used for the id_r2_i protocol. The .cdp file indicates the differences between the two protocols. This protocol is similar to id_r2_i except that the terminal does NOT assert answer signal (AB = '01') but stays in acknowledge state for the duration of the conversation (AB = '11'). This variation is intended for use with some central offices (COs) which do not recognize answer state (check with local PTT). For Linux, use id_300.prm and set the ProtocolAnswerState field in /usr/dialogic/cfg/dialogic.cfg to PROT_IN_NO_ANSWER_STATE. For Windows, use the Dialogic Configuration Manager to set the ProtocolAnswerState field to PROT_IN_NO_ANSWER_STATE as follows: 1. Start the Dialogic Configuration Manager.

192

39. Indonesia R2 for ICAPI

2.

For each board in the system that is running this protocol: Open the Properties window. Click on the Country tab. Choose Indonesia in the Edit field. Click on the ProtocolAnswerState field in the table, then select PROT_IN_NO_ANSWER_STATE.

3.

Click OK.

39.5. R2 Outbound Parameters - Answer Signal Not Used


gc_Open( ) Protocol Name: id_r2_o1 CDP File Name: id_r2_o1.cdp The actual protocol module is the same as the protocol module used for the id_r2_o protocol. The .cdp file indicates the differences between the two protocols. For Linux, use id_300.prm and set the ProtocolAnswerState field in /usr/dialogic/cfg/dialogic.cfg to PROT_IN_NO_ANSWER_STATE. For Windows, use the Dialogic Configuration Manager to set the ProtocolAnswerState field to PROT_IN_NO_ANSWER_STATE. See the procedures in Section 39.4. R2 Inbound Parameters - Answer Signal Not Used for more information.

193

40. Israel R2 Bidirectional for PDKRT


The protocol modules (see Table 43) and modifiable country dependent parameters (CDP) file for the Israel R2 Protocol is described in this chapter. Table 43. Israel R2 Protocol Modules for PDKRT File Type Protocol Modules Linux DM3: pdk_il_r2_io. hot pdk_il_r2_io. qs SpringWare: pdk_r2_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_il_r2_io.c dp Windows DM3: pdk_il_r2_io. hot pdk_il_r2_io. qs SpringWare: pdk_r2_io.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_il_r2_io.c dp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

195

Global Call Country Dependent Parameters (CDP) Reference

40.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

40.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_il_r2_io CDP File Name: pdk_il_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED (Inbound): Enable or disable the reception of ANI digits. Possible values are: 1 - Enable the reception of ANI digits (value as released). 0 - Disable the reception of ANI digits.
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol as released = 16.

196

40. Israel R2 Bidirectional for PDKRT

NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED: Specifies whether ANI is to be requested (inbound) or sent (outbound) with the area code. Possible values are: 1 - Request (inbound) or send (outbound) area code with ANI digits. 0 - Request (inbound) or send (outbound) ANI digits without area code (value as released). CDP_ANI_WITHAC_FACILITY_ENABLED (Outbound): Specifies whether ANI digits and area code are sent to the inbound side. Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. If this parameter is set to 1, ANIWITHAC is sent to the inbound side (same as CLIP). If this parameter is set to 0, the requested information denied tone will be sent to the inbound side (same as CLIR). 1 - ANI digits with area code are sent to the inbound. 0 - The requested information denied tone is sent to the inbound side (value as released). CDP_AreaCode: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Area code of the Local Exchange where the subscriber is connected. Value as released = 987. CDP_CallingPartyCategory (Outbound): The category of the calling subscriber. One of the Group II forward signals. Some typical values are: 1 - Subscriber without priority (value as released) 2 - Subscriber with priority 3 - Maintenance equipment 5 - Telephone operator 6 - Data subscriber 11 - Subscriber with CNDB 12 - VIS subscriber

197

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_MaxDigits (Inbound): The maximum number of DNIS digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Inbound):After receiving the tone, this parameter determines whether the sender should be charged. Possible values are: 6 - Line free, chargeable (value as released). 7 - Line free, nonchargeable. CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_IS_ANIAVAILABILITY_CHECK_NEEDED: Determines whether the status of ANI availability is checked before ANI digits are exchanged. At the inbound side, this parameter specifies whether ANI availability at the outbound side has to be verified or if ANI digits can be requested directly. At the outbound side, ANI digits are passed directly or the inbound side is informed of the availability (status) first. Possible values are: 0 - The status of ANI availability is not checked before ANI digits are exchanged. ANI digits can be requested directly without knowing the status of the outbound side (value as released). 1 - The status of ANI availability is checked before ANI digits are exchanged. The inbound side requests the status of ANI availability. If ANI digits are available, the inbound side requests the ANI digits. The outbound side sends the status of ANI availability and then waits for the inbound request.

198

40. Israel R2 Bidirectional for PDKRT

CDP_IS_CALLING_LINE_IDENTIFICATION_PERMITTED (Outbound): Specifies whether Calling Line Identification is enabled. This parameter is used to enable CLIP & CLIR conditions. Possible values are: 0 - Calling Line Identification Rejected (CLIR). The requested information denied tone is sent to the inbound side. 1 - Calling Line Identification Permitted (CLIP). ANI digits are sent to the inbound side (value as released).

CDP_NO_OF_DNIS_BEFORE_CAT (Inbound): Determines how many DNIS Digits are to be received before category information. Possible values are: 0 - Category has to be received after complete DNIS (value as released). Non-zero - The number of DNIS digits received before category information is received. The following sequence of events applies: 1. 2. 3. 4. 5. Partial DNIS digits are received. Category digits are received. The remaining DNIS digits are received. ANI digits are received (if CDP_ANI_ENABLED is 1). Category digits are received again. occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: CDP_NUM_OF_DNIS_DIGITS (if non-zero) CDP_DNIS_MaxDigits Actual DNIS digits to be received

NOTE: The behavior of the protocol will not be predictable, unless the following

CDP_NUM_OF_AC_DIGITS (Inbound): Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Specifies the number of area code digits of the Local Exchange from where it received the call. Value as released = 3.

199

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_ANI_DIGITS (Inbound): The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone (value as released). Non-zero - The number of ANI digits expected. This parameter should always be less than or equal to CDP_ANI_MaxDigits.

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone. Non-zero - The number of DNIS digits. This value should always be less than or equal to CDP_DNIS_MaxDigits (value as released = 2).

CDP_REJECT_WITH_A3B4 (Inbound): Determines if call is rejected when R2MF tone error is received during call setup. Possible values are: 0 - Call is rejected with a direct groupA tone (A-10), which is a spare tone that may be used to indicate congestion (value as released). 1 - Call is rejected with an A3-B4 tone, which means the inbound (local) end sends an A-3 tone (send category and change over to group B tones). Then the category is received and in response, a B-4 tone is sent to reject the call.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only.

CDP_TrunkPrefixNumber: Valid only when the parameter CDP_ANI_WITHAC_FACILITY_CHECK_NEEDED is enabled. Trunk number used to dial to local exchange. Value as released = 9.

200

41. Israel R2 for ICAPI


The protocol modules (see Table 44) and the modifiable inbound and outbound country dependent parameters (CDP) for the Israel R2 Protocol for ICAPI are described in this chapter. Table 44. Israel R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

il_r2_i.cdp il_r2_o.cdp

il_r2_i.cdp il_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

41.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
201

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

41.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: il_r2_i CDP File Name: il_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 3. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

202

41. Israel R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

41.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: il_r2_o CDP File Name: il_r2_o.cdp
NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$25 F_OUT: Specifies if outbound calls are supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

203

42. Israel R2 CO Emulation for ICAPI


The protocol modules (see Table 45) and the modifiable inbound and outbound country dependent parameters (CDP) for the Israel R2 CO Emulation Protocol for ICAPI are described in this chapter. Table 45. Israel R2 CO Emulation Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter il_300.prm il_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

il_co_i.cdp il_co_o.cdp

il_co_i.cdp il_co_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

42.1. Protocol Limitations


None.

42.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: il_co_i

205

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: il_co_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 3. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

42.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: il_co_o CDP File Name: il_co_o.cdp

206

42. Israel R2 CO Emulation for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

207

43. Italy E-1 Bidirectional for PDKRT


The protocol modules (see Table 46) and modifiable country dependent parameters (CDP) file for the Italy E-1 Bidirectional for PDKRT protocol is described in this chapter. Table 46. Italy E-1 Protocol Modules for PDKRT File Type Protocol Modules Voice and Network Parameter Country Dependent Parameter Linux pdk_it_e1_io. psi it_300.prm Windows pdk_it_e1_io. psi it_300.prm Description The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

pdk_it_e1_io. cdp

pdk_it_e1_io. cdp

NOTES: 1. This protocol is supported on SpringWare boards only.

2. File names that have _io before the extension indicate a protocol file that can handle both inbound and outbound calls. 3. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

209

Global Call Country Dependent Parameters (CDP) Reference

43.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

43.2. E-1 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_it_e1_io CDP File Name: pdk_it_e1_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ClearBwdTimeOut: Defines the maximum time in milliseconds for a backward signal to clear. Value as released = 150 (0.150 seconds). CDP_DNIS_ENABLED: Enable or disable the reception of DNIS digits. Possible values are: 0 - Disable the reception of DNIS digits. 1 - Enable the reception of DNIS digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0.

210

43. Italy E-1 Bidirectional for PDKRT

CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated.

CDP_NUM_OF_DNIS_DIGITS (Inbound): The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone. Non-zero - The number of DNIS digits. This value should always be less than or equal to CDP_DNIS_MaxDigits. Value as released = 4.

CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_SeizeAck_Timeout: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not the outgoing call is considered to have failed. Value as released = 5000 (5 sec). CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only or CO on outbound only trunk (that is the protocol is acting as inbound only).

211

44. Italy E-1 for ICAPI


The protocol modules (see Table 47) and the modifiable inbound and outbound country dependent parameters (CDP) for the Italy E-1 Protocol for ICAPI are described in this chapter. Table 47. Italy E-1 Protocol Modules File Type Protocol Modules Linux it_e1_i.so it_e1_o.so it_e1_i.dll it_e1_o.dll Voice and Network Parameter Country Dependent Parameter it_300.prm it_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

it_e1_i.cdp it_e1_o.cdp

it_e1_i.cdp it_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

44.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
213

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

44.2. Inbound Parameters


gc_Open( ) Protocol Name: it_e1_i CDP File Name: it_e1_i.cdp The modifiable parameters are: $5: Time-out in seconds between two digits. Value as released = 0. $6: Time-out in seconds during E-1 protocol. Value as released = 12. $7: Number of DDI digits. Value as released = 4. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 0. $10: Time in seconds to wait for Idle. Value as released = 10. $11: End of selection busy used (0 = not used, 1 = used). Value as released = 0. $12: Ringback generated by terminal. Possible values: 0 (no) and 1 (yes) Value as released = 0. $13: Busy generated by terminal. Possible values: 0 (no) and 1 (yes) Value as released = 1. $14: DDI method. Possible values: 0 (pulse) and 1 (DTMF). Value as released = 1. $15: Minimum duration of a blocked signal in 55-msec units. Value as released = 4. $16: Hardware used. Possible values are 0 (DTI/212) or 1 (D/300SC-E-1). Value as released = 1. This parameter must be set to 1.

214

44. Italy E-1 for ICAPI

$22: DEBOUNCE ON value. Value as released = 3. $23: DEBOUNCE OFF value. Value as released = 3. $24: Variable number of DDI digits, only DTMF. Value as released = 0. $25: Minimum time before connection in 55-msec units. Value as released = 2. $26: Time before connection sent to the network. Value as released = 0. $27: DELAY_ACK_FLAG. Value as released = 5. $30: Value as released = 0.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

44.3. Outbound Parameters


gc_Open( ) Protocol Name: it_e1_o CDP File Name: it_e1_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 10. $6: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 80. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10.
215

Global Call Country Dependent Parameters (CDP) Reference

$11: Type of hardware, set to 1 if the protocol is to run on a D/300SC -E-1, set to 0 for a DTI/212-AT. Value as released = 1. This parameter must be set to 1. $12: Maximum time in seconds to wait for end-of-pulsing signal after dialing. Value as released = 10. $14: DDI method. Possible values are: 0 (pulse) and 1 (DTMF). Value as released = 1. $20: Delay before dialing in 55-msec units. This value must be greater than 0. Value as released = 10.

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

216

45. Kazakhstan R2 for ICAPI


The protocol modules (see Table 48) and the modifiable inbound and outbound country dependent parameters (CDP) for the Kazakhstan R2 Protocol for ICAPI are described in this chapter. Table 48. Kazakhstan R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

kz_r2_i.cdp kz_r2_o.cdp

kz_r2_i.cdp kz_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

45.1. Protocol Limitations


None.

45.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: kz_r2_i

217

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: kz_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

45.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: kz_r2_o CDP File Name: kz_r2_o.cdp

218

45. Kazakhstan R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

219

46. Korea R2 for ICAPI


The protocol modules (see Table 49) and the modifiable inbound and outbound country dependent parameters (CDP) for the Korea R2 Protocol for ICAPI are described in this chapter. Table 49. Korea R2 for ICAPI Protocol Modules File Type Protocol Modules Linux kr_r2_i.so kr_r2_o.so kr_r2_i.dll kr_r2_o.dll Voice and Network Parameter Country Dependent Parameter kr_300.prm kr_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

kr_r2_i.cdp kr_r2_o.cdp

kr_r2_i.cdp kr_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

46.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
221

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

46.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: kr_r2_i CDP File Name: kr_r2_i.cdp The modifiable parameters are: $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 3. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 2. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 4.

Global Tone Detection Usage: Tone IDs 101, 103-105, 141, 433-442, and 497511 are used by this protocol.

46.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: kr_r2_o CDP File Name: kr_r2_o.cdp

222

46. Korea R2 for ICAPI

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

223

Global Call Country Dependent Parameters (CDP) Reference

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 101, 103-105, 141, 433-442, and 497511 are used by this protocol.

224

47. Korea R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 50) for the Korea R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 50. Korea R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_kr_r2_io. hot pdk_kr_r2_io. qs SpringWare: pdk_kr_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: kr_300.prm DM3 and SpringWare: pdk_kr_r2_io. cdp Windows DM3: pdk_kr_r2_io. hot pdk_kr_r2_io. qs SpringWare: pdk_kr_r2_io. psi SpringWare only: kr_300.prm DM3 and SpringWare: pdk_kr_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

47.1. Protocol Limitations


None.

225

Global Call Country Dependent Parameters (CDP) Reference

47.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_kr_r2_io CDP File Name: pdk_kr_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0 Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2.

226

47. Korea R2 Bidirectional for PDKRT

CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

227

48. Kuwait R2 for ICAPI


The protocol modules (see Table 51) and the modifiable inbound and outbound country dependent parameters (CDP) for the Kuwait R2 Protocol for ICAPI are described in this chapter. Table 51. Kuwait R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

kw_r2_i.cdp kw_r2_o.cdp

kw_r2_i.cdp kw_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

48.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
229

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

48.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: kw_r2_i CDP File Name: kw_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

230

48. Kuwait R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

48.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: kw_r2_o CDP File Name: kw_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

231

49. Latvia R2 for ICAPI


The protocol modules (see Table 52) and the modifiable inbound and outbound country dependent parameters (CDP) for the Latvia R2 Protocol for ICAPI are described in this chapter. Table 52. Latvia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

lv_r2_i.cdp lv_r2_o.cdp

lv_r2_i.cdp lv_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

49.1. Protocol Limitations


None.

49.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: lv_r2_i

233

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: lv_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

49.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: lv_r2_o CDP File Name: lv_r2_o.cdp

234

49. Latvia R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

235

50. Lebanon R2 for ICAPI


The protocol modules (see Table 53) and the modifiable inbound and outbound country dependent parameters (CDP) for the Lebanon R2 Protocol for ICAPI are described in this chapter. Table 53. Lebanon R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

lb_r2_i.cdp lb_r2_o.cdp

lb_r2_i.cdp lb_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

50.1. Protocol Limitations


None.

50.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: lb_r2_i

237

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: lb_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

50.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: lb_r2_o CDP File Name: lb_r2_o.cdp

238

50. Lebanon R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

239

51. Lithuania R2 for ICAPI


The protocol modules (see Table 54) and the modifiable inbound and outbound country dependent parameters (CDP) for the Lithuania R2 Protocol for ICAPI are described in this chapter. Table 54. Lithuania R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

lt_r2_i.cdp lt_r2_o.cdp

lt_r2_i.cdp lt_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

51.1. Protocol Limitations


None.

51.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: lt_r2_i

241

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: lt_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

51.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: lt_r2_o CDP File Name: lt_r2_o.cdp

242

51. Lithuania R2 for ICAPI

The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the $105 parameter as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

243

52. Lucent Lineside E-1 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 55) for the Lucent Lineside E-1 Bidirectional Protocol for PDKRT are described in this chapter. Table 55. Lucent Lineside E-1 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_sw_e1_lu ls_io.hot pdk_sw_e1_lu ls_io.qs SpringWare: pdk_sw_e1_fx s_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_sw_e1_lu ls_io.cdp Windows DM3: pdk_sw_e1_lu ls_io.hot pdk_sw_e1_lu ls_io.qs SpringWare: pdk_sw_e1_fx s_io.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_sw_e1_lu ls_io.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

245

Global Call Country Dependent Parameters (CDP) Reference

52.1. Protocol Limitations


None.

52.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_sw_e1_luls_io CDP File Name: pdk_sw_e1_luls_io.cdp The modifiable parameters are: CDP_BlindXferTime: After sending the address digits on a BlindTransfer request, the protocol waits for the time specified by this parameter before sending CAS_ONHOOK and switching back to IDLE state. Value as released = 5000 (5 seconds). CDP_ConnectOnNoDialTone (Outbound): Determines how the protocol should proceed when dial tone is not detected. If the parameter is enabled (set to 1), and no dial tone is detected, a local collision with an inbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume local collision and disconnect the call if no dial tone is detected. 1 - Assume local collision and connect the perceived inbound call if no dial tone is detected (value as released). CDP_ConnectOnNoRingBack (Outbound): Determines how the protocol should proceed when no ringback tone is detected. If the parameter is enabled (set to 1), and no ringback is detected, a remote collision with a remote outbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume remote collision and disconnect the call if no ringback is detected (value as released). 1 Assume remote collision and connect the call if no ringback is detected.

246

52. Lucent Lineside E-1 Bidirectional for PDKRT

CDP_DelayInDialling (Outbound): Specifies the delay time in dialing when the parameter CDP_WaitDialToneEnabled is not enabled. Value as released = 100. CDP_DialToneWaitTime(Outbound): Defines the time that the protocol waits for a dial tone before an outbound call can be made. This parameter is only applicable only if the WaitDialToneEnabled parameter is set to 1. If the time defined by this parameter is exceeded before dial tone is detected, the action taken depends on the value of the ConnectOnNoDialTone parameter as follows: If the ConnectOnNoDialTone parameter is set to 1, a local collision is assumed and the incoming call is connected. If the ConnectOnNoDialTone parameter is set to 0, the call attempt fails and a disconnect event is forwarded with a reason of no dial tone.

Value as released = 10000 (10 seconds). CDP_MinPBXHangupTime (Inbound): This parameter specifies the length of the ring cycle and is used to determine if the remote end (that is, the PBX) has dropped an incoming call. The value of this parameter is typically set to 6 seconds which corresponds to the complete ring cycle (2 seconds on and 4 seconds of silence). The timer is reset at the start of each ring cycle. If the timer expires without resetting, ringing has been acknowledged to stop indicating the PBX has dropped the call, as the caller has abandoned the call before it was answered. Value as released = 5000 (5 seconds). CDP_OnhookTime (Outbound): If Lineside E-1 is outbound only and starts in the OFFHOOK state, it remains in the OFFHOOK state until it receives a MakeCall. This parameter specifies the time during which Lineside E-1 should remain ONHOOK before processing the MakeCall. Value as released = 500 (0.5 seconds). CDP_PBXDiscEnabled: Determines if the remote PBX can initiate call disconnection via CAS line signaling. Possible values are: 0 - Disable call disconnect supervision, since it is not supported by the PBX. 1 - Enable call disconnect supervision provided by the PBX(value as released).

247

Global Call Country Dependent Parameters (CDP) Reference

CDP_ProtocolStopsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) when the protocol stops after gc_Close( ). Possible values are: 0 - Set the hook switch state to OnHook(value as released). 1 - Set the hook switch state to OffHook.

CDP_WaitDialToneEnabled (Outbound): Determines if the protocol should wait for a dial tone before dialing. Note this parameter does not apply to supervised transfers (consultation calls) in which case the dial tone is not verified. Possible values are: 0 - Do not wait for dial tone before dialing (value as released). 1 - Wait for dial tone before dialing.

248

53. Malaysia R2 for ICAPI


The protocol modules (see Table 56) and the modifiable inbound and outbound country dependent parameters (CDP) for the Malaysia R2 Protocol for ICAPI are described in this chapter. Table 56. Malaysia R2 Protocol Modules File Type Protocol Modules Linux my_r2_i.so my_r2_o.so my_r2_i.dll my_r2_o.dll Voice and Network Parameter Country Dependent Parameter my_300.prm my_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

my_r2_i.cdp my_r2_o.cdp

my_r2_i.cdp my_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

53.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
249

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

53.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: my_r2_i CDP File Name: my_r2_i.cdp The modifiable parameters are: $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 7. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the CO supports ANI; 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0.

Global Tone Detection Usage: Tone IDs 105, 111-120, 121-127, 136-141, 143, 144, and 146 are used by this protocol.

53.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: my_r2_o CDP File Name: my_r2_o.cdp

250

53. Malaysia R2 for ICAPI

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 200. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not re-answered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

251

Global Call Country Dependent Parameters (CDP) Reference

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 105, 433-442, and 497-511 are used by this protocol.

252

54. Malaysia R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 57) for the Malaysia R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 57. Malaysia R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_my_r2_io .hot pdk_my_r2_io .qs SpringWare: pdk_my_r2_io .psi Voice and Network Parameter Country Dependent Parameter SpringWare only: my_300.prm DM3 and SpringWare: pdk_my_r2_io .cdp Windows DM3: pdk_my_r2_io .hot pdk_my_r2_io .qs SpringWare: pdk_my_r2_io .psi SpringWare only: my_300.prm DM3 and SpringWare: pdk_my_r2_io .cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

253

Global Call Country Dependent Parameters (CDP) Reference

54.1. Protocol Limitations


None.

54.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_my_r2_io CDP File Name: pdk_my_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

254

54. Malaysia R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

255

55. Malta R2 for ICAPI


The protocol modules (see Table 58) and the modifiable inbound and outbound country dependent parameters (CDP) for the Malta R2 Protocol for ICAPI are described in this chapter. Table 58. Malta R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

mt_r2_i.cdp mt_r2_o.cdp

mt_r2_i.cdp mt_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

55.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
257

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

55.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: mt_r2_i CDP File Name: mt_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

258

55. Malta R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

55.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: mt_r2_o CDP File Name: mt_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

259

56. MELCAS Bidirectional Terminal Equipment for ICAPI


The protocol modules (see Table 59) and the modifiable inbound and outbound country dependent parameters (CDP) for the MELCAS Bidirectional Terminal Equipment Protocol for ICAPI are described in this chapter. Table 59. MELCAS Bidirectional Terminal Equipment Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol module to be dynamically loaded as required. cas_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

mel_300.prm

mel_300.prm

mel_io.cdp

mel_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

261

Global Call Country Dependent Parameters (CDP) Reference

56.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued. The MELCAS protocol does not support the gc_SetCallingNum( ) function.

56.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: mel_io CDP File Name: mel_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

262

56. MELCAS Bidirectional Terminal Equipment for ICAPI

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

263

57. MELCAS Network Side for ICAPI


The protocol modules (see Table 60) and the modifiable inbound and outbound country dependent parameters (CDP) for the Network Side Protocol for ICAPI are described in this chapter. Table 60. MELCAS Network Side Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol modules to be dynamically loaded as required. cas_io.dll The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

mel_300.prm

mel_300.prm

mel_nt.cdp

mel_nt.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

57.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
265

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued. The MELCAS protocol does not support the gc_SetCallingNum( ) function.

57.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: mel_nt CDP File Name: mel_nt.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0.

266

57. MELCAS Network Side for ICAPI

$20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

267

58. Mexico R2 Bidirectional for PDKRT


The protocol modules (see Table 61) and modifiable country dependent parameters (CDP) file for the Mexico R2 Protocol is described in this chapter. Table 61. Mexico R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_mx_r2_io .hot pdk_mx_r2_io .qs SpringWare: pdk_mx_r2_io .psi Voice and Network Parameter Country Dependent Parameter SpringWare only: mx_300.prm DM3 and SpringWare: pdk_mx_r2_io .cdp Windows DM3: pdk_mx_r2_io .hot pdk_mx_r2_io .qs SpringWare: pdk_mx_r2_io .psi SpringWare only: mx_300.prm DM3 and SpringWare: pdk_mx_r2_io .cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

269

Global Call Country Dependent Parameters (CDP) Reference

58.1. Protocol Limitations


None.

58.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_mx_r2_io CDP File Name: pdk_mx_r2_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ANI_ENABLED: Enable or disable the reception of ANI digits. Possible values are: 0 - Disable the reception of ANI digits. 1 - Enable the reception of ANI digits (value as released).
NOTE: The behavior of the protocol is not predictable if this parameter is

set to a value other than 1 or 0. CDP_ANI_MaxDigits (Inbound): The maximum number of ANI digits that can be received when using this protocol as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_CallingPartyCategory_3: The category of the calling subscriber, II(3). Some typical values are: 1 - Operator with offering facility (value as released) 2 - Normal Subscriber 3 - Reserve 4 - Reserve
270

58. Mexico R2 Bidirectional for PDKRT

5 - ATME equipment 6 - Maintenance equipment 7 - Reserve 8 - Reserve - interception operator 9-15 - Reserve CDP_CallingPartyCategory_6: The category of the calling subscriber, II(3). Some typical values are: 1 - Reserve 2 - Normal subscriber 3 - Box (value as released) 4 - Time and Cost 5 - Reserve - equipment ATME 6 - Maintenance equipment 7 - Share - 2 8 - Share - 3 9 - Share - 1 10 - Reserve - Operator without possibility of offer 11-15 - Reserve CDP_DNIS_DIGITS_BEFORE_ANI: Determines the number of DNIS digits that are to be received before any ANI digits are received . Possible values are: 0 - Indicates that ANI digits must be received after all DNIS digits are received (value as released). Non-zero - The number of DNIS digits received before ANI digits are received. If this parameter is set to non-zero, the following sequence of events applies: 1. 2. Partial DNIS digits are received. Category digit(s) are received.
271

Global Call Country Dependent Parameters (CDP) Reference

3. 4. 5.

Remaining DNIS digits are received. ANI digits are received. Category digits are received again. following occurs: If this parameter is set to non-zero, CDP_ANI_ENABLED must be set to 1. If this parameter is set to non-zero, this value should be the minimum of: the CDP_NUM_OF_DNIS_DIGITS (if non-zero), DNIS_MaxDigits, and the actual DNIS digits to be received.

NOTE: The behavior of the protocol will not be predictable, unless the

CDP_DNIS_ENABLED: Enable or disable the reception of DNIS digits. Possible values are: 0 - Disable the reception of DNIS digits. 1 - Enable the reception of DNIS digits (value as released).
NOTE: Even if this parameter is set to 0, the first forward tone received will

be the first DNIS digit only. The behavior of the protocol is not predictable if this parameter is set to a value other than 1 or 0. CDP_DNIS_MaxDigits: The maximum number of DNIS digits that can be received when using this protocol. Value as released = 16.
NOTE: If this value is set to 0, the behavior of the protocol is not

predictable. CDP_GrpB_Tone (Outbound): After receiving the tone, this parameter determines whether the sender should be charged. This tone is sent on receipt of the category for Group II. After receiving this tone, the sequence of R2MF tone exchange is over and the call is connected. This is the last R2MF tone in establishment of a call. Possible values are: 1 - Line free, chargeable (value as released). 6 - Line free, nonchargeable.

272

58. Mexico R2 Bidirectional for PDKRT

CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated.

CDP_NUM_OF_ANI_DIGITS: The expected number of ANI digits to be received. Possible values are: 0 - ANI collection is terminated by an I-15 tone (value as released). Non-zero - The number of ANI digits expected. This number should always be less than CDP_ANI_MaxDigits.

CDP_NUM_OF_DNIS_DIGITS: The expected number of DNIS digits to be received. Possible values are: 0 - DNIS collection is terminated by an I-15 tone (value as released). Non-zero - The number of DNIS digits. This value should always be less than or equal to CDP_DNIS_MaxDigits. Value as released = 4.

CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bidirectional (value as released). 1 - If the protocol is used as inbound only.

273

59. Mexico R2 for ICAPI


The protocol modules (see Table 62) and the modifiable inbound and outbound country dependent parameters (CDP) for the Mexico R2 Protocol for ICAPI are described in this chapter. Table 62. Mexico R2 Protocol Modules File Type Protocol Modules Linux mx_r2_i.so mx_r2_o.so mx_r2_i.dll mx_r2_o.dll Voice and Network Parameter Country Dependent Parameter mx_300.prm mx_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

mx_r2_i.cdp mx_r2_o.cdp

mx_r2_i.cdp mx_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

59.1. Protocol Limitations


None.

59.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: mx_r2_i

275

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: mx_r2_i.cdp The modifiable parameters are: $6: Digit time-out in seconds, specifies the maximum duration of a compelled cycle for inbound calls. Value as released = 15. $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 12. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0. $44: Set to 1 to quickly release the line at disconnection time. This reduces the possibility of additional charges after terminal disconnection. Set to 0 to use normal disconnection procedure. Value as released = 0. $47: Delay in seconds between metering pulses. This parameter is only used for testing the countrys outbound protocol: it controls the sending of metering pulses. It must always be 0 when working on the public network. Value as released = 0.

Global Tone Detection Usage: Tone IDs 105, 433-439, 451-454, and 497-511 are used by this protocol.

59.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: mx_r2_o CDP File Name: mx_r2_o.cdp
276

59. Mexico R2 for ICAPI

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 400. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $11: Digit time-out in seconds, specifies the maximum duration of a forward tone. When the time-out expires, the protocol sends the GCEV_DISCONNECTED event to the application. Value as released = 5. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

277

Global Call Country Dependent Parameters (CDP) Reference

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 105, 433-442, and 497-511 are used by this protocol.

278

60. Mexico R2 Bidirectional for ICAPI


The protocol modules (see Table 63) and the modifiable inbound and outbound country dependent parameters (CDP) for the Mexico Bidirectional R2 Protocol for ICAPI are described in this chapter. Table 63. Mexico R2 Bidirectional Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol modules to be dynamically loaded as required. r2_io.dll The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

mx_300.prm

mx_300.prm

mx_r2_io.cdp

mx_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

60.1. Protocol Limitations


None.

60.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: mx_r2_io

279

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: mx_r2_io.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1. $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

280

60. Mexico R2 Bidirectional for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

281

61. Morocco R2 for ICAPI


The protocol modules (see Table 64) and the modifiable inbound and outbound country dependent parameters (CDP) for the Morocco R2 Protocol for ICAPI are described in this chapter. Table 64. Morocco R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ma_r2_i.cdp ma_r2_o.cdp

ma_r2_i.cdp ma_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

61.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
283

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

61.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ma_r2_i CDP File Name: ma_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

284

61. Morocco R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

61.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ma_r2_o CDP File Name: ma_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

285

62. Netherlands Bidirectional Terminal Equipment Side for ICAPI


The protocol modules (see Table 65) and the modifiable inbound and outbound country dependent parameters (CDP) for the Netherlands Bidirectional Terminal Equipment Protocol for ICAPI are described in this chapter. Table 65. Netherlands Bidirectional Terminal Equipment Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol module to be dynamically loaded as required. cas_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

nl_300.prm

nl_300.prm

alste_io.cdp

alste_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

287

Global Call Country Dependent Parameters (CDP) Reference

62.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

62.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: alste_io CDP File Name: alste_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when 4 DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1.

288

62. Netherlands Bidirectional Terminal Equipment Side for ICAPI

$20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

289

63. Netherlands Network Side for ICAPI


The protocol modules (see Table 66) and the modifiable inbound and outbound country dependent parameters (CDP) for the Network Side Protocol for ICAPI are described in this chapter. Table 66. Netherlands Network Side Protocol Modules File Type Protocol Modules Linux cas_io.so Windows Description The shared protocol modules to be dynamically loaded as required. cas_io.dll The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

nl_300.prm

nl_300.prm

alsnt_io.cdp

alsnt_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

63.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

291

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

63.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: alsnt_io CDP File Name: alsnt_io.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0.

292

63. Netherlands Network Side for ICAPI

$20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of the tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

293

64. Nigeria R2 for ICAPI


The protocol modules (see Table 67) and the modifiable inbound and outbound country dependent parameters (CDP) for the Nigeria R2 Protocol for ICAPI are described in this chapter. Table 67. Nigeria R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ng_r2_i.cdp ng_r2_o.cdp

ng_r2_i.cdp ng_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

64.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
295

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

64.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ng_r2_i CDP File Name: ng_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

296

64. Nigeria R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

64.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ng_r2_o CDP File Name: ng_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

297

65. Nortel Meridian Lineside E-1 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 68) for the Nortel Meridian Lineside E-1 Bidirectional Protocol for PDKRT are described in this chapter. Table 68. Nortel Meridian Lineside E-1 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_sw_e1_nt md_io.hot pdk_sw_e1_nt md_io.qs SpringWare: pdk_sw_e1_fx s_io.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_sw_e1_nt md_io.cdp Windows DM3: pdk_sw_e1_nt md_io.hot pdk_sw_e1_nt md_io.qs SpringWare: pdk_sw_e1_fx s_io.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_sw_e1_nt md_io.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

299

Global Call Country Dependent Parameters (CDP) Reference

65.1. Protocol Limitations


None.

65.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_sw_e1_ntmd_io CDP File Name: pdk_sw_e1_ntmd_io.cdp The modifiable parameters are: CDP_BlindXferTime: After sending the address digits on a BlindTransfer request, the protocol waits for the time specified by this parameter before sending CAS_ONHOOK and switching back to IDLE state. Value as released = 5000 (5 seconds). CDP_ConnectOnNoDialTone (Outbound): Determines how the protocol should proceed when dial tone is not detected. If the parameter is enabled (set to 1), and no dial tone is detected, a local collision with an inbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume local collision and disconnect the call if no dial tone is detected. 1 - Assume local collision and connect the perceived inbound call if no dial tone is detected (value as released). CDP_ConnectOnNoRingBack (Outbound): Determines how the protocol should proceed when no ringback tone is detected. If the parameter is enabled (set to 1), and no ringback is detected, a remote collision with a remote outbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume remote collision and disconnect the call if no ringback is detected (value as released). 1 - Assume remote collision and connect the call if no ringback is detected.

300

65. Nortel Meridian Lineside E-1 Bidirectional for PDKRT

CDP_DelayInDialling (Outbound): Specifies the delay time in dialing when the parameter CDP_WaitDialToneEnabled is not enabled. Value as released = 100. CDP_DialToneWaitTime(Outbound): Defines the time that the protocol waits for a dial tone before an outbound call can be made. This parameter is only applicable only if the WaitDialToneEnabled parameter is set to 1. If the time defined by this parameter is exceeded before dial tone is detected, the action taken depends on the value of the ConnectOnNoDialTone parameter as follows: If the ConnectOnNoDialTone parameter is set to 1, a local collision is assumed and the incoming call is connected. If the ConnectOnNoDialTone parameter is set to 0, the call attempt fails and a disconnect event is forwarded with a reason of no dial tone.

Value as released = 10000 (10 seconds). CDP_MinPBXHangupTime (Inbound): This parameter specifies the length of the ring cycle and is used to determine if the remote end (that is, the PBX) has dropped an incoming call. The value of this parameter is typically set to 6 seconds which corresponds to the complete ring cycle (2 seconds on and 4 seconds of silence). The timer is reset at the start of each ring cycle. If the timer expires without resetting, ringing has been acknowledged to stop indicating the PBX has dropped the call, as the caller has abandoned the call before it was answered. Value as released = 5000 (5 seconds). CDP_OnhookTime (Outbound): If Lineside E-1 is outbound only and starts in the OFFHOOK state, it remains in the OFFHOOK state until it receives a MakeCall. This parameter specifies the time during which Lineside E-1 should remain ONHOOK before processing the MakeCall. Value as released = 500 (0.5 seconds). CDP_PBXDiscEnabled: Determines if the remote PBX can initiate call disconnection via CAS line signaling. Possible values are: 0 - Disable call disconnect supervision, since it is not supported by the PBX. 1 - Enable call disconnect supervision provided by the PBX(value as released).

301

Global Call Country Dependent Parameters (CDP) Reference

CDP_ProtocolStopsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) when the protocol stops after gc_Close( ). Possible values are: 0 - Set the hook switch state to OnHook(value as released). 1 - Set the hook switch state to OffHook.

CDP_WaitDialToneEnabled (Outbound): Determines if the protocol should wait for a dial tone before dialing. Note this parameter does not apply to supervised transfers (consultation calls) in which case the dial tone is not verified. Possible values are: 0 - Do not wait for dial tone before dialing (value as released). 1 - Wait for dial tone before dialing.

302

66. North American Analog Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 69) for the North American Analog Bidirectional Protocol for PDKRT are described in this chapter. Table 69. North American Analog Bidirectional for PDKRT Protocol Modules File Type Protocol Module Country Dependent Parameter Linux pdk_na_an_io .psi pdk_na_an_io .cdp Windows pdk_na_an_io .psi pdk_na_an_io .cdp Description The protocol module to be dynamically loaded as required. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

NOTES: 1. This protocol is supported on SpringWare boards only.

2. File names that have _io before the extension indicate a protocol file that can handle both inbound and outbound calls. 3. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific. Refer to the Global Call Analog Technology Users Guide for detailed information about using these files with the Global Call software.

66.1. Protocol Limitations


None.

303

Global Call Country Dependent Parameters (CDP) Reference

66.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_na_an_io CDP File Name: pdk_na_an_io.cdp
NOTE: A parameter can be inbound, outbound, or both inbound and outbound.

An inbound parameter is used by the protocol when it is acting as inbound. An outbound parameter is used by the protocol when it is acting as outbound. A parameter that is both can be used by the protocol when it is acting as either inbound or outbound. The modifiable parameters are: CDP_ConnectOnNoRingBack (Outbound): Determines how the protocol should proceed when a remote collision occurs, that is, when the remote side (PBX) is making an outbound call and an inbound call is detected. In this case, call analysis on the local side will indicate no ringback tone. Setting this parameter can configure the protocol to connect the call even if a ringback tone is not detected. Possible values are: 0 - Do not connect a call if no ringback is detected. 1 - Connect a call even if no ringback is detected (value as released).
NOTE: On media detection by call analysis, this parameter is overridden.

CDP_Dgts_For_Outside_Line_In_PBX_ENV (Outbound): Specifies the digit to be dialed for a PBX outside line. This parameter is valid only when the parameter CDP_Working_Under_PBX_Env is set to 1. See description of CDP_Working_Under_PBX_Env. Value as released = 9. CDP_DialTone_As_Disconnect_In_Connected: Specifies if the reception of a dial tone is treated as a remote disconnect in the connected state. Possible values are: 0 - dial tone is ignored if received in Connected state (value as released). 1 - reception of dial tone is treated as a remote disconnect in the connected state.

CDP_PBX_DialToneTimeout (Outbound): Specifies the maximum time (in milliseconds) that the protocol waits for PBX Dial Tone before sending out Digits. This parameter is valid only when the parameter

304

66. North American Analog Bidirectional for PDKRT

CDP_Working_Under_PBX_Env is set to 1. Value as released = 5000 (5 seconds). CDP_Time_Before_Blind_Dialing_Under_PBX_Env (Outbound): Specifies the time that the protocol waits before dialing any digits if working under a PBX environment. If the parameter CDP_Working_Under_PBX_Env is 0, this parameter is ignored. If the value of this parameter is 0, the protocol waits for the PBX dial tone before dialing any digits. If the value of this parameter is > 0, the protocol does not wait for the PBX dial tone; instead the protocol waits for the time (in milliseconds) specified by this parameter before dialing any digits. Possible values are: 0 - Ignore parameter. The protocol waits for a PBX Dial Tone before dialing any digits (value as released). Nonzero - Protocol does not wait for PBX Dial Tone. Instead, the protocol waits for the time (in milliseconds) specified by this parameter before dialing any digits. CDP_Timeout_Wait_For_RingOff_When_Drop_In_Offered (Inbound): Specifies the maximum time (in milliseconds) that the protocol waits for the outbound side to stop ringing before sending a GCEV_DROPCALL to the application, if DropCall is issued in the offered state. GCEV_DROPCALL is sent to the application at the expiration of this timer, or when RingOff is detected, whichever comes first. If the value of this parameter is 0, GCEV_DROPCALL is sent as soon as the protocol receives the DropCall request. Value as released = 0. CDP_Working_Under_PBX_Env (Outbound): If set to 1, while making a call, the following sequence of actions is taken by the protocol: 1. 2. 3. 4. 5. 6. Go Off-hook. If CDP_Time_Before_Blind_Dialing_Under_PBX_Env is 0, go to step 3. Otherwise, go to step 5. Wait for PBX Dial Tone (defined by TONE_PBX_DIAL). Go to step 6. Wait for CDP_Time_Before_Blind_Dialing_Under_PBX_Env milliseconds. Dial the digit(s) specified by CDP_Dgts_For_Outside_Line_In_PBX_ENV.
305

Global Call Country Dependent Parameters (CDP) Reference

7. 8.

Wait for regular dial tone defined by TONE_DIAL (should not be modified by the user). Dial Number specified by application via the gc_MakeCall( ) function.

If set to 0, skip steps 2 to 6 above (value as released).

306

67. Norway R2 for ICAPI


The protocol modules (see Table 70) and the modifiable inbound and outbound country dependent parameters (CDP) for the Norway R2 Protocol for ICAPI are described in this chapter. Table 70. Norway R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

no_r2_i.cdp no_r2_o.cdp

no_r2_i.cdp no_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

67.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
307

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

67.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: no_r2_i CDP File Name: no_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 0.

308

67. Norway R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

67.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: no_r2_o CDP File Name: no_r2_o.cdp
NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105: If tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before returning a GCEV_CALLSTATUS. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

309

68. Pakistan R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 71) for the Pakistan R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 71. Pakistan R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_pk_r2_io. hot pdk_pk_r2_io. qs SpringWare: pdk_pk_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_pk_r2_io. cdp Windows DM3: pdk_pk_r2_io. hot pdk_pk_r2_io. qs SpringWare: pdk_pk_r2_io. psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_pk_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

311

Global Call Country Dependent Parameters (CDP) Reference

68.1. Protocol Limitations


None.

68.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_pk_r2_io CDP File Name: pdk_pk_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

312

68. Pakistan R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

313

69. Philippines R2 for ICAPI


The protocol modules (see Table 72) and the modifiable inbound and outbound country dependent parameters (CDP) for the Philippines R2 Protocol for ICAPI are described in this chapter. Table 72. Philippines R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ph_r2_i.cdp ph_r2_o.cdp

ph_r2_i.cdp ph_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

69.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
315

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

69.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ph_r2_i CDP File Name: ph_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

316

69. Philippines R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

69.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ph_r2_o CDP File Name: ph_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

317

70. Philippines R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 73) for the Philippines R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 73. Philippines R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_ph_r2_io. hot pdk_ph_r2_io. qs SpringWare: pdk_ph_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_ph_r2_io. cdp Windows DM3: pdk_ph_r2_io. hot pdk_ph_r2_io. qs SpringWare: pdk_ph_r2_io. psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_ph_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

319

Global Call Country Dependent Parameters (CDP) Reference

70.1. Protocol Limitations


None.

70.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_ph_r2_io CDP File Name: pdk_ph_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

320

70. Philippines R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

321

71. Poland R2 for ICAPI


The protocol modules (see Table 74) and the modifiable inbound and outbound country dependent parameters (CDP) for the Poland R2 Protocol for ICAPI are described in this chapter. Table 74. Poland R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

po_r2_i.cdp po_r2_o.cdp

po_r2_i.cdp po_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

71.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
323

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

71.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: po_r2_i CDP File Name: po_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

324

71. Poland R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

71.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: po_r2_o CDP File Name: po_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

325

72. Portugal R2 for ICAPI


The protocol modules (see Table 75) and the modifiable inbound and outbound country dependent parameters (CDP) for the Portugal R2 Protocol for ICAPI are described in this chapter. Table 75. Portugal R2 Protocol Modules File Type Protocol Modules Linux pt_e1_i.so pt_e1_o.so pt_e1_i.dll pt_e1_o.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

pt_e1_i.cdp pt_e1_o.cdp

pt_e1_i.cdp pt_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

72.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
327

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

72.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: pt_e1_i CDP File Name: pt_e1_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

328

72. Portugal R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

72.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: pt_e1_o CDP File Name: pt_e1_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

329

73. Romania R2 for ICAPI


The protocol modules (see Table 76) and the modifiable inbound and outbound country dependent parameters (CDP) for the Romania R2 Protocol for ICAPI are described in this chapter. Table 76. Romania R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ro_r2_i.cdp ro_r2_o.cdp

ro_r2_i.cdp ro_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

73.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
331

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

73.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ro_r2_i CDP File Name: ro_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

332

73. Romania R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

73.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ro_r2_o CDP File Name: ro_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

333

74. Saudi Arabia R2 for ICAPI


The protocol modules (see Table 77) and the modifiable inbound and outbound country dependent parameters (CDP) for the Saudi Arabia R2 Protocol for ICAPI are described in this chapter. Table 77. Saudi Arabia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

sa_r2_i.cdp sa_r2_o.cdp

sa_r2_i.cdp sa_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

74.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
335

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

74.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: sa_r2_i CDP File Name: sa_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

336

74. Saudi Arabia R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

74.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: sa_r2_o CDP File Name: sa_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

337

75. Singapore R2 for ICAPI


The protocol modules (see Table 78) and the modifiable inbound and outbound country dependent parameters (CDP) for the Singapore R2 Protocol for ICAPI are described in this chapter. Table 78. Singapore R2 Protocol Modules File Type Protocol Modules Linux sg_r2_i.so sg_r2_o.so sg_r2_i.dll sg_r2_o.dll Voice and Network Parameter Country Dependent Parameter sg_300.prm sg_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

sg_r2_i.cdp sg_r2_o.cdp

sg_r2_i.cdp sg_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

75.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
339

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

75.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: sg_r2_i CDP File Name: sg_r2_i.cdp The modifiable parameters are: $7: Number of DDI digits, depends on the trunk. Check with local PTT. Value as released = 4. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) returns an empty string. Value as released = 8. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $16: Set to 1 if the CO supports ANI; 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0.

Global Tone Detection Usage: Tone IDs 101, 103-105, 141, 433-442, 451-454, and 497-511 are used by this protocol.

75.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: sg_r2_o CDP File Name: sg_r2_o.cdp

340

75. Singapore R2 for ICAPI

NOTE: This protocol does not require call analysis, because the called party

condition is received via R2 tones. However, call progress tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call status using R2 tones. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $2: Minimum blocking time in 10-msec units. Value as released = 0. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_DISCONNECTED event is sent if answer is not detected within the specified time interval. Value as released = 80. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not re-answered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero.

341

Global Call Country Dependent Parameters (CDP) Reference

$49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 101, 103-105, 433-442, 451-454, and 497-511 are used by this protocol.

342

76. Singapore R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 79) for the Singapore R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 79. Singapore R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_sg_r2_io. hot pdk_sg_r2_io. qs SpringWare: pdk_sg_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: sg_300.prm DM3 and SpringWare: pdk_sg_r2_io. cdp Windows DM3: pdk_sg_r2_io. hot pdk_sg_r2_io. qs SpringWare: pdk_sg_r2_io. psi SpringWare only: sg_300.prm DM3 and SpringWare: pdk_sg_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

343

Global Call Country Dependent Parameters (CDP) Reference

76.1. Protocol Limitations


None.

76.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_sg_r2_io CDP File Name: pdk_sg_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

344

76. Singapore R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

345

77. Slovakia R2 for ICAPI


The protocol modules (see Table 80) and the modifiable inbound and outbound country dependent parameters (CDP) for the Slovakia R2 Protocol for ICAPI are described in this chapter. Table 80. Slovakia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

sk_r2_i.cdp sk_r2_o.cdp

sk_r2_i.cdp sk_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

77.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
347

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

77.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: sk_r2_i CDP File Name: sk_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

348

77. Slovakia R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

77.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: sk_r2_o CDP File Name: sk_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

349

78. South Africa R2 for ICAPI


The protocol modules (see Table 81) and the modifiable inbound and outbound country dependent parameters (CDP) for the South Africa R2 Protocol for ICAPI are described in this chapter. Table 81. South Africa R2 Protocol Modules File Type Protocol Modules Linux za_r2_i.so za_r2_o.so za_r2_i.dll za_r2_o.dll Voice and Network Parameter Country Dependent Parameter za_300.prm za_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

za_r2_i.cdp za_r2_o.cdp

za_r2_i.cdp za_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

78.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
351

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

78.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: za_r2_i CDP File Name: za_r2_i.cdp The modifiable parameters are: $4: Metering pulse length in 10-msec units. Value as released = 20. $6: Time-out for incoming calls in seconds. Value as released = 15. $7: Number of DDI digits. Value as released = 4. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for idle pattern on the line. Value as released = 10. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 0. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 1. $46: Optional protocol mask. Value as released = 0. The bits have the following meaning: Bit 0: If set, A4 can be used to reject a call. If not set, call rejection is done using A6 and busy tone generation.

352

78. South Africa R2 for ICAPI

Bit 1: If set, use Pulse Answer mode). If not set, use Answer Clearback mode or Pulse Clearback mode. When Pulse mode is selected, parameter $47 should not be set to 0. This bit should always be 0 when connected to the PSTN.

$47: Delay between metering pulses. Set to 0 to disable. This value should always be set to 0 when connected to the PSTN. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

78.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: za_r2_o CDP File Name: za_r2_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time between two rings in 10-msec units to detect answer. Value as released = 0. $4: Metering pulse length in 10-msec units. Value as released = 20. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $11: Time-out during digit in seconds for outbound calls. Value as released = 15. $12: Time-out between digits in seconds for outbound calls. Value as released = 24.
353

Global Call Country Dependent Parameters (CDP) Reference

$13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60. $46: Protocol option mask. Value as released = 0. The meaning of the significant bits is as follows: Bit 0: Not used. Bit 1: If set, use Pulse Answer mode. If not set, use Answer Clearback mode or Pulse Clearback mode.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: None.

354

79. South Africa R2 (CO Emulation) for ICAPI


The protocol modules (see Table 82) and the modifiable inbound and outbound country dependent parameters (CDP) for the South Africa R2 (CO Emulation) Protocol for ICAPI are described in this chapter. Table 82. South Africa R2 (CO Emulation) for ICAPI Protocol Modules File Type Protocol Modules Linux za_r2_i.so za_r2_o.so za_r2_i.dll za_r2_o.dll Voice and Network Parameter Country Dependent Parameter za_300n.prm za_300n.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

za_co_i.cdp za_co_o.cdp

za_co_i.cdp za_co_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

79.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

355

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

79.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: za_co_i CDP File Name: za_co_i.cdp The modifiable parameters are: $4: Metering pulse length in 10-msec units. Value as released = 20. $6: Time-out for incoming calls in seconds. Value as released = 15. $7: Number of DDI digits. Value as released = 4. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for idle pattern on the line. Value as released = 10. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 0. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 1.

356

79. South Africa R2 (CO Emulation) for ICAPI

$46: Optional protocol mask. Value as released = 0. The bits have the following meaning: Bit 0: If set, A4 can be used to reject a call. If not set, call rejection is done using A6 and busy tone generation. Bit 1: If set, use Pulse Answer mode. If not set, use Answer Clearback mode or Pulse Clearback mode. When Pulse mode is selected, parameter $47 should not be set to 0. This bit should always be 0 when connected to the PSTN.

$47: Delay between metering pulses. Set to 0 to disable. This value should always be set to 0 when connected to the PSTN. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

79.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: za_co_o CDP File Name: za_co_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time between two rings in 10-msec units to detect answer. Value as released = 0. $4: Metering pulse length in 10-msec units. Value as released = 20. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10.
357

Global Call Country Dependent Parameters (CDP) Reference

$11: Time-out during digit in seconds for outbound calls. Value as released = 15. $12: Time-out between digits in seconds for outbound calls. Value as released = 24. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60. $46: Protocol option mask. Value as released = 0. The meaning of the significant bits is as follows: Bit 0: Not used. Bit 1: If set, use Pulse Answer mode. If not set, use Answer Clearback mode or Pulse Clearback mode.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

358

79. South Africa R2 (CO Emulation) for ICAPI

Global Tone Detection Usage: None.

359

80. Spain E-1 for ICAPI


The protocol modules (see Table 83) and the modifiable inbound and outbound country dependent parameters (CDP) for the Spain E-1 Protocol for ICAPI are described in this chapter. Table 83. Spain E-1 for ICAPI Protocol Modules File Type Protocol Modules Linux es_e1_i.so es_e1_o.so es_e1_i.dll es_e1_o.dll Voice and Network Parameter Country Dependent Parameter es_300.prm es_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

es_e1_i.cdp es_e1_o.cdp

es_e1_i.cdp es_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

80.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
361

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

80.2. E-1 Inbound Parameters


gc_Open( ) Protocol Name: es_e1_i This protocol implements 2 of 5 coding (uses 2 of the 5 available tones). CDP File Name: es_e1_i.cdp The modifiable parameters are: $7: Number of digits in area. Possible values are 6 or 7. Only use to test the outbound protocol (see parameter $12). Value as released = 7. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $12: Used only for outbound testing. Set to 1 to request call category (send A3 instead of A4). The protocol requests all digits according to the call category and number of digits in the area (see parameter $7). Set this parameter to 0 when working on the PSTN. Value as released = 1. $20: Set to 1 to answer a call with B9 and play progress tone. Use only to test outbound protocol call progress capability. Set to 0 when working with the PSTN. Value as released = 0.

Global Tone Detection Usage: Tone IDs 103, 105, and 496-506 are used by this protocol.

80.3. E-1 Outbound Parameters


gc_Open( ) Protocol Name: es_e1_o

362

80. Spain E-1 for ICAPI

This protocol implements 2 of 5 coding (uses 2 of the 5 available tones). CDP File Name: es_e1_o.cdp
NOTE: This protocol requires call analysis in some cases. Therefore, 2 different

busy tones are available in the .cdp file. Their default values accommodate the national specification. The connect indication is always returned with DTI events, but a ringback tone is available in the .cdp file to count the rings and disconnect when the maximum number of rings is reached. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $1: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a line basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 60. $5: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $7: Number of digits in area. Possible values are 6 or 7 depending on the zone, check with PTT. The Spain protocol has a strict numbering plan. The type of call (local, national, international or service) must be specified to the network. The protocol uses the length of the telephone number to determine the type of call: 10 digits or more - international call, must start with country code 8 digits - national call, must start with area code (1for Madrid) 6 or 7 digits - local call (value as released) 3 digits - special service call

NOTE: All other phone number lengths are rejected.

Global Tone Detection Usage: Tone IDs 103-105 and 496-506 are used by this protocol.

363

81. Spain E-1 (2 of 6) for ICAPI


The protocol modules (see Table 84) and the modifiable inbound and outbound country dependent parameters (CDP) for the Spain E-1 (2 of 6) Parameters Protocol for ICAPI are described in this chapter. Table 84. Spain E-1 (2 of 6) for ICAPI Protocol Modules File Type Protocol Modules Linux es_e1_i.so es_e1_o.so es_e1_i.dll es_e1_o.dll Voice and Network Parameter Country Dependent Parameter es_300.prm es_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

es_26_i.cdp es_26_o.cdp

es_26_i.cdp es_26_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

81.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
365

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

81.2. E-1 Inbound Parameters


gc_Open( ) Protocol Name: es_26_i CDP File Name: es_26_i.cdp This protocol implements 2 of 6 coding (uses 2 of the 6 available tones). The modifiable parameters are: $0: Protocol type. Possible values are 0 (2 of 5) or 1 (2 of 6). Value as released = 1. $7: Number of digits in area. Possible values are 6 or 7. Only use to test the outbound protocol (see parameter $12). Value as released = 7. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10. $12: Used only for outbound testing. Set to 1 to request call category (send A3 instead of A4). The protocol requests all digits according to the call category and number of digits in the area (see parameter $7). Set this parameter to 0 when working on the PSTN. Value as released = 1. $20: Set to 1 to answer a call with B9 and play progress tone. Use only to test outbound protocol call progress capability. Set to 0 when working with the PSTN. Value as released = 0. $13: T2 in seconds. Value as released = 10. $14: T3 in seconds. Value as released = 5. $15: T4 in seconds. Value as released = 5.

366

81. Spain E-1 (2 of 6) for ICAPI

$16: T5 in seconds. Value as released = 90. $17: T6 in seconds. Value as released = 2.

Global Tone Detection Usage: Tone IDs 103, 105, and 496-511 are used by this protocol.

81.3. E-1 Outbound Parameters


gc_Open( ) Protocol Name: es_26_o CDP File Name: es_26_o.cdp This protocol implements 2 of 6 coding (uses 2 of the 6 available tones).
NOTE: This protocol requires call analysis in some cases. Therefore, 2 different

busy tones are available in the .cdp file. Their default values accommodate the national specification. The connect indication is always returned with DTI events, but a ringback tone is available in the .cdp file to count the rings and disconnect when the maximum number of rings is reached. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $0: Protocol type. Possible values are 0 (2 of 5) or 1 (2 of 6). Value as released = 1. $1: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a line basis. GCEV_DISCONNECTED event is sent if answer is not detected within time-out. Value as released = 60. $5: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $7: Number of digits in area. Possible values are 6 or 7 depending on the zone, check with PTT. The Spain protocol has a strict numbering plan. The

367

Global Call Country Dependent Parameters (CDP) Reference

type of call (local, national, international or service) must be specified to the network. The protocol uses the length of the telephone number to determine the type of call: 10 digits or more - international call, must start with country code 8 digits - national call, must start with area code (1for Madrid) 6 or 7 digits - local call (default) 3 digits - special service call

NOTE: All other phone number lengths are rejected.

$11: Minimum idle time in 55-msec units. Value as released = 12. $12: Disconnection supervision in seconds. Value as released = 60. $14: T1 in seconds. Value as released = 10. $15: T2 in seconds. Value as released = 20. $16: T3 in seconds. Value as released = 5. $17: T4 in seconds. Value as released = 5. $18: T5 in seconds. Value as released = 90. $19: T6 in 10-msec units. Value as released = 6.

Global Tone Detection Usage: Tone IDs 103-105 and 496-511 are used by this protocol.

368

82. Spain E-1 CO Emulation for ICAPI


The protocol modules (see Table 85) and the modifiable inbound and outbound country dependent parameters (CDP) for the Spain E-1 CO Emulation protocol are described in this chapter. Table 85. Spain E-1 CO Emulation for ICAPI Protocol Modules File Type Protocol Modules Linux es_e1_i.so es_e1_o.so es_e1_i.dll es_e1_o.dll Voice and Network Parameter Country Dependent Parameter es_300.prm es_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

es_co_i.cdp es_co_o.cdp

es_co_i.cdp es_co_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

82.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
369

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

82.2. E-1 Inbound Parameters


gc_Open( ) Protocol Name: es_co_i CDP File Name: es_co_i.cdp The modifiable parameters are: %01: Defines the cadence detection, which analyzes the audio signal on the line to detect a repeating pattern of sound (on time) and silence (off time). The deviation value for cadence detection is the allowable variation in 10-ms units. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. @103: Defines the tone for busy signal generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. frequency: Defines the frequency detection, which determines the pitch of the signal. Value as released = 425. deviation = -12 (value as released). %01: Cadence. Values as released = 20, 15.

@105: Defines the tone for ringback generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. frequency: Defines the frequency detection, which determines the pitch of the signal. Value as released = 425. deviation = -12 (value as released). %01: cadence (in 10-millisecond units). Values as released = 150, 300.

370

82. Spain E-1 CO Emulation for ICAPI

The maximum allowable time between successive rings is defined in parameter $3 in 10-millisecond units.

82.3. E-1 Outbound Parameters


gc_Open( ) Protocol Name: es_co_o CDP File Name: es_co_o.cdp
NOTE: This protocol requires call analysis in some cases. Therefore, two

different busy tones are available in the .cdp file. Their default values accommodate the national specification. The connect indication is always returned with DTI events, but a ringback tone is available in the .cdp file to count the rings and disconnect when the maximum number of rings is reached. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call analysis capability. The modifiable parameters are: $5: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $49: Number of digits in area. Possible values are 6 or 7 depending on the zone, check with PTT. The Spain protocol has a strict numbering plan. The type of call (local, national, international or service) must be specified to the network. The protocol uses the length of the telephone number to determine the type of call. $103: Defines the busy tone as follows: <frequency 1> <deviation> <frequency 2> <deviation>. frequency: Defines the frequency detection, which determines the pitch of the signal. Value as released = 425. deviation = 35 (value as released). %01: cadence (in 10-millisecond units). Values as released = 20, 4, 20, 4.

371

Global Call Country Dependent Parameters (CDP) Reference

%02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone detected. Value as released (in 10-millisecond units) = 3.

$104: Defines the fast busy tone as follows: <frequency 1> <deviation> <frequency 2> <deviation>. frequency: Defines the frequency detection, which determines the pitch of the signal. Value as released = 425. deviation = 35 (value as released). %01: cadence (in 10-millisecond units).Value as released = 120. %02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone detected. Value as released (in 10-millisecond units) = 3.

$105: Defines the ringback tone as follows: <frequency 1> <deviation> <frequency 2> <deviation>. frequency: Defines the frequency detection, which determines the pitch of the signal. Value as released = 425. deviation: Value as released = 35. %01: cadence (in 10-millisecond units). Value as released = 150, 300.

The maximum allowable time between successive rings is defined in parameter $3 in 10-millisecond units.

372

83. Sweden P7 Bidirectional for PDKRT


The protocol modules (see Table 86) and the modifiable inbound and outbound country dependent parameters (CDP) for the Sweden P7 Protocol are described in this chapter. Table 86. Sweden P7 Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Voice and Network Parameter Country Dependent Parameter Linux pdk_se_p7_io. psi se_300.prm Windows pdk_se_p7_io. psi se_300.prm Description The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

pdk_se_p7_io. cdp

pdk_se_p7_io. cdp

NOTE: This protocol is supported on SpringWare boards only.

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

83.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a

373

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

83.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_se_p7_io CDP File Name: pdk_se_p7_io.cdp The modifiable parameters are: CDP_Dial_Using_DTMF (Outbound): Determines whether DTMF digits are sent. Possible values are: 0 - Decadic pulses are used for sending digits (value as released). 1 - DTMF digits are sent. CDP_DialToneEnabled (Outbound): Determines whether to wait for a dial tome before sending digits to the remote end. Possible values are: 0 - Do not wait for dial tone before sending digits to the remote end. 1 - Wait for dial tone before sending digits to the remote end (value as released). CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bidirectional (value as released).
374

83. Sweden P7 Bidirectional for PDKRT

1 - If the protocol is used as inbound only.

375

84. Sweden P7 PBX Bidirectional for PDKRT


The protocol modules (see Table 87) and the modifiable inbound and outbound country dependent parameters (CDP) for the Sweden P7 PBX Protocol are described in this chapter. Table 87. Sweden P7 PBX Bidirectional Protocol for PDKRT Modules File Type Protocol Modules Voice and Network Parameter Country Dependent Parameter Linux pdk_se_p7_pb x_io.psi se_300.prm Windows pdk_se_p7_pb x_io.psi se_300.prm Description The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

pdk_se_p7_pb x_io.cdp

pdk_se_p7_pb x_io.cdp

NOTE: This protocol is supported on SpringWare boards only.

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

84.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a

377

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

84.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_se_p7_pbx_io CDP File Name: pdk_se_p7_pbx_io.cdp The modifiable parameters are: CDP_Dial_Using_DTMF (Inbound): Determines whether DTMF digits will be received. Possible values are: 0 - Decadic pulses are used for receiving digits (value as released). 1 - DTMF digits will be received. CDP_DialToneEnabled (Inbound): Determines whether to wait for a dial tone before sending digits to the remote end. Possible values are: 0 - Do not wait for dial tone before sending digits to the remote end. 1 - Wait for dial tone before sending digits to the remote end (value as released). CDP_IMMEDIATE_ACCEPTSTATE (Inbound): Specifies when the protocol transitions a call to the Accepted state. Possible values are: 0 - Specifies that the protocol should wait for the specified number of rings to expire before transitioning to the Accepted state (value as released). 1 - Specifies that the protocol should transition a call to the Accepted state immediately upon receipt of the CMD_AcceptCall command and before the specified number of rings have been generated. CDP_MaxDigits (Inbound): The maximum number of digits that can be received when using this protocol. If, however, DTMF is used, and the parameter CDP_Str_TermToneString is non-NULL, then this parameter means the number of maximum digits to be received. If some terminating

378

84. Sweden P7 PBX Bidirectional for PDKRT

digit is received before receiving this number of digits, the digit collection is terminated. Value as released = 4. CDP_SEND_BLOCK_AT_START_OR_REMOTE_BLOCK: Specifies the bit pattern to be sent on the line at the protocol open time and when the remote line goes BLOCKED. Possible values are: 0 - If the protocol is used either as outbound only or as bi-directional (value as released). 1 - If the protocol is used as inbound only. CDP_Str_TermToneString (Inbound): Specifies the string of digits that can terminate the receiving of digits. For example, if this parameter is set to #*, if * or # is received from the remote end while receiving DTMF digits, the protocol will stop receiving more digits. Value as released = #*. parameter can be set to a NULL string (""). In this case, the CDP_MaxDigits number of digits is received from the remote.

NOTE: This parameter is used only if DTMF is used for receiving digits. This

379

85. Sweden CO Emulation for ICAPI


The protocol modules (see Table 88) and the modifiable inbound and outbound country dependent parameters (CDP) for the Sweden CO Emulation Protocol for ICAPI are described in this chapter. Table 88. Sweden CO Emulation R2 Protocol Modules File Type Protocol Modules Linux cas_in.so cas_out.so cas_in.dll cas_out.dll Voice and Network Parameter Country Dependent Parameter se_300_i.prm se_300_i.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

se_co_i.cdp se_co_o.cdp

se_co_i.cdp se_co_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

85.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
381

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

85.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: se_co_i CDP File Name: se_co_i.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101, 103, and 105 are used by this protocol.

382

85. Sweden CO Emulation for ICAPI

85.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: se_co_o CDP File Name: se_co_o.cdp The modifiable parameters are: $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101, 103, and 105 are used by this protocol.

383

86. Sweden E-1 for ICAPI


The protocol modules (see Table 89) and the modifiable inbound and outbound country dependent parameters (CDP) for the Sweden E-1 Protocol for ICAPI are described in this chapter. Table 89. Sweden E-1 Protocol Modules File Type Protocol Modules Linux cas_in.so cas_out.so cas_in.dll cas_out.dll Voice and Network Parameter Country Dependent Parameter se_300_i.prm se_300_i.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

se_e1_i.cdp se_e1_o.cdp

se_e1_i.cdp se_e1_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

86.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
385

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

86.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: se_e1_i CDP File Name: se_e1_i.cdp The modifiable parameters are: $7 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$9 NRING: The number of rings before speech. After the specified number of rings, a GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101, 103, and 105 are used by this protocol.

386

86. Sweden E-1 for ICAPI

86.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: se_e1_o. CDP File Name: se_e1_o.cdp The modifiable parameters are: $20 NODIALLING: Do not dial digits. After seizure acknowledge has been received (if required), wait for the application to answer. Value as released = 0. $20.1 SPEECH_DETECT: Detect connection with T_SIL events. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $20.2 GENERATE_SIL_EVENTS: Send T_SIL events to the application. Possible values are 1 (enabled) and 0 (disabled). Value as released = 0. $22 MAXRING: Specifies the number of rings before no answer. Value as released = 10. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$35 WAITIDLE: Time in seconds to wait for Idle. An error event is sent to the application if the network remains idle for more longer than the value specified by this parameter. Value as released = 10.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

387

87. Taiwan T-1 E&M Bidirectional for PDKRT


The protocol modules (see Table 90) and the modifiable inbound and outbound country dependent parameters (CDP) for the Taiwan Lucent Definity G3V8 switch with T-1 signaling are described in this chapter. Table 90. Taiwan T-1 E&M Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Voice and Network Parameter Country Dependent Parameter Linux pdk_tw_em_io Windows pdk_tw_em_io Description The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

tw_240.prm

tw_240.prm

pdk_tw_em_io .cdp

pdk_tw_em_io .cdp

NOTE: This protocol is supported on SpringWare boards only.

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

87.1. Protocol Limitations


ANI is not supported by this version.

87.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_tw_em_io

389

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: pdk_tw_em_io.cdp The modifiable parameter is: CDP_CallAnalysis_Enabled: Specifies whether to enable call analysis. Possible values are: 0 - Do not enable call analysis. 1 - Enable call analysis (value as released).

390

88. Taiwan Modified R1 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 91) for the Taiwan Modified R1 Bidirectional Protocol for PDKRT are described in this chapter. Table 91. Taiwan Modified R1 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_tw_mr1_i o.hot pdk_tw_mr1_i o.qs SpringWare: pdk_tw_mr1_i o.psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_tw_mr1_i o.cdp Windows DM3: pdk_tw_mr1_i o.hot pdk_tw_mr1_i o.qs SpringWare: pdk_tw_mr1_i o.psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_tw_mr1_i o.cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

391

Global Call Country Dependent Parameters (CDP) Reference

88.1. Protocol Limitations


None.

88.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_tw_mr1_io CDP File Name: pdk_tw_mr1_io.cdp The modifiable parameters are: CDP_CallScenario: Specifies the following call scenarios: 0 - DNIS+ST ANSWER 1 - DNIS+ST ANIWink KP+ANI+ST ANSWER (value as released) CDP_SeizeAck_Timeout: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

392

89. Taiwan T-1 for ICAPI


The protocol modules (see Table 92) and the modifiable inbound and outbound country dependent parameters (CDP) for Taiwan T-1 Robbed Bit Protocol for ICAPI are described in this chapter. Table 92. Taiwan T-1 Protocol Modules File Type Protocol Modules Linux tw_mf_i.so tw_mf_o.so tw_mf_i.dll tw_mf_o.dll Voice and Network Parameter Country Dependent Parameter tw_240.prm tw_240.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

tw_mf_i.cdp tw_mf_o.cdp

tw_mf_i.cdp tw_mf_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

89.1. Protocol Limitations


ANI is not supported by this version.

89.2. Inbound Parameters


gc_Open( ) Protocol Name: tw_mf_i

393

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: tw_mf_i.cdp The modifiable parameters are: $4: Wink length time in 10-msec units. Generates a wink after seizure acknowledgment. Set to 0 to disable. Value as released = 20. $6: Inter-digit time-out. The amount of time after seizure acknowledge that the inbound protocol will wait for an initial ANI or DDI digit. It is also used as a time-out value between digits. If this parameter is set to 0, then no timeout is set and an immediate transition to the Connected state is made without waiting to receive any digits. Set this parameter to 0 if your circuit has been provisioned for Feature Group A. Value as released = 10. $7: Number of DDI digits, depends on the trunk. Check with local circuit provider. Set to the number of DDI digits plus 1. Value as released = 16. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $17: Time in 10-msec units to confirm signal transition. Value as released = 25. $22: Specifies a decimal value for which tone the CO will send to indicate that all DDI or all ANI have been sent. For example, if this parameter is set to 8192 (0x2000), the CO will send a DTMF digit A, which indicates that all digits have been sent. By default, the tone # (also called ST) indicates that all digits have been sent. Value as released = 0. Possible values for this parameter are (cf dxxxlib.h):

394

89. Taiwan T-1 for ICAPI

Table 93. Parameter Values for $22 DTMF Digit D S P A B C Description Mask for DTMF D Mask for DTMF * Mask for DTMF # Mask for DTMF A Mask for DTMF B Mask for DTMF C Hexadecimal Values 0x0001 0x0800 0x1000 0x2000 0x4000 0x8000

$45: Minimum wink duration in 10-msec units for wink detection. Value as released = 10. $46: Maximum wink duration in 10-msec units for wink detection. Value as released = 35. $47.0: T1MF_FEATURE. Set to 0 to select wink start. Set it to 1 to use Special protocols where the DDI and ANI digits are surrounded by ST (*) and KP (#). Typically, KP (#) terminates the digit string. The protocol uses the time-out and the maximum DDI (ANI) number to detect errors. The values selected should be large enough to avoid false error detection. The maximum DDI (ANI) value should be set to a number greater than the largest expected DDI (ANI) digit string. $47.1: T1MF_MF. Set to 0 for DTMF digit. Set it to 1 for MF digit. $47.2: T1MF_GROUPD. Set to 0 to select Group B tone signaling wherein ANI is sent from the calling partys CO after seizure. Set to 1 to select Group D tone signaling wherein the ANI and DDI string are sent from the calling partys CO before the call is answered. $47.3: T1MF_DNISWINK. Set to 0 to select No DNIS wink start for group D. Set to 1 to select DNIS wink start for group D. $47.4: T1MF_ANISWINK. Set to 0 to select No ANI wink start for group D. Set to 1 to select ANI wink start for group D.

395

Global Call Country Dependent Parameters (CDP) Reference

$47.5: T1MF_DIALTONE. Set to 0 to select No dial tone after seizure. Set to 1 to select Dial tone after seizure. $47.6: T1MF_NOSEIZEWINK. Set to 0 to use seizure acknowledge wink. Set to 1 to Disable seizure acknowledge wink. $47.7: T1MF_KPACK. Set to 0 to automatically send Ready to Receive signal for an amount of time (typically 150 msec) after the seizure acknowledge, set it to 1 to have Ready to receive signal sent after having received the KP.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

89.3. Outbound Parameters


gc_Open( ) Protocol Name: tw_mf_o CDP File Name: tw_mf_o.cdp
NOTE: This protocol does not require call analysis. However, call progress

tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call progress. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call progress capability. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge and to set a timeout for detection of a dial tone if bit 5 of the $47 outbound parameter is set to 1. If your computer is heavily loaded, this time may be increased. If this timeout is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 500. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5.

396

89. Taiwan T-1 for ICAPI

$2: Minimum time in 10-msec units before seizing line. Amount of time the protocol waits after receiving a gc_MakeCall( ) function call before protocol seizes the line. This time delay ensures a minimal assertion of the idle pattern on the line. Set to 0 for an outbound-only protocol or to a non -zero value for an inbound/outbound protocol. Value as released = 100. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $13: Default maximum time in seconds for a call to be answered. If the value is 0, the protocol does not wait for the call to be answered but immediately returns a connection to the application. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $17: Time in 10-msec units to confirm signal transition. Value as released = 25. $41: By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero.

397

Global Call Country Dependent Parameters (CDP) Reference

$45: Minimum wink duration in 10-msec units for wink detection. Value as released = 10. $46: Maximum wink duration in 10-msec units for wink detection. Value as released = 35. $47.0: T1MF_FEATURE. Set to 0 to select wink start. Set it to 1 to use Special protocols where the DDI and ANI digits are surrounded by ST (*) and KP (#). Typically, KP (#) terminates the digit string. The protocol will automatically add KP and ST in the DDI and the ANI string. $47.1: T1MF_MF. Set to 0 for DTMF digit. Set it to 1 for MF digit. $47.2: T1MF_GROUPD. Set to 0 to select Group B tone signaling wherein ANI is sent from the calling partys CO after seizure. Set to 1 to select Group D tone signaling wherein the ANI and DDI string are sent from the calling partys CO before the call is answered. $47.3: T1MF_DNISWINK Set to 0 to select No DNIS wink start for group D. Set to 1 to select DNIS wink start for group D. $47.4: T1MF_ANISWINK. Set to 0 to select No ANI wink start for group D. Set to 1 to select ANI wink start for group D. $47.5: T1MF_DIALTONE. Set to 0 to select No dial tone after seizure. Set to 1 to select Dial tone after seizure. $47.6: T1MF_NOSEIZEWINK. Set to 0 to use seizure acknowledge wink. Set to 1 to Disable seizure acknowledge wink. $47.7: T1MF_KPACK. Set to 0 to have the Protocol waiting for the Ready to receive signal before sending KP and digits; set to 1 to have the protocol sending the KP right after the seizure acknowledge, then waiting for the KP acknowledge, and then continuing with the dialing. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

398

90. Thailand R2 TOT for ICAPI


The protocol modules (see Table 94) and the modifiable inbound and outbound country dependent parameters (CDP) for the Thailand R2 TOT Protocol for ICAPI are described in this chapter. Table 94. Thailand R2 TOT Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

th_r2_i.cdp th_r2_o.cdp

th_r2_i.cdp th_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

90.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
399

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

90.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: th_r2_i CDP File Name: th_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 15. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

400

90. Thailand R2 TOT for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

90.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: th_r2_o CDP File Name: th_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

401

91. Thailand R2 CFT for ICAPI


The protocol modules (see Table 95) and the modifiable inbound and outbound country dependent parameters (CDP) for the Thailand R2 CFT Protocol for ICAPI are described in this chapter. Table 95. Thailand R2 CFT Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

th_r2_ic.cdp th_r2_oc.cdp

th_r2_ic.cdp th_r2_oc.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

91.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
403

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

91.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: th_r2_ic CDP File Name: th_r2_ic.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 15. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

404

91. Thailand R2 CFT for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103, 105, and 141 are used by this protocol.

91.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: th_r2_oc CDP File Name: th_r2_oc.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

405

92. Thailand R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 96) for the Thailand R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 96. Thailand R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_th_r2_io. hot pdk_th_r2_io. qs SpringWare: pdk_th_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: r2_300.prm DM3 and SpringWare: pdk_th_r2_io. cdp Windows DM3: pdk_th_r2_io. hot pdk_th_r2_io. qs SpringWare: pdk_th_r2_io. psi SpringWare only: r2_300.prm DM3 and SpringWare: pdk_th_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

407

Global Call Country Dependent Parameters (CDP) Reference

92.1. Protocol Limitations


None.

92.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_th_r2_io CDP File Name: pdk_th_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 8. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

408

92. Thailand R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

409

93. Tunisia R2 for ICAPI


The protocol modules (see Table 97) and the modifiable inbound and outbound country dependent parameters (CDP) for the Tunisia R2 Protocol for ICAPI are described in this chapter. Table 97. Tunisia R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

tn_r2_i.cdp tn_r2_o.cdp

tn_r2_i.cdp tn_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

93.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
411

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

93.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: tn_r2_i CDP File Name: tn_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

412

93. Tunisia R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

93.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: tn_r2_o CDP File Name: tn_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

413

94. Turkey E-1 (1-bit) Bidirectional for ICAPI


The protocol modules (see Table 98) and the modifiable inbound and outbound country dependent parameters (CDP) for the Turkey E-1 (1-bit) bidirectional protocol for PDKRT are described in this chapter. Table 98. Turkey E-1 (1-bit) Bidirectional for ICAPI Protocol Modules File Type Protocol Modules Linux us_mf_io.so Windows Description The shared protocol module to be dynamically loaded as required. us_mf_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

tr_1bit_300.pr m tr_1bit_io.cdp

tr_1bit_300.pr m tr_1bit_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

94.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: ANI is not supported.

415

Global Call Country Dependent Parameters (CDP) Reference

From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

94.2. E-1 E&M Inbound and Outbound Parameters


gc_Open( ) Protocol Name: tr_1bit_io CDP File Name: tr_1bit_io.cdp The modifiable parameters are: $1 (Outbound): Number of ring before no answer. Value as released = 5. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $101: Defines the tone for dial tone detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 350 frequency 2 = 440 deviation = 35 %01: Defines the cadence, which identifies repeating patterns of sound and silence (in 10-millisecond units). Value as released = 60.

$103: Defines the tone for busy signal detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480

416

94. Turkey E-1 (1-bit) Bidirectional for ICAPI

frequency 2 = 620 deviation = 35 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 50, 10, 50, 10. %02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone as detected. Value as released (in 10-millisecond units) = 2.

$104: Defines the tone for fast busy signal detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = 35 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units) = 25, 5, 25, 5 %02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone detected. Value as released (in 10-millisecond units) = 3.

$105: Defines the tone for ringback detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 440 frequency 2 = 480 deviation = 35 %01: Defines the cadence, which identifies repeating patterns of sound and silence (in 10-millisecond units). Value as released = 80.

417

Global Call Country Dependent Parameters (CDP) Reference

@101: Defines the tone for dial tone generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 350 frequency 2 = 440 deviation = -12 %01: Defines the cadence, which identifies repeating patterns of sound and silence (in 10-millisecond units). Value as released = 700.

@103: Defines the tone for busy signal generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = -12 %01: Defines the cadence, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 50, 50.

@104: Defines the tone for fast busy signal generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 25, 25.

@105: Defines the tone for ringback generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Values as released: frequency 1 = 440 frequency 2 = 480

418

94. Turkey E-1 (1-bit) Bidirectional for ICAPI

deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 100, 300.

419

95. Turkey E-1 (2-bits) Bidirectional for ICAPI


The protocol modules (see Table 99) and the modifiable inbound and outbound country dependent parameters (CDP) for the Turkey E-1 (2-bits) bidirectional protocol for ICAPI are described in this chapter. Table 99. Turkey E-1 (2-bit) Bidirectional for ICAPI Protocol Modules File Type Protocol Modules Linux us_mf_io.so Windows Description The shared protocol module to be dynamically loaded as required. us_mf_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

tr_2bits_300.p rm tr_2bits_io.cd p

tr_2bits_300.p rm tr_2bits_io.cd p

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

95.1. Protocol Limitations


The following limitations of this protocol restrict the functionality of the Global Call API: ANI is not supported.

421

Global Call Country Dependent Parameters (CDP) Reference

From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

95.2. E-1 E&M Inbound and Outbound Parameters


gc_Open( ) Protocol Name: tr_2bits_io CDP File Name: tr_2bits_io.cdp The modifiable parameters are: $1 (Outbound): Number of rings before no answer. Value as released = 5. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $49: The calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function. Value as released = 9933000. $101: Defines the tone for dial tone detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 350 frequency 2 = 440 deviation = 35 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Value as released = 60.

422

95. Turkey E-1 (2-bits) Bidirectional for ICAPI

$103: Defines the tone for busy signal detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = 35 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 50, 10, 50, 10. %02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone detected. Value as released (in 10-millisecond units) = 2.

$104: Defines the tone for fast busy signal detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = 35 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 25, 5, 25, 5. %02: cycle, which specifies the number of times that the cadence on/off pattern must be detected before classifying the tone detected. Value as released (in 10-millisecond units) = 3.

$105: Defines the tone for ringback detection as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 440 frequency 2 = 480 deviation = 35

423

Global Call Country Dependent Parameters (CDP) Reference

%01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 80.

@101: Defines the tone for dial tone generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 350 frequency 2 = 440 deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 700.

@103: Defines the tone for busy signal generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 50, 50.

@104: Defines the tone for fast busy signal generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 480 frequency 2 = 620 deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 25, 25.

424

95. Turkey E-1 (2-bits) Bidirectional for ICAPI

@105: Defines the tone for ringback generation as follows: <frequency 1> <deviation> <frequency 2> <deviation>. Frequency determines the pitch of the signal. Values as released: frequency 1 = 440 frequency 2 = 480 deviation = -12 %01: Defines the cadence detection, which identifies repeating patterns of sound and silence (in 10-millisecond units). Values as released = 100, 300.

425

96. United Kingdom E-1 CallStream for ICAPI


The protocol modules (see Table 100) and the modifiable inbound and outbound country dependent parameters (CDP) for the United Kingdom E-1 CallStream Protocol for ICAPI are described in this chapter. Table 100. United Kingdom E-1 CallStream Protocol Modules File Type Protocol Modules Linux uk_cs_i.so uk_cs_o.so uk_cs_i.dll uk_cs_o.dll Voice and Network Parameter Country Dependent Parameter uk_300.prm uk_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

uk_cs_i.cdp uk_cs_o.cdp

uk_cs_i.cdp uk_cs_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

96.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

427

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

96.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: uk_cs_i CDP File Name: uk_cs_i.cdp The modifiable parameters are: $6: Time-out for incoming calls in seconds. Value as released = 6. $7: Number of DDI digits, depends on trunk. Check with PTT. Value as released = 4. $8: Hardware used. Possible values: 0 (DTI/212) and 1 (D/300SC-E-1). This parameter must be set to 1. Value as released = 1. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10. $12: Time-out in 55-msec units to wait after Idle. Value as released = 2. $14: DDI method. Possible values: 0 (pulse) and 1 (DTMF). Value as released = 0.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

96.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: uk_cs_o

428

96. United Kingdom E-1 CallStream for ICAPI

CDP File Name: uk_cs_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 100. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $8: Hardware used. Possible values: 0 (DTI/212) and 1 (D/300SC-E-1). Value as released = 0. This parameter must be set to 1. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $14: DDI method. Possible values: 0 (pulse) and 1 (DTMF). Value as released = 0.

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

429

97. United Kingdom E-1 Mercury for ICAPI


The protocol modules (see Table 101) and the modifiable inbound and outbound country dependent parameters (CDP) for the United Kingdom E-1 Mercury Protocol for ICAPI are described in this chapter. Table 101. United Kingdom E-1 Mercury Protocol Modules File Type Protocol Modules Linux uk_mc_i.so uk_mc_o.so uk_mc_i.dll uk_mc_o.dll Voice and Network Parameter Country Dependent Parameter uk_300.prm uk_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

uk_mc_i.cdp uk_mc_o.cdp

uk_mc_i.cdp uk_mc_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

97.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

431

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

97.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: uk_mc_i CDP File Name: uk_mc_i.cdp The modifiable parameters are: $6: Time-out for incoming calls in seconds. Value as released = 3. $7: Number of DDI digits, depends on trunk. Check with PTT. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10.

Global Tone Detection Usage: Tone IDs 103 and 105 are used by this protocol.

97.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: uk_mc_o CDP File Name: uk_mc_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the

432

97. United Kingdom E-1 Mercury for ICAPI

application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 60. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $2: Minimum blocking time in 10-msec units. Value as released = 60. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $47: Time in seconds to wait for proceed to send signal. Value as released = 10.

433

Global Call Country Dependent Parameters (CDP) Reference

Global Tone Detection Usage: Tone IDs 103-105 are used by this protocol.

434

98. United Kingdom E-1 Mercury Bidirectional for ICAPI


The protocol modules (see Table 102) and the modifiable inbound and outbound country dependent parameters (CDP) for the United Kingdom E-1 Mercury Bidirectional Protocol for ICAPI are described in this chapter. Table 102. United Kingdom E-1 Mercury Bidirectional Protocol Modules File Type Protocol Modules Linux uk_mc_io.so Windows Description The shared protocol module to be dynamically loaded as required. uk_mc_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

uk_300.prm

uk_300.prm

uk_mc_io.cdp

uk_mc_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

435

Global Call Country Dependent Parameters (CDP) Reference

98.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

98.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: uk_mc_io CDP File Name: uk_mc_io.cdp The modifiable parameters are: $0 (Outbound): Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 60. $1 (Outbound): Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $2 (Outbound): Minimum blocking time in 10-msec units. Value as released = 60. $3 (Outbound): Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $6 (Inbound): Time-out for incoming calls in seconds. Value as released = 3.

436

98. United Kingdom E-1 Mercury Bidirectional for ICAPI

$7 (Inbound): Number of DDI digits, depends on trunk. Check with PTT. Value as released = 10. $9 (Inbound): Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10 (I/O): Time in seconds to wait for Idle. Value as released = 10. $13 (Outbound): Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41 (Outbound): By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42 (Outbound): Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $47 (Outbound): Time in seconds to wait for proceed to send signal. Value as released = 10.

Global Tone Detection Usage: Tone IDs 103-105 are used by protocol.

437

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)
The protocol modules and modifiable inbound and outbound country dependent parameters (CDP) file (see Table 103) for the United States T-1 Bidirectional Protocol for PDKRT are described in this chapter. At the end of this chapter, parameter settings for Feature Groups A, B, and D (FGA, FGB, FGD) are shown. Table 103. United States T-1 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_us_mf_io. hot pdk_us_mf_io. qs SpringWare: pdk_us_mf_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: us_240.prm DM3 and SpringWare: pdk_us_mf_io. cdp Windows DM3: pdk_us_mf_io. hot pdk_us_mf_io. qs SpringWare: pdk_us_mf_io. psi SpringWare only: us_240.prm DM3 and SpringWare: pdk_us_mf_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol modules to be dynamically loaded as required.

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

99.1. Protocol Limitations


None.
439

Global Call Country Dependent Parameters (CDP) Reference

99.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_us_mf_io CDP File Name: pdk_us_mf_io.cdp The modifiable parameters are: CDP_BLIND_XFER_DIALTONE_TIMEOUT: Defines the maximum time-out in milliseconds to wait for dialtone during a blind transfer. Set to 0 to disable waiting for dialtone during a blind transfer. Value as released = 5000 (5 seconds). CDP_BLIND_XFER_POST_TIME: Specifies the time in milliseconds between blind transfer dialing and hangup. Value as released = 1000 (1 second). CDP_BLIND_XFER_PRE_TIME: Specifies the time in milliseconds between blind transfer hookflash and dialing. Value as released = 0. CDP_FORCED_RELEASE_ENABLED: Enables the protocol to support forced release of incoming calls from the accepted state. The T-1 protocol specification does not support forced release of incoming calls from the accepted state. However, support for forcing release of incoming calls is supported in this implementation for flexibility with Global Call applications, which are permitted to call gc_DropCall( ) from the accepted state. In this scenario, the call will be answered transparently without notification of the application and then immediately disconnected, i.e., a forced release of the line. Note that in doing this, additional implications exist and must be considered, i.e., billing, etc. Possible values are: 0 - Does not support forced release. No implicit answer will be performed transparently in this scenario, and only a CAS hangup (idle) signal will be generated. 1 - Supports forced release (value as released). CDP_HOOKFLASH_ON_XFER: Determines if a hookflash is sent by the protocol when a supervised and blind transfer is requested. Possible values are: 0 - Do not send hookflash.

440

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)

1 - Send the hookflash (value as released). CDP_HOOKFLASH_ON_XFER_DROP: Determines if a hookflash is sent by the protocol if a supervised transfer request is aborted via a gc_DropCall( ) function. Possible values are: 0 - Do not send hookflash. 1 - Send the hookflash (value as released). CDP_IN_ACCEPTBEFORERING: Determines if an accept event should be sent before sending ringback tones. Possible values are: 0 - Do not send the accept event before sending ringback tones. 1 - Send the accept event before sending ringback tones (value as released). CDP_IN_ANI_DigitType: Determines the digit type for inbound ANI digits. Possible values are: 1 - DTMF digits (value as released). 2 - MF digits. CDP_IN_ANI_Enabled: Enables ANI collection. Possible values are: 0 - ANI collection not enabled.
NOTE: For DM3, if ANI is disabled, you also have to remove feature_ANI

from the SYS_FEATURES parameter in the .cdp file. 1 - ANI collection enabled (value as released). The ANI digits are terminated either by CDP_IN_ANISTDigit if CDP_IN_ANI_ST_Needed is set to 1, or by the maximum number of digits set by CDP_IN_ANI_MaxDigits. CDP_IN_ANIKPDigit: Specifies the ANI prefix digit. Value as released = *. Has no effect if CDP_IN_ANI_KP_Needed is set to 0. CDP_IN_ANI_KP_Needed: Specifies whether the ANI prefix digit is used. Possible values are: 0 - ANI prefix digit is not needed. 1 - ANI prefix digit is needed (value as released).

441

Global Call Country Dependent Parameters (CDP) Reference

CDP_IN_ANI_MaxDigits: The maximum number of ANI digits expected. ANI collection terminates if this value is reached. Value as released = 12. CDP_IN_ANISTDigit: Specifies the ANI ST digit. Value as released = *. Has no effect if CDP_IN_ANI_ST_Needed is set to 0. CDP_IN_ANI_ST_Needed: Specifies whether ANI digits are terminated by CDP_IN_ANISTDigit. Possible values are: 0 - No termination digit added; ANI digits are terminated by the maximum number of digits set by CDP_IN_ANI_MaxDigits. 1 - Termination digit added; ANI digits are terminated by the value set by CDP_IN_ANISTDigit (value as released).

CDP_IN_ANI_Type_Pre: Specifies that ANI digits are expected before generating the answer signal. Possible values are: 0 - Do not expect ANI digits before the answer signal. 1 - Expect ANI digits before the answer signal (value as released).

CDP_IN_ANI_WINK_Needed: Specifies if a CAS_WINK signaling pattern should be generated immediately after the reception of the ANI digits. Possible values are: 0 - Do not generate the CAS_WINK signaling pattern after ANI (value as released). 1 - Generate the CAS_WINK signaling pattern after ANI.

CDP_IN_DialTone_Needed: Specifies whether a dial tone should be generated after receiving a CAS_SEIZE to notify the CO that it can begin dialing. Possible values are: 0 - Do not generate a dial tone (value as released). 1 - Generate a dial tone.

CDP_IN_DNIS_BeforeANI: Specifies whether DNIS digits are received before ANI digits. Possible values are: 0 - Receive the ANI digits before the DNIS digits (value as released). 1 - Receive the DNIS digits before the ANI digits.

442

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)

NOTE: This parameter is applicable only if the CDP_IN_DNIS_Enabled

parameter is set to 1. CDP_IN_DNIS_DigitType: Determines the digit type for inbound DNIS digits. Possible values are: 1 - DTMF digits (value as released). 2 - MF digits. CDP_IN_DNIS_Enabled: Enables DNIS collection. Possible values are: 0 - DNIS collection not enabled.
NOTE: For DM3, if DNIS is disabled, you also have to remove

feature_DNIS from the SYS_FEATURES parameter in the .cdp file. 1 - DNIS collection enabled (value as released). The DNIS digits are terminated either by CDP_IN_DNISSTDigit if CDP_IN_DNIS_ST_Needed is set to 1, or by the maximum number of digits set by CDP_IN_DNIS_MaxDigits. CDP_IN_DNISKPDigit: Specifies the DNIS prefix digit. Value as released = *. Has no effect if CDP_IN_DNIS_KP_Needed is set to 0. CDP_IN_DNIS_KP_Needed: Specifies whether the DNIS prefix digit is used. Possible values are: 0 - DNIS prefix digit is not needed (value as released). 1 - DNIS prefix digit is needed. CDP_IN_DNIS_MaxDigits: Defines the maximum number of DNIS digits. Value as released = 12. CDP_IN_DNISSTDigit: Specifies the DNIS ST digit. Value as released = *. Has no effect if CDP_IN_DNIS_ST_Needed is set to 0. CDP_IN_DNIS_ST_Needed: Specifies whether DNIS digits are terminated by CDP_IN_DNISSTDigit. Possible values are: 0 - No termination digit added; DNIS digits are terminated by the maximum number of digits set by CDP_IN_DNIS_MaxDigits. 1 - Termination digit added; DNIS digits are terminated by the value set by CDP_IN_DNISSTDigit (value as released).

443

Global Call Country Dependent Parameters (CDP) Reference

CDP_IN_DNIS_WINK_Needed: Specifies if a CAS_WINK signaling pattern should be generated immediately after the reception of the DNIS digits. Possible values are: 0 - Do not generate the CAS_WINK signaling pattern after DNIS (value as released). 1 - Generate the CAS_WINK signaling pattern after DNIS.

CDP_IN_EnableRingBack: Specifies whether a ringback should be generated before answering a call. The number of rings generated is determined by the value passed by the gc_AcceptCall( ) or gc_AnswerCall( ) functions. Possible values are: 0 - Do not generate a ringback (value as released). 1 - Generate a ringback.

CDP_IN_GetDigitTime: Specifies the time-out value in milliseconds for inbound waiting for DNIS or ANI digits. Value as released = 10000 (10 seconds). CDP_IN_WinkStart: Specifies whether to generate a seizure acknowledgment CAS_WINK after receiving a CAS_SEIZE. Possible values are: 0 - Immediate start. 1 - Wink start (value as released).

CDP_MIN_CallLength: Specifies the minimum length of time that an inbound or outbound call can be connected. Value as released = 300 milliseconds. CDP_Min_HangupTime: Controls the amount of time after hangup during which the protocol will ignore any signaling transitions. It is primarily used to prevent a race condition where, after an outbound channel hangs up after the call has been delivered but before a call is connected, the remote inbound channel might answer anyway, and the ensuing transition can be interpreted as a CAS_SEIZE. It is only needed if CAS_ANSWER and CAS_SEIZE transitions are the same, and usually only useful when running the protocol back to back, as most live switches would not attempt to answer a call that has been disconnected. Value as released = 0.

444

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)

CDP_OUT_ANI_DigitType: Determines the digit type for outbound ANI digits. Possible values are: 1 - DTMF digits (value as released). 2 - MF digits.

CDP_OUT_ANI_Enabled: Enables ANI generation. Possible values are: 0 - ANI collection not enabled. 1 - ANI collection enabled (value as released).

CDP_OUT_ANIKPDigit: Specifies the ANI prefix digit. Value as released = *. Has no effect if CDP_OUT_ANI_KP_Needed is set to 0. CDP_OUT_ANI_KP_Needed: Specifies whether the ANI prefix digit is used. Possible values are: 0 - ANI prefix digit is not needed. 1 - ANI prefix digit is needed (value as released).

CDP_OUT_ANISTDigit: Specifies the ANI ST digit. Value as released = *. Has no effect if CDP_OUT_ANI_ST_Needed is set to 0. CDP_OUT_ANI_ST_Needed: Specifies whether ANI digits are terminated by CDP_OUT_ANISTDigit. Possible values are: 0 - No termination digit added. 1 - Termination digit added (value as released).

CDP_OUT_ANIString: Use this string as the ANI digits if the CDP_OUT_ANI_Enabled parameter is set to 1. Value as released = 5678. CDP_OUT_ANI_Type_Pre: Specifies that ANI digits will be generated before the reception of an answer signal. Possible values are: 0 - Do not generate ANI digits before the answer signal. 1 - Generate ANI digits before the answer signal (value as released).

445

Global Call Country Dependent Parameters (CDP) Reference

CDP_OUT_ANI_WINK_Needed: Specifies if a CAS_WINK signaling pattern should be received immediately after the generation of the ANI digits. Possible values are: 0 - A CAS_WINK signaling pattern does not have to be received (value as released). 1 - A CAS_WINK signaling pattern must be received.

CDP_OUT_ConnectType: Specifies one of four possible modes for outbound connection detection. Possible values are: 0 - Only connect if a CAS_Answer signaling bit pattern is received (value as released). 1 - Connect on the first event, either signaling or media detection. If the signaling bit arrives first, pass the connection event to the application, but continue media type detection and when detected pass it to the application. 2 - Connect on the first event, either signaling or media detection. If the signaling bit arrives first, stop call analysis and return the call analysis result to the application followed by the connected event. 3 - Wait for call analysis to terminate if the signaling bit arrives first, then send the call analysis result followed by the connect event.

CDP_OUT_DialTone_Needed: Specifies that a dial tone must be received after generating a CAS_SEIZE. Possible values are: 0 - Do not receive a dial tone (value as released). 1 - Receive a dial tone.

CDP_OUT_DialTone_Timeout: Defines the time-out in milliseconds while waiting for a dial tone after a line seizure. Value as released = 5000 (5 seconds).
NOTE: This value is not used if the CDP_OUT_WinkStart parameter is set

to 0. CDP_OUT_DNIS_BeforeANI: Specifies whether DNIS digits are sent before ANI digits. Possible values are: 0 - Send the ANI digits before the DNIS digits (value as released).

446

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)

1 - Send the DNIS digits before the ANI digits.


NOTE: This parameter is only applicable if the CDP_IN_ANI_Enabled

parameter is set to 1. CDP_OUT_DNIS_DigitType: Determines the digit type for outbound DNIS digits. Possible values are: 1 - DTMF digits (value as released). 2 - MF digits. CDP_OUT_DNIS_Enabled: Enables DNIS. Possible values are: 0 - DNIS not enabled. 1 - DNIS enabled (value as released). CDP_OUT_DNISKPDigit: Specifies the DNIS prefix digit. Value as released = *. Has no effect if CDP_OUT_DNIS_KP_Needed is set to 0. CDP_OUT_DNIS_KP_Needed: Specifies whether the DNIS prefix digit is used. Possible values are: 0 - DNIS prefix digit is not needed (value as released). 1 - DNIS prefix digit is needed. CDP_OUT_DNISSTDigit: Specifies the DNIS ST digit. Value as released = *. Has no effect if CDP_OUT_DNIS_ST_Needed is set to 0. CDP_OUT_DNIS_ST_Needed: Specifies whether DNIS digits are terminated by CDP_OUT_DNISSTDigit. Possible values are: 0 - No termination digit added. 1 - Termination digit added (value as released). CDP_OUT_DNIS_WINK_Needed: Specifies that a CAS_WINK signaling pattern should be received immediately after sending the DNIS digits. Possible values are: 0 - The reception of a CAS_WINK signaling pattern is not required (value as released). 1 - The reception of a CAS_WINK signaling pattern is required.

447

Global Call Country Dependent Parameters (CDP) Reference

CDP_OUT_EnableRingBack: Specifies that a ringback must be received before a call is answered. The number of rings is determined by the value passed by the gc_AcceptCall( ) or gc_AnswerCall( ) function. Possible values are: 0 - Do not receive a ringback (value as released). 1 - Receive a ringback.

CDP_OUT_SeizeAck_Timeout: Specifies the time-out in milliseconds while waiting for a CAS_WINK after a line seizure. Value as released = 5000 (5 seconds). CDP_OUT_SeizeDelay: Specifies the desired delay between a makecall and a line seize attempt. Value as released = 1000 (1 second). CDP_OUT_Send_Alerting_After_Dialing: Determines when the protocol sends a GCEV_ALERTING event to the application. Possible values are: 0 - GCEV_ALERTING is sent when ringback is detected (value as released). 1 - If Call Progress Analysis (CPA) is disabled, GCEV_ALERTING is sent after dialing is completed. If CPA is enabled, GCEV_ALERTING is sent after dialing is initiated.

CDP_OUT_WinkStart: Specifies that a CAS_WINK seizure acknowledgment must be received following the generation of a seize request. Possible values are: 0 - Immediate start, that is, no wink required. 1 - Wink start, that is, wink required (value as released).

CDP_SETUP_XFER_CPA: Enable Call Progress Analysis (CPA) during supervised transfer. Possible values are: 0 - CPA disabled during supervised transfer. 1 - CPA enabled during supervised transfer (value as released).

CDP_SETUP_XFER_DIALTONE_TIMEOUT: Defines the maximum time-out in milliseconds to wait for dialtone during a supervised transfer. Set to 0 to disable waiting for dialtone during a supervised transfer. Value as released = 5000 (5 seconds).

448

99. United States T-1 Bidirectional for PDKRT (Includes FGA, FGB, FGD)

CDP_USE_DEFAULTANI: Once CDP_OUT_ANI_Enabled is set, specifies whether to use CDP_OUT_ANIString for the ANI. Otherwise, the number set by the application is used. Possible values are: 0 - The number set by the application is used for ANI (value as released). 1 - Use CDP_OUT_ANIString for the ANI.

CDP_Xfer_DigitType: Determines the digit type for transfers. Possible values are: 1 - DTMF digits (value as released). 2 - MF digits.

PSL_CACallProgressOverride (parameter for DM3) PSL_MakeCall_CallProgress (parameter for SpringWare): enables call progress to get pre-connect information (such as busy, no answer). Three modes are available: 0 - never use, always leave call progress turned off (value as released). 1 - always use, always leave turned on. 2 - pass through, turn on if specified by the gc_MakeCall( ) function.

PSL_CAMediaDetectOverride (parameter for DM3) PSL_MakeCall_MediaDetect (parameter for SpringWare): enables Media Detection to get post-connect information (such as voice, answering machine, etc.). Two modes are available: 1 - always use, always leave turned on. 2 - pass through, turn on if specified by the gc_MakeCall( ) function (value as released).

Table 104 shows the parameters that should be set in your SDP file for Feature Groups A, B, and D.

449

Global Call Country Dependent Parameters (CDP) Reference

Table 104. Parameter Values for Feature Groups A, B, and D Parameter CDP_IN_ANI_Enable CDP_IN_ANI_WINK_Needed CDP_IN_DNIS_BeforeANI CDP_IN_DNIS_Enable CDP_IN_DNIS_WINK_Needed CDP_IN_WinkStart CDP_OUT_ANI_Enable CDP_OUT_ANI_WINK_Needed CDP_OUT_DNIS_BeforeANI CDP_OUT_DNIS_Enable CDP_OUT_DNIS_WINK_Needed CDP_OUT_WinkStart FGA 0 NA NA 0 NA 0 0 NA NA 0 NA 0 FGB 0 NA NA 1 0 1 0 NA NA 1 0 1 FGD 1 1 1 1 0 1 1 1 1 1 0 1

NA - Not applicable. Modifying these values will have no effect because they are overridden by other settings.

450

100. United States T-1 FXS/LS Bidirectional for PDKRT


The United States T-1 FXS/LS (Loopstart) bidirectional protocol for PDKRT is used in a system where a foreign exchange subscriber (FXS), for example, a voice mail system is connected to a foreign exchange originator (FXO), for example, a Private Branch Exchange PBX. The protocol state information file (see Table 105) and modifiable parameters file (CDP) for the United States T-1 FXS/LS bidirectional protocol are described in this chapter. Table 105. United States T-1 FXS/LS Bidirectional for PDKRT Protocol Modules File Type Protocol Modules Linux DM3: pdk_us_ls_fxs _io.hot pdk_us_ls_fxs _io.qs SpringWare: pdk_us_ls_fxs _io.psi Country Dependent Parameter DM3 and SpringWare: pdk_us_ls_fxs _io.cdp Windows DM3: pdk_us_ls_fxs _io.hot pdk_us_ls_fxs _io.qs SpringWare: pdk_us_ls_fxs _io.psi DM3 and SpringWare: pdk_us_ls_fxs _io.cdp Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

451

Global Call Country Dependent Parameters (CDP) Reference

100.1. Protocol Limitations


The United States T-1 FXS/LS protocol is not symmetrical. It is intended to converse with an FXO protocol at the remote side.

100.2. Modifiable Parameters


gc_Open( ) Protocol Name: pdk_us_ls_fxs_io CDP File Name: pdk_us_ls_fxs_io.cdp The modifiable parameters are: CDP_BTPostDialDelay: Defines the intentional delay in milliseconds before hanging up after dialing on a blind transfer. Value as released = 500 (0.5 seconds). CDP_BTPreDialDelay: Defines the intentional delay in milliseconds after the blind transfer hookflash and the start of dialing. Note that this should not be necessary assuming the wait for dialtone parameter CDP_WaitDialToneEnabled, is enabled. Value as released = 1000 (1 second). CDP_BypassHookflashOnConsultationDrop: Permits the protocol to bypass signaling a hookflash when dropping a consultation call. Normally, this parameter should be disabled. This parameter should be enabled only in the case when all consultation calls are assumed to initiate the disconnect. When enabled, no hookflash CAS signaling is sent and only applicable state changes are delivered to the application. Possible values are: 0 - Parameter is disabled (value as released). 1 - Parameter is enabled. CDP_BypassHookflashOnTransfer: Permits the protocol to bypass signaling a hookflash when initiating either a supervised or unsupervised transfer via gc_SetUpTransfer( ) or gc_BlindTransfer( ) respectively. Normally, this parameter should be disabled. When enabled, no hookflash CAS signaling is sent and only applicable state changes are delivered to the application. Possible values are: 0 - Parameter is disabled (value as released)

452

100. United States T-1 FXS/LS Bidirectional for PDKRT

1 - Parameter is enabled. CDP_CONNECT_UPON_MEDIA: Determines if a call should transition to the Connected state immediately on Positive Media Detection, such as fax detection, modem detection, etc. Possible values are: 1 - Specifies that a call transitions to the Connected state immediately upon positive media detection, such as voice, fax, or modem detection (value as released). 0 - Specifies that a call does not transition to the Connected state immediately on positive media detection, such as voice, fax, or modem detection, but relies on signaling bit changes to indicate that a connection has been established. CDP_ConnectOnNoDialTone: Determines how the protocol should proceed when dial tone is not detected. If the parameter is enabled (set to 1), and no dial tone is detected, a local collision with an inbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 1 - Assume local collision and connect the perceived inbound call if no dial tone is detected (value as released). 0 - Do not assume local collision and disconnect the call if no dial tone is detected. CDP_ConnectOnNoRingBack: Determines how the protocol should proceed when no ringback tone is detected. If the parameter is enabled (set to 1), and no ringback is detected, a remote collision with a remote outbound call is assumed, and the call immediately transitions to Connected state. Possible values are: 0 - Do not assume remote collision and disconnect the call if no ringback is detected. 1 - Assume remote collision and connect the call if no ringback is detected (value as released).

453

Global Call Country Dependent Parameters (CDP) Reference

CDP_DialToneWaitTime: Defines the time that the protocol waits for a dial tone before an outbound call can be made. This parameter is only applicable only if the WaitDialToneEnabled parameter is set to 1. If the time defined by this parameter is exceeded before dial tone is detected, the action taken depends on the value of the ConnectOnNoDialTone parameter as follows: If the ConnectOnNoDialTone parameter is set to 1, a local collision is assumed and the incoming call is connected. If the ConnectOnNoDialTone parameter is set to 0, the call attempt fails and a disconnect event is forwarded with a reason of no dial tone.

Value as released = 5000 (5 seconds). CDP_IMMEDIATE_ACCEPTSTATE: Determines whether the FXS transitions to the Accepted state immediately upon receiving an accept call command and thus ignores the number of rings parameter. The current default is false (0) to be consistent with ICAPI, thereby waiting for the specified number of rings before transitioning to the Accepted state. Possible values are: 0 - Wait for the specified number of rings before transitioning to the Accepted state (value as released). 1 - Transition to the Accepted state immediately upon receiving an accept call command and thus ignore the number of rings parameter. CDP_MinPBXHangupTime: Specifies the length of the ring cycle and is used to determine if the remote end (that is, the PBX) has dropped an incoming call. The value of this parameter is typically set to 6 seconds which corresponds to the complete ring cycle (2 seconds on and 4 seconds of silence). The timer is reset at the start of each ring cycle. If the timer expires without resetting, ringing has been acknowledged to stop indicating the PBX has dropped the call, as the caller has abandoned the call before it was answered. Value as released = 6000 (6 seconds). CDP_OnhookDuration: Defines the intentional delay in milliseconds for going onhook prior to making a call. This behavior is only required when the gc_WaitCall( ) function has not been called to this point. Once the gc_WaitCall( ) function is called in a session, the line device is always onhook when idle and hence this parameter is ignored. Value as released = 2000 (2 seconds).

454

100. United States T-1 FXS/LS Bidirectional for PDKRT

CDP_PBXAnswerEnabled: Determines if the remote PBX supports call answer supervision via CAS line signaling. If this parameter is enabled and the device detects the specified CAS answer line signaling, the outbound call transitions to the connected state provided call progress is not mandated in the make call. Possible values are: 0 - Disable call answer supervision, since it is not supported by the PBX. 1 - Enable call answer supervision provided by the PBX (value as released).

CDP_PBXDiscEnabled: Determines if the remote PBX can initiate call disconnection via CAS line signaling. Possible values are: 0 - Disable call disconnect supervision, since it is not supported by the PBX. 1 - Enable call disconnect supervision provided by the PBX (value as released).

CDP_PostOffhookDelay: Defines the intentional delay in milliseconds after the offhook prior to dialing digits. This is used primarily in scenarios when CDP_WaitDialToneEnabled is disabled (zero). Value as released = 0. CDP_ProtocolStartsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) upon opening the device. Possible values are: 0 - Set the hook switch state to OnHook 1 - Set the hook switch state to OffHook (value as released)

CDP_ProtocolStopsOffhook: Determines the state of the hook switch signaling (OnHook or OffHook) when the protocol stops after gc_Close( ). Possible values are: 0 - Set the hook switch state to OnHook (value as released). 1 - Set the hook switch state to OffHook.

CDP_Send_Alerting_Or_Connected_After_Dial: Controls when the protocol will send a GCEV_ALERTING or GCEV_CONNECTED event to the application. Possible values are: 0 - GCEV_ALERTING is sent when ringback is detected, and GCEV_CONNECTED is sent when the call is connected (value as released).

455

Global Call Country Dependent Parameters (CDP) Reference

1 - GCEV_ALERTING is sent after dialing is completed if Call Progress Analysis (CPA) is disabled, or after dialing is initiated if CPA is enabled. However, if CPA is disabled and CDP_PBX_AnswerEnabled is also disabled, then GCEV_CONNECTED will be sent after dialing instead of GCEV_ALERTING, because the protocol would not be able to reach the connected state otherwise. CDP_WaitDialToneEnabled: Determines if the protocol should wait for a dial tone before dialing. Note this parameter does NOT apply to supervised transfers (consultation calls) in which case the dial tone is not verified. Possible values are: 1 - Have the FXS wait for dial tone before dialing (value as released). 0 - Do not wait for dial tone before dialing.

100.3. FXS Signaling Bit States


The signaling bits for the various line states handled by the United States T-1 FXS/LS Bidirectional protocol are shown in Table 106.
NOTE: FXS is a foreign exchange subscriber (for example, a voice mail system)

connected to a foreign exchange originator (FXO, for example, a PBX). The A and B signaling bit meanings are not the same for both FXO and FXS, that is, they are not symmetrical. Table 106. FXS Signaling Bit States Line State Loop Open Loop Closed Normal Talking State Detect Idle Ringing TX Bits A 0 1 1 X 0 B 1 1 1 X 1 0 0 0 1 1 0 See Note 1 below. Ring (on state). RX Bits A B Onhook Offhook Comment

456

100. United States T-1 FXS/LS Bidirectional for PDKRT

Line State Current Feed Current Feed Reversal

TX Bits A 0 1 B 1 1

RX Bits A 0 X B 1 R

Comment Ring (off state). Answer supervision. Battery reversal. See Note 2 below. Disconnect supervision. See Note 3 below.

Current Feed Open

Note 1: It is not possible to detect that the FXO side (PBX) is idle by examining the current state of the signaling bits. If the FXS (voice mail) side is on-hook, the line acts like an analog phone, that is, it is only possible to determine if the line is ringing or not. If the FXS side is off-hook, the incoming signaling bits are not guaranteed to be in any state, unless answer supervision and disconnect supervision are enabled. Note 2: Answer supervision is implemented by alternating the B-bit between 0 and 1 in successive superframes. This feature is not supported by all PBX systems. Note 3: Disconnect supervision should be interpreted as valid if the signaling bits remain in this state for more than 600 msec. This feature is not supported by all PBX systems.

100.4. FXS Call Scenarios


Table 107 through Table 112 show the signaling bit states for some common call scenarios. Table 107. Outgoing Call from Voice Mail (FXS) Line State Idle TX Bits A 0 B 1 RX Bits A 0 B 1 Onhook Comment

457

Global Call Country Dependent Parameters (CDP) Reference

Line State Voice mail goes off-hook (waiting for dial tone) Dial Remote side answers

TX Bits A 1 1 1 B 1 1 1

RX Bits A 0 0 0 B 1 1 1/0

Comment Offhook

Answer supervision, if supported by PBX.

Table 108. Incoming Call to Voice Mail (FXS) Line State Idle PBX Applies Ringing: During ringing At Interval between ringing Voice mail answers call Normal talking state 0 0 1 1 1 1 1 1 0 0 0 0 0 1 X X Ring No Ring TX Bits A B 0 1 RX Bits A B 0 1 Comment Onhook

Table 109. Incoming Call to Voice Mail (FXS) and Transfer to Extension Line State Idle PBX Applies Ringing: During ringing At Interval between ringing 0 0 1 1 0 0 0 1 Ring No Ring TX Bits A B 0 1 RX Bits A B 0 1 Comment Onhook

458

100. United States T-1 FXS/LS Bidirectional for PDKRT

Line State Voice mail answers call Voice mail play prompt Voice mail does hook flash

TX Bits A B 1 1 H 1 1 1

RX Bits A B 0 0 0 X X X

Comment

"Please enter the extension number" A-bit temporarily set to 0 then back to 1. See Note below. Delay before dialing. Delay before hang up. Delay before accepting a new call

Voice mail dials extension Voice mail goes off-hook Voice mail waits for new call

1 0 0

1 1 1

0 0 0

X X X

Note: H indicates that the A-bit state transitions from 1 to 0 to 1 to provide the hook flash. Table 110. Incoming Call to Voice Mail (FXS) but Abandoned Before Transfer Line State Idle PBX Applies Ringing: During ringing At Interval between ringing PBX abandons call PBX stops ringing call 0 0 0 0 1 1 1 1 0 0 0 0 0 1 1 1 Ring No Ring Caller hangs up. TX Bits A 0 B 1 RX Bits A 0 B 1 Onhook Comment

459

Global Call Country Dependent Parameters (CDP) Reference

Table 111. Voice Mail (FXS) Disconnects Call Line State Normal talking state Voice mail goes on-hook Idle TX Bits A 1 0 0 B 1 1 1 RX Bits A 0 0 0 B X X 1 Comment

460

100. United States T-1 FXS/LS Bidirectional for PDKRT

Table 112. PBX (FXO) Disconnects Call Line State Normal talking state PBX hangs up TX Bits A 1 1 B 1 1 RX Bits A 0 1 B X X Disconnect supervision, if supported by PBX. Comment

Idle

461

101. United States T-1 for ICAPI


The protocol modules (see Table 113) and the modifiable inbound and outbound country dependent parameters (CDP) for the United States T-1 Robbed Bit Protocol for ICAPI are described in this chapter. Table 113. United States T-1 Protocol Modules File Type Protocol Modules Linux us_mf_i.so us_mf_o.so us_mf_i.dll us_mf_o.dll Voice and Network Parameter Country Dependent Parameter us_240.prm us_240.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

us_mf_i.cdp us_mf_o.cdp

us_mf_i.cdp us_mf_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

101.1. Protocol Limitations


None.

101.2. Inbound Parameters


gc_Open( ) Protocol Name: us_mf_i

463

Global Call Country Dependent Parameters (CDP) Reference

CDP File Name: us_mf_i.cdp The modifiable parameters are: $4: Wink length time in 10-msec units. Generates a wink after seizure acknowledgment. Set to 0 to disable. Value as released = 20. $6: Inter-digit time-out. The amount of time after seizure acknowledge that the inbound protocol will wait for an initial ANI or DDI digit. It is also used as a time-out value between digits. If this parameter is set to 0, then no timeout is set and an immediate transition to the Connected state is made without waiting to receive any digits. Set this parameter to 0 if your circuit has been provisioned for Feature Group A. Value as released = 10. $7: Number of DDI digits, depends on the trunk. Check with local circuit provider. Set to the number of DDI digits plus 1. Value as released = 16. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ) or gc_AnswerCall( ). For the function gc_AnswerCall( ), however, the $9 parameter is overridden only if the function gc_AcceptCall( ) hasn't been called. Value as released = 1. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $16: Set to 1 if the CO supports ANI, 0 otherwise. When set to 1, the protocol expects to receive DNIS digits first, followed by ANI. When set to 0, ANI is not supported and the protocol only expects to receive DNIS digits. Value as released = 1. $17: Time in 10-msec units to confirm signal transition. Value as released = 25. $19: Specifies if both the leading '*' and the trailing '#' or just the trailing '#' (if present) are stripped from ANI and DDI digit strings. Setting this value to 0 will strip both the leading '*' and the trailing '#' (if present). Setting this value to 1 will strip only the trailing '#' (if present). Value as released = 0.

464

101. United States T-1 for ICAPI

$23: Enables the protocol to detect B-bit signaling transitions. Most T-1 protocols only need to monitor A-bit signaling transitions. Set this parameter to 1 to enable the detection of B-bit signaling transitions. Use parameters $50 and $53 to set the desired B-bit values. Set this parameter to 0 if you do not want to detect B-bit signaling transitions. Value as released = 0. $26: Sets the pattern you want the protocol to use to detect disconnection during conversation. Set this parameter to 1 if you want the protocol to use the bit pattern specified by $53 (DTI_DISCONNECT). Set this parameter to 0 if you want the protocol to use the bit pattern specified by $51 (DTI_IDLE). Value as released = 0. $32: Specifies the minimum time between setting the transmitted signaling bits for gc_AnswerCall( ) and setting the transmitted signaling bits for gc_DropCall( ). When a call is dropped immediately after it is answered, the protocol will indicate a connection and wait for the specified amount of time before changing the transmitted signaling bits in response to the gc_DropCall( ). Value as released = 0. The protocol implements a built-in delay of 110 msec. When the $32 parameter is set to n (where n > 0), then the delay is determined by the formula: 110 msec + n*55 msec For example, if $32 is set to 3, then the delay is: 110 msec + 3*55 msec = 275msec Value as released = 0, that is, use the built-in delay of 110 msec. Using this value provides backward compatibility with the behavior found in the 1.00 Beta 1 Release of the protocol.

$45: Minimum wink duration in 10-msec units for wink detection. Value as released = 10. $46: Maximum wink duration in 10-msec units for wink detection. Value as released = 35. $47: Specifies mask used for T-1 MF protocol as described in Table 114. Mask Bit Selections. Bits 3, 4 and 6 control wink generation. Bits 5 and 6 are mutually exclusive. The protocol either waits for a dial tone after seizure (bit 5 = 1 and bit 6 = 1) or it waits for a seizure acknowledge wink (bit 5 = 0 and bit 6 = 0). No other combination of bits 5 and 6 is valid.
465

Global Call Country Dependent Parameters (CDP) Reference

Parameter $16 must be set to 1 for ANI string generation. The protocol looks for the DNIS string first and then for the ANI string. Value as released = 23 decimal (17 hexadecimal, 00010111 binary). Table 114. Mask Bit Selections Bit 0 (lsb) 0 selects wink start 1 selects Special protocols wherein the DDI and ANI digits are surrounded by ST (*) and KP (#). Typically, KP (#) terminates the digit string. The protocol uses the time-out and the maximum DDI (ANI) number to detect errors. The values selected should be large enough to avoid false error detection. The maximum DDI (ANI) value should be set to a number greater than the largest expected DDI (ANI) digit string. MF digit Group D tone signaling wherein the ANI and DDI string are sent from the calling partys CO before the call is answered DNIS wink start for group D ANI wink start for group D Dial tone after seizure Disable seizure acknowledge wink

1 2

DTMF digit Group B tone signaling wherein ANI is sent from the calling partys CO after seizure No DNIS wink start for group D No ANI wink start for group D No dial tone after seizure Use seizure acknowledge wink

3 4 5 6

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

466

101. United States T-1 for ICAPI

101.2.1. Inbound Parameter Values for Feature Group Support Table 115 shows the values of the most pertinent inbound parameters to support Feature Groups A, B, and D. Table 115. Inbound Parameter Values for Feature Group Support Parameter $6 $7 $8 $9 $16 $47 Feature Group A 0 0 0 0 0 64 Feature Group B >0 >0 0 0 0 0 Feature Group D >0 >0 30 1 1 23

101.3. Outbound Parameters


gc_Open( ) Protocol Name: us_mf_o CDP File Name: us_mf_o.cdp
NOTES: 1. This protocol does not require call analysis. However, call progress

tones (busy tones 103 and 104 and ringback tone 105) may be useful in determining the condition of a call when the called partys protocol cannot report call progress. See the Global Call E-1/T-1 Technology Users Guide for a description of Global Call call progress capability. 2. If your circuit is provisioned for Feature Group A, your application should call the gc_MakeCall( ) function with a null dial string. The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge and to set a timeout for detection of a dial tone if bit 5 of the $47 outbound parameter is set to

467

Global Call Country Dependent Parameters (CDP) Reference

1. If your computer is heavily loaded, this time may be increased. If this timeout is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 500. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $2: Minimum time in 10-msec units before seizing line. Amount of time the protocol waits after receiving a gc_MakeCall( ) function call before protocol seizes the line. This time delay ensures a minimal assertion of the idle pattern on the line. Set to 0 for an outbound-only protocol or to a non -zero value for an inbound/outbound protocol. Value as released = 100. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $13: Default maximum time in seconds for a call to be answered. If the value is 0, the protocol does not wait for the call to be answered but immediately returns a connection to the application. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $16: Set to 1 if the CO supports ANI, 0 otherwise. When set to 1, the protocol expects to send DNIS digits first, followed by ANI. When set to 0, ANI is not supported and the protocol only expects to send DNIS digits. Value as released = 1. $17: Time in 10-msec units to confirm signal transition. Value as released = 25. $21: Determines when the GCEV_ALERTING event is sent. Setting this parameter to 0 causes the GCEV_ALERTING event to be sent to the application immediately after dialing. Setting this parameter to 1 causes the GCEV_ALERTING event to be sent after the protocol received the leading edge of the first ringback tone. Value as released = 1.

468

101. United States T-1 for ICAPI

$41: By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $45: Minimum wink duration in 10-msec units for wink detection. Value as released = 10. $46: Maximum wink duration in 10-msec units for wink detection. Value as released = 35. $47: Specifies mask used for T-1 MF protocol as described in Table 114. Mask Bit Selections. Value as released = 23 decimal (17 hexadecimal, 00010111 binary). $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol. 101.3.1. Outbound Parameter Values for Feature Group Support Table 116 shows the values of the most pertinent outbound parameters to support Feature Group A, B and D.

469

Global Call Country Dependent Parameters (CDP) Reference

Table 116. Outbound Parameter Values for Feature Group Support Parameter $16 $47 Feature Group A 0 64 Feature Group B 0 0 Feature Group D 1 23

470

102. United States T-1 Bidirectional for ICAPI


The protocol modules (see Table 117) and the modifiable inbound and outbound country dependent parameters (CDP) for the United States T-1 Bidirectional Protocol for ICAPI are described in this chapter. Table 117. United States T-1 Bidirectional Protocol Modules File Type Protocol Modules Linux us_mf_io.so Windows Description The shared protocol modules to be dynamically loaded as required. us_mf_io.dll The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

us_240.prm

us_240.prm

us_mf_io.cdp

us_mf_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

102.1. Protocol Limitations


The $1 parameter (number of rings before no answer) does not take effect. You can use the PDK version of this protocol, pdk_us_mf_io, if you require this functionality, which can be achieved through the use of gc_SetCallProgressParm( ) when using the pdk_us_mf_io protocol.

471

Global Call Country Dependent Parameters (CDP) Reference

102.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: us_mf_io CDP File Name: us_mf_io.cdp The modifiable parameters are: $0 (Outbound): Time in 10-millisecond units to wait for seizure acknowledge and to set a time-out for detection of a dial tone if bit 5 of the $47 outbound parameter is set to 1. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 500. $1 (Outbound): Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5.
NOTE: The $1 parameter does not take effect. See Section 102.1. Protocol

Limitations above. $2 (Outbound): Minimum time in 10-msec units before seizing line. Amount of time the protocol waits after receiving a gc_MakeCall( ) function call before protocol seizes the line. This time delay ensures a minimal assertion of the idle pattern on the line. Set to 0 for an outbound-only protocol or to a non-zero value for an inbound/outbound protocol. Value as released = 100. $3 (Outbound): Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used and should use the default setting of 0. Value as released = 0. $4 (Inbound): Wink length time in 10-msec units. Generates a wink after seizure acknowledgment. Set to 0 to disable. Value as released = 20. $6 (Inbound): Inter-digit time-out. The amount of time after seizure acknowledge that the inbound protocol will wait for an initial ANI or DDI digit. It is also used as a time-out value between digits. If this parameter is set to 0, then no time-out is set and an immediate transition to the Connected state is made without waiting to receive any digits. Set this parameter to 0 if

472

102. United States T-1 Bidirectional for ICAPI

your circuit has been provisioned for Feature Group A. Value as released = 10. $7 (Inbound): Number of DDI digits, depends on the trunk. Check with local circuit provider. Set to the number of DDI digits plus 1. Value as released = 16. $8 (Inbound): Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9 (Inbound): Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ) or gc_AnswerCall( ). For the function gc_AnswerCall( ), however, the $9 parameter is overridden only if the function gc_AcceptCall( ) hasn't been called. Value as released = 1. $10: Time in seconds to wait for an idle pattern on the line. Value as released = 10. $13 (Outbound): Default maximum time in seconds for a call to be answered. If the value is 0, the protocol does not wait for the call to be answered but immediately returns a connection to the application. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $16: Set to 1 if the CO supports ANI, 0 otherwise. When set to 1, the protocol expects to receive DNIS digits first, followed by ANI. When set to 0, ANI is not supported and the protocol only expects to receive DNIS digits. Value as released = 1. $17: Time in 10-msec units to confirm signal transition. Value as released = 25. $19 (Inbound): Specifies if both the leading '*' and the trailing '#' or just the trailing '#' (if present) are stripped from ANI and DDI digit strings. Setting this value to 0 will strip both the leading '*' and the trailing '#' (if present). Setting this value to 1 will strip only the trailing '#' (if present). Value as released = 0.

473

Global Call Country Dependent Parameters (CDP) Reference

$21 (Outbound): Determines when the GCEV_ALERTING event is sent. Setting this parameter to 0 causes the GCEV_ALERTING event to be sent to the application immediately after dialing. Setting this parameter to 1 causes the GCEV_ALERTING event to be sent after the protocol received the leading edge of the first ringback tone. Value as released = 1. $23 (Inbound): Enables the protocol to detect B-bit signaling transitions. Most T-1 protocols only need to monitor A-bit signaling transitions. Set this parameter to 1 to enable the detection of B-bit signaling transitions. Use parameters $50 and $53 to set the desired B-bit values. Set this parameter to 0 if you do not want to detect B-bit signaling transitions. Value as released = 0. $26 (Inbound): Sets the pattern you want the protocol to use to detect disconnection during conversation. Set this parameter to 1 if you want the protocol to use the bit pattern specified by $53 (DTI_DISCONNECT). Set this parameter to 0 if you want the protocol to use the bit pattern specified by $51 (DTI_IDLE). Value as released = 0. $32 (Inbound): Specifies the minimum time between setting the transmitted signaling bits for gc_AnswerCall( ) and setting the transmitted signaling bits for gc_DropCall( ). When a call is dropped immediately after it is answered, the protocol will indicate a connection and wait for the specified amount of time before changing the transmitted signaling bits in response to the gc_DropCall( ). Value as released = 0. The protocol implements a built-in delay of 110 msec. When the $32 parameter is set to n (where n > 0), then the delay is determined by the formula: 110 msec + n*55 msec For example, if $32 is set to 3, then the delay is: 110 msec + 3*55 msec = 275msec Value as released = 0, that is, use the built-in delay of 110 msec.

$41 (Outbound): By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. Default is required for Global Call applications. Value as released = 0. $42 (Outbound): Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a

474

102. United States T-1 Bidirectional for ICAPI

GCEV_DISCONNECTED event is sent and a timer is started. If the called party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $45: Minimum wink duration in 10-msec units for wink detection. Value as released = 10. $46: Maximum wink duration in 10-msec units for wink detection. Value as released = 35. $47: Specifies mask used for T-1 MF protocol as described in Table 118. Mask Bit Selections. Bits 3, 4, and 6 control wink generation. Bits 5 and 6 are mutually exclusive. The protocol either waits for a dial tone after seizure (bit 5 = 1 and bit 6 = 1) or it waits for a seizure acknowledge wink (bit 5 = 0 and bit 6 = 0). No other combination of bits 5 and 6 is valid. Value as released = 23 decimal (17 hexadecimal, 00010111 binary). $49 (Outbound): Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

475

Global Call Country Dependent Parameters (CDP) Reference

Table 118. Mask Bit Selections Bit 0 (lsb) 0 selects wink start 1 selects Special protocols wherein the DDI and ANI digits are surrounded by ST (*) and KP (#). Typically, KP (#) terminates the digit string. The protocol uses the time-out and the maximum DDI (ANI) number to detect errors. The values selected should be large enough to avoid false error detection. The maximum DDI (ANI) value should be set to a number greater than the largest expected DDI (ANI) digit string. MF digit Group D tone signaling wherein the ANI and DDI string are sent from the calling partys CO before the call is answered DNIS wink start for group D ANI wink start for group D Dial tone after seizure Disable seizure acknowledge wink

1 2

DTMF digit Group B tone signaling wherein ANI is sent from the calling partys CO after seizure No DNIS wink start for group D No ANI wink start for group D No dial tone after seizure Use seizure acknowledge wink

3 4 5 6

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

476

103. United States T-1 Rockwell for ICAPI


The protocol modules (see Table 119) and the modifiable inbound and outbound country dependent parameters (CDP) for the United States T-1 Rockwell Protocol for ICAPI are described in this chapter. Table 119. United States T-1 Rockwell Protocol Modules File Type Protocol Modules Linux us_rk_i.so us_rk_o.so us_rk_i.dll us_rk_o.dll Voice and Network Parameter Country Dependent Parameter us_240.prm us_240.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

us_rk_i.cdp us_rk_o.cdp

us_rk_i.cdp us_rk_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

103.1. Protocol Limitations


None.

477

Global Call Country Dependent Parameters (CDP) Reference

103.2. Inbound Parameters


gc_Open( ) Protocol Name: us_rk_i CDP File Name: us_rk_i.cdp The modifiable parameters are: $0 WAITDIAL: Set to 1 for seizure acknowledge, 0 otherwise. Must be set to 1 for Rockwell. Value as released = 1. $6 INTERDIGTIME: Time-out in seconds for incoming digits. Value as released = 0 (no digits expected). $7 MAXDIGITS: Maximum digit termination count or set to 0 is no digits expected. Value as released = 0. $43: Maximum ring pulse to receive in msec. A short pulse is less than this value and greater than the value of the $48 parameter. Value as released = 4400. $44: Minimum disconnect pulse to receive in msec. A long pulse is greater than or equal to this value and less than the value of the $45 parameter. Value as released = 1000. $45: Maximum disconnect pulse to receive. A long pulse must be less than this value and greater than or equal to the value of the $44 parameter. Value as released = 2000. $47 T1MASK: Mask for receiving address information. Value as released = 0. The significant bits are: Bit 0: Not used, set to 0. Bit 1: Possible values are 0 (DTMS reception) or 1 (MF reception).

$48: Minimum ring pulse to receive in msec. A short pulse is less than this value and greater than the value of the $43 parameter. Value as released = 3600.

Global Tone Detection Usage: Tone ID 105 is used by this protocol.

478

103. United States T-1 Rockwell for ICAPI

103.3. Outbound Parameters


gc_Open( ) Protocol Name: us_rk_o CDP File Name: us_rk_o.cdp The modifiable parameters are: $2: Time in 10-msec units to wait before making a call. Value as released = 200. $10: Time in seconds to wait for Idle. Value as released = 20. $17: Clear call pulse generation. Value as released = G0, 0, 1, F3, 120, F2, 0, 0, 0 where: F3 - is the pulse pattern 11 (AB) 15 - 15 units each 10-msec unit is 150-msec pulse pattern 11 (AB) F2 - is the signaling pattern 01 (AB)

NOTE: This is the normal clear forward pulse; repeat this cycle once.

$19: Clear call pulse generation. Value as released = G0, 0, 1, F2, 200, F3, 120, F2, 0 where: F2 - send even if already being sent 200 - 200 units of 10 msec is 2 sec F3 - is the signaling pattern 11 60 - 60 units of 10 msec is 600 msec of pulse 11 F2 - signaling pattern 01 gc_DropCall( ) issued.

NOTE: Allows for a delay of 2 seconds when clearing before call setup, if

$21: Clear call pulse generation. Value as released = G0, 0, 2, F0, 400, F2, 800, 0, 0 where: 2 - is the number of cycles. If the called party does not answer within the number of complete cycles, then time out. F0 - is the signaling pattern 00 (AB)
479

Global Call Country Dependent Parameters (CDP) Reference

200 - 200 units of 10 msec per unit is 2 sec of signaling pattern 00 F2 - is the signaling pattern 01 (AB) to restore 400 - 400 units of 10 msec which is 4 sec of signaling pattern 01. The protocol uses the termination as a time-out for acknowledge.

$41: Forced release. If set to 1, do not wait for answer, release immediately upon backward clear. Value as released = 1. $47: Mask for receiving address information. Value as released = 0. The significant bits are: Bit 0: Not used, set to 0. Bit 1: Possible values are 0 (DTMF reception) or 1 (MF reception).

Global Tone Detection Usage: None.

480

104. Uzbekistan R2 for ICAPI


The protocol modules (see Table 120) and the modifiable inbound and outbound country dependent parameters (CDP) for the Uzbekistan R2 Protocol for ICAPI are described in this chapter. Table 120. Uzbekistan R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

uz_r2_i.cdp uz_r2_o.cdp

uz_r2_i.cdp uz_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

104.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
481

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

104.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: uz_r2_i CDP File Name: uz_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

482

104. Uzbekistan R2 for ICAPI

104.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: uz_r2_o CDP File Name: uz_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

483

105. Uzbekistan R2 Bidirectional for ICAPI


The protocol modules (see Table 121) and the modifiable inbound and outbound country dependent parameters (CDP) for the Uzbekistan R2 Bidirectional Protocol for ICAPI are described in this chapter. Table 121. Uzbekistan R2 Bidirectional Protocol Modules File Type Protocol Modules Linux r2_io.so Windows Description The shared protocol module modules to be dynamically loaded as required. r2_io.dll The protocol module to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

Voice and Network Parameter Country Dependent Parameter

r2_300.prm

r2_300.prm

uz_r2_io.cdp

uz_r2_io.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

105.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a

485

Global Call Country Dependent Parameters (CDP) Reference

gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

105.2. R2 Inbound and Outbound Parameters


gc_Open( ) Protocol Name: r2_io CDP File Name: uz_r2_io.cdp The modifiable parameters are: $1 NDDI [I]: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$2 NRING [I]: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI [I]: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

486

105. Uzbekistan R2 Bidirectional for ICAPI

$21 MAXRING [O]: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB [O]: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101 and 103-105 are used by this protocol.

487

106. Venezuela R2 for ICAPI


The protocol modules (see Table 122) and the modifiable inbound and outbound country dependent parameters (CDP) for the Venezuela R2 Protocol for ICAPI are described in this chapter. Table 122. Venezuela R2 Protocol Modules File Type Protocol Modules Linux r2_in.so r2_out.so r2_in.dll r2_out.dll Voice and Network Parameter Country Dependent Parameter r2_300.prm r2_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

ve_r2_i.cdp ve_r2_o.cdp

ve_r2_i.cdp ve_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

106.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
489

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

106.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: ve_r2_i CDP File Name: ve_r2_i.cdp The modifiable parameters are: $1 NDDI: The maximum number of DDI digits received before a GCEV_OFFERED event is received. Value as released = 4. There are two possible cases: Fixed number of DDI digits. Receiving less than the number of DDI digits specified by this parameter, indicates a protocol error. For example, if $1 NDDI is 4, a GCEV_OFFERED event is generated only when four DDI digits are received. If only three DDI digits are received, this indicates a protocol error. Variable number of DDI digits. Once the number of digits specified by $1 NDDI is received, a GCEV_OFFERED event is generated. The application can then call gc_CallAck( ) to try to retrieve any additional digits.

$1.16 NANI: The maximum number of ANI digits that can be received. The actual number of ANI digits received is variable up to the maximum specified by this parameter, that is, if any number of digits up to the number specified by this parameter is received, a GCEV_OFFERED event is generated. Value as released = 10. $2 NRING: The number of rings after gc_AnswerCall( ) is issued before the GCEV_ANSWERED event is generated. An answer line signal is also sent at this time. Value as released = 1. $5.1 F_ANI: Specifies if ANI is supported or not. Possible values are: 1 (supported) or 0 (not supported). Value as released = 1.

490

106. Venezuela R2 for ICAPI

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

106.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: ve_r2_o CDP File Name: ve_r2_o.cdp The modifiable parameters are: $21 MAXRING: Specifies the number of rings before no answer. Value as released = 5. This parameter depends on the presence of tone ID $105 as follows: If the tone ID $105 is configured to detect ringback, then this parameter is used as the number of rings before a GCEV_CALLSTATUS event is returned. If the tone ID $105 is not configured, then this parameter has no effect.

$49 CALLINGNB: The default calling party number. The value of this parameter can be overridden by using the gc_SetCallingNum( ) function.

Global Tone Detection Usage: Tone IDs 101, 103-105, and 141 are used by this protocol.

491

107. Vietnam R2 Bidirectional for PDKRT


The protocol modules and modifiable country dependent parameters (CDP) file (see Table 123) for the Vietnam R2 Bidirectional Protocol for PDKRT are described in this chapter. Table 123. Vietnam R2 Bidirectional for PDKRT Protocol Modules File Type Protocol Module Linux DM3: pdk_vn_r2_io. hot pdk_vn_r2_io. qs SpringWare: pdk_vn_r2_io. psi Voice and Network Parameter Country Dependent Parameter SpringWare only: vn_300.prm DM3 and SpringWare: pdk_vn_r2_io. cdp Windows DM3: pdk_vn_r2_io. hot pdk_vn_r2_io. qs SpringWare: pdk_vn_r2_io. psi SpringWare only: vn_300.prm DM3 and SpringWare: pdk_vn_r2_io. cdp A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter. Description The protocol module to be dynamically loaded as required.

NOTES: 1. File names that have _io before the extension indicate a protocol file

that can handle both inbound and outbound calls. 2. A site dependent parameters (.sdp) file can be used in addition to the country dependent parameters (.cdp) file. The .sdp file specifies parameters that are site specific.

493

Global Call Country Dependent Parameters (CDP) Reference

107.1. Protocol Limitations


None.

107.2. Inbound and Outbound Parameters


gc_Open( ) Protocol Name: pdk_vn_r2_io CDP File Name: pdk_vn_r2_io.cdp The modifiable parameters are: cdp_NANI: Specifies the number of ANI digits. Value as released = 7. cdp_NDNIS1: Specifies the number of DNIS digits received in the first of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, where NDNIS=NDNIS1 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, where NDNIS=NDNIS1 Call Scenario 3, DNIS1, CAT, ANI, DNIS2 and CAT are received, where NDNIS1 is a fixed number (such as 1, 2, ...)

Value as released = 4. cdp_NDNIS2: Specifies the number of DNIS digits received in the second of two sessions. The total number of DNIS (NDNIS) can possibly be received in two sessions, that is, NDNIS=NDNIS1+NDNIS2, where NDNIS1 is the number of DNIS received in the first session, and NDNIS2 is the number of DNIS received in the second session. Three R2 call scenarios are possible, depending on the value set for CDP_R2CallScenario: Call Scenario 1, DNIS and CAT (category) are received, NDNIS2 = 0 Call Scenario 2, DNIS, CAT, ANI, and CAT are received, NDNIS2 = 0

494

107. Vietnam R2 Bidirectional for PDKRT

Call Scenario 3, DNIS1, CAT, ANI, DNIS2, and CAT are received, where NDNIS2 is a fixed known number or variable length

Value as released = 2. CDP_ProtocolReset_Timeout: Defines the maximum time-out in milliseconds for input remotely or from the environment if a protocol reset is active. On expiration of this time-out, the application returns to the initial state. Value as released = 5000 (5 seconds). CDP_R2CallScenario: Specifies the following R2 call scenarios: 0 - Line signaling only (that is, ITU-T Q.421 + Q.422) 1 - DNIS+CAT 2 - DNIS+CAT+ANI+CAT (value as released) 3 - DNIS1+CAT+ANI+DNIS2+CAT
NOTE: For outbound only R2 protocol, call scenario 1, 2, and 3 are

automatically handled. So any value greater than or equal to 1 will enable R2 one signaling. CDP_SEIZEACK_TIMEOUT: Defines the maximum time-out in milliseconds for a CAS_SEIZEACK event once the line is seized by sending a CAS_SEIZE. The remote end is expected to acknowledge the CAS_SEIZE event during this interval. If not, the outgoing call is considered to have failed. Value as released = 5000 (5 seconds).

495

108. Vietnam R2 for ICAPI


The protocol modules (see Table 124) and the modifiable inbound and outbound country dependent parameters (CDP) for the Vietnam R2 Protocol for ICAPI are described in this chapter. Table 124. Vietnam R2 Protocol Modules File Type Protocol Modules Linux vn_r2_i.so vn_r2_o.so vn_r2_i.dll vn_r2_o.dll Voice and Network Parameter Country Dependent Parameter vn_300.prm vn_300.prm Windows Description The shared protocol modules to be dynamically loaded as required. The protocol modules to be dynamically loaded as required. A file that contains voice and network parameters. Protocol related parameters. Parameters that can be finetuned are described in this chapter.

vn_r2_i.cdp vn_r2_o.cdp

vn_r2_i.cdp vn_r2_o.cdp

Refer to the Global Call E-1/T-1 Technology Users Guide for detailed information about using these files with the Global Call software.

108.1. Protocol Limitations


The following limitation of this protocol restricts the functionality of the Global Call API: From the Accepted state, the protocol used in this country does not support a forced release of the line; that is, issuing a gc_DropCall( ) function after a gc_AcceptCall( ) function. If a forced release is attempted, the function will fail and an error is returned. To recover, the application should issue a
497

Global Call Country Dependent Parameters (CDP) Reference

gc_AnswerCall( ) function followed by gc_DropCall( ) and gc_ReleaseCall( ) functions. However, anytime a GCEV_DISCONNECTED event is received in the Accepted state, the gc_DropCall( ) function can be issued.

108.2. R2 Inbound Parameters


gc_Open( ) Protocol Name: vn_r2_i CDP File Name: vn_r2_i.cdp The modifiable parameters are: $6: Time-out for incoming calls in seconds. Value as released = 18. $7: Number of DDI digits. Value as released = 6. $8: Maximum number of ANI digits. Use a value at least equal to the longest ANI string to get all the digits. If ANI is not supported by the trunk, gc_GetANI( ) will fail. Value as released = 10. $9: Default number of ringback cycles before answering a call. Set to 0 for immediate answer, 1 for a single ON period, 2 for an ON-OFF-ON cycle, etc. To override this parameter, use a value different from 0 in the rings field of gc_AcceptCall( ). Value as released = 1. $10: Time in seconds to wait for Idle. Value as released = 10. $16: Set to 1 if the CO supports ANI, 0 otherwise. Value as released = 1. $32: Specifies the position in the DDI string at which to ask for ANI digits: 0=after the number of digits specified in $7, 1 =after first DDI digit, -1 =after all but one DDI digits, etc. Value as released = 0.

Global Tone Detection Usage: Tone IDs 105, 111-127, 136-141, 143, 144, and 146 are used by this protocol.

108.3. R2 Outbound Parameters


gc_Open( ) Protocol Name: vn_r2_o

498

108. Vietnam R2 for ICAPI

CDP File Name: vn_r2_o.cdp The modifiable parameters are: $0: Time in 10-msec units to wait for seizure acknowledge. If your computer is heavily loaded, this time may be increased. If this time-out is too short, the application receives the GCEV_DISCONNECTED event with a GCRV_TIMEOUT result value. Value as released = 200. $1: Number of ringback tones before returning GCEV_CALLSTATUS event with a GCRV_NOANSWER result value. If a ringback tone template is defined (GTD tone ID 105), this parameter specifies the maximum number of tone-off events. If no ringback template is defined, this parameter is ignored. Value as released = 5. $3: Maximum time in 10-msec units between 2 rings to detect answer. This parameter is normally not used. Value as released = 0. $10: Time in seconds to wait for Idle. Value as released = 10. $11: Time-out in seconds during digit for outbound calls. Value as released = 5. $12: Time-out in seconds between digits for outbound calls. Value as released = 10. $13: Default maximum time in seconds for a call to be answered. The timeout parameter of the gc_MakeCall( ) function overrides this parameter on a call basis. GCEV_CALLSTATUS event is sent if answer is not detected within the specified time interval. Value as released = 80. $41: Return to idle after remote disconnection. By default, the protocol does not disconnect the line when the remote party hangs up. Instead, it sends the GCEV_DISCONNECTED event and waits for the gc_DropCall( ) function before releasing the line. By setting this parameter to 1, the protocol will disconnect the line automatically when it sends the GCEV_DISCONNECTED event. Note that the application still needs to call gc_DropCall( ) to perform other functions. Value as released = 0. $42: Called party disconnect supervision time in seconds. (Not used if parameter $41 is set to 1.) After called party disconnection, a GCEV_DISCONNECTED event is sent and a timer is started. If the called

499

Global Call Country Dependent Parameters (CDP) Reference

party has not reanswered the call within time-out, the line is automatically released. Set to 0 to disable this condition. Value as released = 60.

Caution Global Call does not fully support this operation at this time. This value should be set to zero. $49: Default terminal extension number. To suppress sending of ANI information to the network, specify an empty string. This parameter is overwritten on a line basis by gc_SetCallingNum( ).

Global Tone Detection Usage: Tone IDs 105, 433-442, and 497-511 are used by this protocol.

500

Index
A
Alcatel 4400 Switch E-1 FXS protocol, 21 Alcatel VPS for 4x00 Switch protocol, 25 Argentina R2 Bidirectional for ICAPI protocol file set, 39 Argentina R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 30 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 31 CDP_ANI_WITHAC_FACILITY_ ENABLED, 31 CDP_AreaCode, 31 CDP_CallingPartyCategory, 31 CDP_GrpB_Tone, 32 CDP_Immediate_AcceptState, 32 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 32 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 33 CDP_NUM_OF_AC_DIGITS, 33 CDP_NUM_OF_ANI_DIGITS, 34 CDP_NUM_OF_DNIS_DIGITS, 34 CDP_REJECT_WITH_A3B4, 34 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 34 CDP_TrunkPrefixNumber, 34 file set, 29 modifiable parameters, 30 Argentina R2 Inbound and Outbound for ICAPI protocol file set, 35 Australia R2 for ICAPI protocol file set, 43 Austria E-1 for ICAPI protocol file set, 47

B
Belgium R2 CO Emulation for ICAPI protocol file set, 55 Belgium R2 for ICAPI protocol file set, 51 Brazil R2 Bidirectional for ICAPI protocol file set, 75 Brazil R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 60 CDP_ANI_MaxDigits, 60 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 61 CDP_ANI_WITHAC_FACILITY_ ENABLED, 61 CDP_AreaCode, 61 CDP_CallingPartyCategory, 61 CDP_DNIS_MaxDigits, 62 CDP_DOUBLE_ANSWER_FLAG, 62 CDP_GrpB_Tone, 62 CDP_Immediate_AcceptState, 62 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 62 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 63 CDP_NO_OF_DNIS_BEFORE_C AT, 63 CDP_NUM_OF_AC_DIGITS, 64

501

Global Call Country Dependent Parameters (CDP) Reference

CDP_NUM_OF_ANI_DIGITS, 64 CDP_NUM_OF_DNIS_DIGITS, 64 CDP_REANSWER_TIMEOUT, 65 CDP_RECV_CALL_EVENT_SEN T_WITH_FIRST_ANSWE R, 65 CDP_REJECT_WITH_A3B4, 65 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 65 CDP_TrunkPrefixNumber, 66 file set, 59 modifiable parameters, 60 Brazil R2 Inbound and Outbound for ICAPI protocol file set, 67 Bulgaria R2 for ICAPI protocol file set, 79

R2 Bidirectional for PDKRT protocol, 60 CDP_ANI_MaxDigits Brazil R2 Bidirectional for PDKRT protocol, 60 China R2 Bidirectional for PDKRT protocol, 92 Colombia R2 Bidirectional for PDKRT protocol, 110 Finland R2 Bidirectional for PDKRT protocol, 144 India R2 Bidirectional for PDKRT protocol, 170 CDP_ANI_WITHAC_FACILITY_CHE CK_NEEDED Argentina R2 protocol, 31 Brazil R2 Bidirectional for PDKRT, 61 Colombia R2 Bidirectional for PDKRT protocol, 110 Finland R2 Bidirectional for PDKRT protocol, 145 India R2 Bidirectional for PDKRT protocol, 171 Israel R2 Bidirectional for PDKRT protocol, 197 CDP_ANI_WITHAC_FACILITY_ENA BLED Argentina R2 protocol, 31 Brazil R2 Bidirectional for PDKRT protocol, 61 Colombia R2 Bidirectional for PDKRT protocol, 111 Finland R2 Bidirectional for PDKRT protocol, 145 India R2 Bidirectional for PDKRT protocol, 171 Israel R2 Bidirectional for PDKRT protocol, 197 CDP_AreaCode Argentina R2 protocol, 31

C
call scenarios United States T-1 FXS/LS Bidirectional protocol, 457 CCITT R2 protocol, 83 CDP_ANI_ENABLE Argentina R2 protocol, 30 China R2 Bidirectional for PDKRT protocol, 94 China R2 protocol, 92 Colombia R2 Bidirectional for PDKRT protocol, 110 Finland R2 Bidirectional for PDKRT protocol, 144 India R2 Bidirectional for PDKRT protocol, 170 Israel R2 Bidirectional for PDKRT protocol, 196 Italy E-1 Bidirectional for PDKRT, 210 Mexico R2 Bidirectional for PDKRT protocol, 270

502

Index

Brazil R2 Bidirectional for PDKRT protocol, 61 Colombia R2 Bidirectional for PDKRT protocol, 111 Finland R2 Bidirectional for PDKRT protocol, 145 India R2 Bidirectional for PDKRT protocol, 171 Israel R2 Bidirectional for PDKRT protocol, 197 CDP_BTPostDialDelay United States T-1 FXS/LS Bidirectional for PDKRT protocol, 452 CDP_BTPreDialDelay United States T-1 FXS/LS Bidirectional for PDKRT protocol, 453 CDP_CallAnalysis_Enabled Taiwan Lucent Switch protocol, 390 CDP_CallingPartyCategory Argentina R2 Bidirectional for PDKRT protocol, 31 Brazil R2 Bidirectional for PDKRT protocol, 61 China R2 Bidirectional for PDKRT protocol, 93 China R2 Bidirectional for PDKRT protocol, 93 Colombia R2 Bidirectional for PDKRT protocol, 111 Finland R2 Bidirectional for PDKRT protocol, 145 India R2 Bidirectional for PDKRT protocol, 171 Israel R2 Bidirectional for PDKRT protocol, 197 Mexico R2 Bidirectional for PDKRT protocol, 270, 271 CDP_Connect_Upon_Media

United States T-1 FXS/LS Bidirectional for PDKRT protocol, 453 CDP_ConnectOnNoDialTone United States T-1 FXS/LS Bidirectional for PDKRT protocol, 453 CDP_ConnectOnNoRingBack United States T-1 FXS/LS Bidirectional for PDKRT protocol, 453 CDP_Dial_Using_DTMF Sweden P7 Bidirectional protocol, 374 Sweden P7 PBX Bidirectional for PDKRT protocol, 378 CDP_DialToneEnabled Sweden P7 Bidirectional protocol, 374 Sweden P7 PBX Bidirectional for PDKRT protocol, 378 CDP_DialToneWaitTime United States T-1 FXS/LS Bidirectional for PDKRT protocol, 454 CDP_DNIS _ENABLE Mexico R2 Bidirectional for PDKRT protocol, 272 CDP_DNIS_DIGITS_BEFORE_ANI China R2 Bidirectional for PDKRT protocol, 94 Mexico R2 Bidirectional for PDKRT protocol, 271 CDP_DNIS_MaxDigits Brazil R2 Bidirectional for PDKRT protocol, 62 China R2 Bidirectional for PDKRT protocol, 94

503

Global Call Country Dependent Parameters (CDP) Reference

Finland R2 Bidirectional for PDKRT protocol, 146 India R2 Bidirectional for PDKRT protocol, 172 Israel R2 Bidirectional for PDKRT protocol, 198 Mexico R2 Bidirectional for PDKRT protocol, 272 CDP_DOUBLE_ANSWER_FLAG Brazil R2 Bidirectional for PDKRT protocol, 62 CDP_GrpB_Tone Argentina R2 Bidirectional for PDKRT protocol, 32 Brazil R2 Bidirectional for PDKRT, 62 China R2 Bidirectional for PDKRT protocol, 95 Colombia R2 Bidirectional for PDKRT protocol, 112 Finland R2 Bidirectional for PDKRT protocol, 146 India R2 Bidirectional for PDKRT protocol, 172 Israel R2 Bidirectional for PDKRT protocol, 198 Mexico R2 Bidirectional for PDKRT protocol, 272 CDP_Immediate_Accept_State Argentina R2 Bidirectional for PDKRT protocol, 32, 62 China R2 Bidirectional for PDKRT protocol, 95 Colombia R2 Bidirectional for PDKRT protocol, 112 Finland R2 Bidirectional for PDKRT protocol, 146 India R2 Bidirectional for PDKRT protocol, 172 Israel R2 Bidirectional for PDKRT protocol, 198

Italy E-1 Bidirectional for PDKRT protocol, 211 Mexico R2 Bidirectional for PDKRT protocol, 273 Sweden P7 PBX Bidirectional for PDKRT protocol, 378 CDP_IMMEDIATE_ACCEPTSTATE Sweden P7 Bidirectional for PDKRT protocol, 374 CDP_IS_ANIAVAILABILITY_CHEC K_NEEDED Argentina R2 Bidirectional for PDKRT protocol, 32 Brazil R2 Bidirectional for PDKRT protocol, 62 Colombia R2 Bidirectional for PDKRT protocol, 112 Finland R2 Bidirectional for PDKRT protocol, 146 India R2 Bidirectional for PDKRT protocol, 172 Israel R2 Bidirectional for PDKRT protocol, 198 CDP_IS_CALLING_LINE_IDENTIFI CATION_PERMITTED Argentina R2 Bidirectional for PDKRT, 33 Brazil R2 Bidirectinal for PDKRT protocol, 63 Colombia R2 Bidirectional for PDKRT protocol, 112 Finland R2 Bidirectional for PDKRT protocol, 147 India R2 Bidirectional for PDKRT protocol, 173 Israel R2 Bidirectional for PDKRT protocol, 199 CDP_MaxDigits Sweden P7 PBX Bidirectional for PDKRT protocol, 378 CDP_MinPBXHangupTime

504

Index

United States T-1 FXS/LS Bidirectional for PDKRT protocol, 454 CDP_NO_ANI_CAT_KA_ENABLED China R2 Bidirectional for PDKRT protocol, 95 CDP_NO_OF_DNIS_BEFORE_CAT Argentina R2 Bidirectional for PDKRT, 33 CDP_NO_OF_DNIS_BEFORE_CAT Argentina R2 Bidirectional for PDKRT, 33 Brazil R2 Bidirectional for PDKRT protocol, 63 Colombia R2 Bidirectional for PDKRT protocol, 113 Finland R2 Bidirectional for PDKRT protocol, 147 India R2 Bidirectional for PDKRT protocol, 173 Israel R2 Bidirectional for PDKRT protocol, 199 CDP_NUM_OF_AC_DIGITS Argentina R2 Bidirectional for PDKRT protocol, 33 Brazil R2 Bidirectional for PDKRT protocol, 64 Colombia R2 Bidirectional for PDKRT protocol, 113 India R2 Bidirectional for PDKRT protocol, 173 Israel R2 Bidirectional for PDKRT protocol, 199 CDP_NUM_OF_ANI_DIGITS Argentina R2 protocol, 34 Brazil R2 Bidirectional for PDKRT, 64 Colombia R2 Bidirectional for PDKRT protocol, 113 Finland R2 Bidirectional for PDKRT protocol, 148

India R2 Bidirectional for PDKRT protocol, 174 Israel R2 Bidirectional for PDKRT protocol, 200 Mexico R2 Bidirectional for PDKRT protocol, 273 CDP_NUM_OF_DNIS_DIGITS Argentina R2 Bidirectional for PDKRT protocol, 34 Brazil R2 Bidirectional for PDKRT, 64 China R2 Bidirectional for PDKRT protocol, 95 Colombia R2 Bidirectional for PDKRT protocol, 114 Finland R2 Bidirectional for PDKRT protocol, 148 India R2 Bidirectional for PDKRT protocol, 174 Israel R2 Bidirectional for PDKRT protocol, 200 Italy E-1 Bidirectional for PDKRT protocol, 211 Mexico R2 protocol, 273 CDP_PBXAnswerEnable United States T-1 FXS/LS Bidirectional protocol, 455 CDP_PBXAnswerEnabled United States T-1 FXS/LS Bidirectional for PDKRT protocol, 455 CDP_PBXDiscEnable United States T-1 FXS/LS Bidirectional for PDKRT protocol, 455 CDP_PostOffhookDelay United States T-1 FXS/LS Bidirectional for PDKRT protocol, 455 CDP_ProtocolReset_Timeout

505

Global Call Country Dependent Parameters (CDP) Reference

Italy E-1 Bidirectional for PDKRT protocol, 211 CDP_ProtocolStopsOffhook United States T-1 FXS/LS Bidirectional for PDKRT protocol, 455 CDP_REANSWER_TIMEOUT Brazil R2 Bidirectional for PDKRT protocol, 65 CDP_RECV_CALL_EVENT_SENT_ WITH_FIRST_ANSWER Brazil R2 Bidirectional for PDKRT protocol, 65 CDP_REJECT_WITH_A3B4 Argentina R2 Bidirectional for PDKRT protocol, 34 Brazil R2 Bidirectional for PDKRT, 65 Colombia R2 Bidirectional for PDKRT protocol, 114 Finland R2 Bidirectional for PDKRT protocol, 148 India R2 Bidirectional for PDKRT protocol, 174 Israel R2 Bidirectional for PDKRT protocol, 200 CDP_SeizeAck_Timeout Italy E-1 Bidirectional for PDKRT protocol, 211 CDP_SEND_BLOCK_AT_START_OR _REMOTE_BLOCK Argentina R2 Bidirectional for PDKRT protocol, 34 Brazil R2 Bidirectional for PDKRT, 65 China R2 Bidirectional for PDKRT protocol, 95 Colombia R2 Bidirectional for PDKRT protocol, 114

Finland R2 Bidirectional for PDKRT protocol, 148 India R2 Bidirectional for PDKRT protocol, 174 Israel R2 Bidirectional for PDKRT protocol, 200 Italy E-1 Bidirectional for PDKRT protocol, 211 Mexico R2 Bidirectional for PDKRT protocol, 273 Sweden P7 Bidirectional for PDKRT protocol, 374 Sweden P7 PBX Bidirectional for PDKRT protocol, 379 CDP_TermToneString Sweden P7 PBX Bidirectional for PDKRT protocol, 379 CDP_TrunkPrefixNumber Argentina R2 Bidirectional for PDKRT, 34 Brazil R2 Bidirectional for PDKRT, 66 Colombia R2 Bidirectional for PDKRT protocol, 114 Finland R2 Bidirectional for PDKRT protocol, 148 India R2 Bidirectional for PDKRT protocol, 174 Israel R2 Bidirectional for PDKRT protocol, 200 CDP_WaitDialToneEnabled United States T-1 FXS/LS Bidirectional for PDKRT protocol, 456 Chile R2 Bidirectional for ICAPI protocol file set, 87 China R2 CDP_CallingPartyCategory, 93 CDP_DNIS_DIGITS_BEFORE_A NI, 94

506

Index

CDP_DNIS_MaxDigits, 94 China R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 92, 94 CDP_ANI_MaxDigits, 92 CDP_CallingPartyCategory, 93 CDP_GrpB_Tone, 95 CDP_Immediate_AcceptState, 95 CDP_NO_ANI_CAT_KA_ENABL ED, 95 CDP_NUM_OF_DNIS_DIGITS, 95 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 95 file set, 91, 105 China R2 Inbound and Outbound for ICAPI protocol file set, 97 Colombia R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 110 CDP_ANI_MaxDigits, 110 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 110 CDP_ANI_WITHAC_FACILITY_ ENABLED, 111 CDP_AreaCode, 111 CDP_CallingPartyCategory, 111 CDP_GrpB_Tone, 112 CDP_Immediate_AcceptState, 112 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 112 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 112 CDP_NO_OF_DNIS_BEFORE_C AT, 113 CDP_NUM_OF_AC_DIGITS, 113 CDP_NUM_OF_ANI_DIGITS, 113 CDP_NUM_OF_DNIS_DIGITS, 114 CDP_REJECT_WITH_A3B4, 114

CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 114 CDP_TrunkPrefixNumber, 114 file set, 109 modifiable parameters, 110 Colombia R2 for ICAPI protocol file set, 115 Croatia R2 for ICAPI protocol file set, 119 Czech Republic R2 Bidirectional for ICAPI protocol file set, 127 Czech Republic R2 for ICAPI protocol file set, 123

D
DC5A Delay Start Bidirectional for ICAPI protocol file set, 131 DC5A Immediate Start Bidirectional for ICAPI protocol file set, 135 DC5A Wink Start Bidirectional for ICAPI protocol file set, 139

F
Feature Groups A, B, and D, 439 Finland R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 144 CDP_ANI_MaxDigits, 144 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 145 CDP_ANI_WITHAC_FACILITY_ ENABLED, 145 CDP_AreaCode, 145 CDP_CallingPartyCategory, 145

507

Global Call Country Dependent Parameters (CDP) Reference

CDP_DNIS_MaxDigits, 146 CDP_GrpB_Tone, 146 CDP_Immediate_AcceptState, 146 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 146 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 147 CDP_NO_OF_DNIS_BEFORE_C AT, 147 CDP_NUM_OF_ANI_DIGITS, 148 CDP_NUM_OF_DNIS_DIGITS, 148 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 148 CDP_TrunkPrefixNumber, 148 file set, 143 modifiable parameters, 144 REJECT_WITH_A3B4, 148 Finland R2 for ICAPI protocol file set, 149 France E-1 for ICAPI protocol file set, 153

G
Georgia R2 Inbound for ICAPI protocol file set, 157 Greece E-1 for ICAPI protocol file set, 159

CDP_ANI_MaxDigits, 170 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 171 CDP_ANI_WITHAC_FACILITY_ ENABLED, 171 CDP_AreaCode, 171 CDP_CallingPartyCategory, 171 CDP_DNIS_MaxDigits, 172 CDP_GrpB_Tone, 172 CDP_Immediate_AcceptState, 172 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 172 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 173 CDP_NO_OF_DNIS_BEFORE_C AT, 173 CDP_NUM_OF_AC_DIGITS, 173 CDP_NUM_OF_ANI_DIGITS, 174 CDP_NUM_OF_DNIS_DIGITS, 174 CDP_REJECT_WITH_A3B4, 174 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 174 CDP_TrunkPrefixNumber, 174 file set, 169 modifiable parameters, 170 India R2 for ICAPI protocol file set, 175 Indonesia E&M for ICAPI protocol file set, 179 Indonesia E&M protocol, 185 Indonesia R2 for ICAPI protocol file set, 189 Israel R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 196 CDP_ANI_WITHAC_FACILITY_ CHECK_NEEDED, 197

H
Hong Kong DTMF protocol, 163 Hungary R2 for ICAPI protocol file set, 165

I
India R2 Bidirectional for PDKRT Protocol CDP_ANI_ENABLE, 170

508

Index

CDP_ANI_WITHAC_FACILITY_ ENABLED, 197 CDP_AreaCode, 197 CDP_CallingPartyCategory, 197 CDP_DNIS_MaxDigits, 198 CDP_GrpB_Tone, 198 CDP_Immediate_AcceptState, 198 CDP_IS_ANIAVAILABILITY_CH ECK_NEEDED, 198 CDP_IS_CALLING_LINE_IDENT IFICATION_PERMITTED, 199 CDP_NO_OF_DNIS_BEFORE_C AT, 199 CDP_NUM_OF_AC_DIGITS, 199 CDP_NUM_OF_ANI_DIGITS, 200 CDP_NUM_OF_DNIS_DIGITS, 200 CDP_REJECT_WITH_A3B4, 200 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 200 CDP_TrunkPrefixNumber, 200 file set, 195 modifiable parameters, 196 Israel R2 CO Emulation for ICAPI protocol file set, 205 Israel R2 for ICAPI protocol file set, 201 Italy E-1 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 210 CDP_Immediate_AcceptState, 211 CDP_NUM_OF_DNIS_DIGITS, 211 CDP_ProtocolReset_Timeout, 211 CDP_SeizeAck_Timeout, 211 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 211 file set, 209

modifiable parameters, 210 Italy E-1 for ICAPI protocol file set, 213

K
Kazakhstan R2 for ICAPI protocol file set, 217 Korea R2 for ICAPI protocol file set, 221 modifiable parameters, 222 Korea R2 protocol, 225 Kuwait R2 modifiable parameters, 230 Kuwait R2 protocol file set, 229

L
Latvia R2 for ICAPI protocol file set, 233 modifiable parameters, 234 Lebanon R2 protocol file set, 237 Lithuania R2 protocol file set, 241 Lucent Lineside E-1 protocol, 245

M
Malaysia R2 protocol, 253 file set, 249 Malta R2 protocol file set, 257 MELCAS Bidirectional Terminal Equipment protocol file set, 261 MELCAS Network Side Bidirectional protocol

509

Global Call Country Dependent Parameters (CDP) Reference

file set, 265 Mexico R2 CDP_NUM_OF_DNIS_DIGITS, 273 Mexico R2 Bidirectional for ICAPI protocol file set, 279 Mexico R2 Bidirectional for PDKRT protocol CDP_ANI_ENABLE, 270 CDP_CallingPartyCategory, 270, 271 CDP_DNIS_DIGITS_BEFORE_A NI, 271 CDP_DNIS_ENABLE, 272 CDP_DNIS_MaxDigits, 272 CDP_GrpB_Tone, 272 CDP_Immediate_AcceptState, 273 CDP_NUM_OF_ANI_DIGITS, 273 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 273 file set, 269 modifiable parameters, 270 Mexico R2 Inbound and Outbound for ICAPI protocol file set, 275 Morocco R2 protocol file set, 283

Nortel Meridian Lineside E-1 protocol, 299 North American Analog for PDKRT protocol, 303 Norway R2 protocol file set, 307

P
Pakistan R2 protocol, 311 parameters for Argentina R2 protocol, 30 for Brazil R2 Bidirectional for PDKRT protocol, 60 for Colombia R2 Bidirectional for PDKRT protocol, 110 for Finland R2 Bidirectional for PDKRT protocol, 144 for India R2 protocol, 170 for Israel R2 protocol, 196 for Italy E-1 Bidirectional for PDKRT, 210 for Korea R2 for ICAPI, 222 for Kuwait R2, 230 for Latvia R2 for ICAPI, 234 for Mexico R2 Bidirectional for PDKRT protocol, 270 United States T-1 FXS/LS Bidirectional for PDKRT protocol, 452 Philippines R2 protocol, 319 file set, 315 Poland R2 protocol file set, 323 Portugal R2 protocol file set, 327

N
Netherlands Network Side protocol file set, 291 Netherlands Terminal Equipment Side protocol file set, 287 Nigeria R2 protocol file set, 295

R
Romania R2 protocol file set, 331

510

Index

S
Saudi Arabia R2 protocol file set, 335 signaling bit states United States T-1 FXS/LS Bidirectional protocol, 456 Singapore R2 for ICAPI protocol file set, 339 Singapore R2 protocol, 343 Slovakia R2 protocol file set, 347 South Africa R2 (CO Emulation) protocol file set, 355 South Africa R2 protocol file set, 351 Spain E-1 (2 of 6) protocol file set, 365 Spain E-1 CO Emulation protocol file set, 369 Spain E-1 protocol file set, 361 Sweden CO Emulation for ICAPI protocol file set, 381 Sweden E-1for ICAPI protocol file set, 385 Sweden P7 Bidirectional for PDKRT protocol CDP_IMMEDIATE_ACCEPTSTA TE, 374 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 374 file set, 373 Sweden P7 Bidirectional protocol

CDP_Dial_Using_DTMF, 374 CDP_DialToneEnabled, 374 Sweden P7 PBX Bidirectional for PDKRT protocol CDP_Dial_Using_DTMF, 378 CDP_DialToneEnabled, 378 CDP_Immediate_AcceptState, 378 CDP_MaxDigits, 378 CDP_SEND_BLOCK_AT_START _OR_REMOTE_BLOCK, 379 CDP_TermToneString, 379 file set, 377

T
Taiwan Lucent Definity G3V8 Switch protocol CDP_CallAnalysis_Enabled, 390 file set, 389 Taiwan Modified R1 protocol, 391 Taiwan T-1 for ICAPI protocol file set, 393 Thailand R2 CFT protocol file set, 403 Thailand R2 protocol, 407 Thailand R2 TOT protocol file set, 399 Tunisia R2 protocol file set, 411 Turkey E-1 (1-bit) bidirectional protocol file set, 415 Turkey E-1 (2-bits) bidirectional protocol file set, 421

511

Global Call Country Dependent Parameters (CDP) Reference

U
United Kingdom E-1 CallStream protocol file set, 427 United Kingdom E-1 Mercury Bidirectional for ICAPI protocol file set, 435 United Kingdom E-1 Mercury Inbound and Outbound for ICAPI protocol file set, 431 United States T-1 Bidirectional for ICAPI protocol file set, 471 United States T-1 Bidirectional for PDKRT protocol, 439 United States T-1 FXS/LS Bidirectional for PDKRT protocol CDP_Connect_Upon_Media, 453 CDP_ConnectOnNoDialTone, 453 CDP_ConnectOnNoRingBack, 453 CDP_DialToneWaitTime, 454 CDP_MinPBXHangupTime, 454 CDP_PBXAnswerEnabled, 455 CDP_PBXDiscEnable, 455 CDP_PostOffhookDelay, 455 CDP_ProtocolStopsOffhook, 455 CDP_WaitDialToneEnabled, 456

file set, 451 United States T-1 FXS/LS Bidirectional protocol call scenarios, 457 CDP_BTPostDialDelay, 452 CDP_BTPreDialDelay, 453 CDP_PBXAnswerEnable, 455 modifiable parameters, 452 signaling bit states, 456 United States T-1 Inbound and Outbound for ICAPI protocol file set, 463 United States T-1 Rockwell for ICAPI protocol file set, 477 Uzbekistan R2 Bidirectional for ICAPI protocol file set, 485 Uzbekistan R2 Inbound and Outbound for ICAPI protocol file set, 481

V
Venezuela R2 for ICAPI protocol file set, 489 Vietnam R2 for ICAPI protocol file set, 497 Vietnam R2 protocol, 493

512

You might also like