Summary of the content on the page No. 1
®
Dialogic Global Call IP
Technology Guide
November 2007
05-2239-009
Summary of the content on the page No. 2
Copyright © 2003-2007, Dialogic Corporation. All rights reserved.You may not reproduce this document in whole or in part without permission in writing from Dialogic Corportation. All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries (“Dialogic”). Reasonable effort is made to ensure the accuracy of the information contained in the document. However
Summary of the content on the page No. 3
Contents Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Applicability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 4
Contents 3.2.2 Endpoint Behavior in H.450.2 Blind Call Transfers . . . . . . . . . . . . . . . . . . . . . . . .57 3.2.3 Successful H.450.2 Blind Call Transfer Scenario . . . . . . . . . . . . . . . . . . . . . . . . .59 3.2.4 Unsuccessful H.450.2 Blind Call Transfer Scenarios . . . . . . . . . . . . . . . . . . . . . .61 3.2.5 Endpoint Behavior in H.450.2 Supervised Call Transfer . . . . . . . . . . . . . . . . . . . .66 3.2.6 Successful H.450.2 Supervised Call Transfer Scenario . . . . . . . .
Summary of the content on the page No. 5
Contents 4.6.1 Enabling and Disabling Unsolicited Notification Events . . . . . . . . . . . . . . . . . . . 154 4.6.2 Getting Media Streaming Status and Connection Information . . . . . . . . . . . . . . 155 4.6.3 Getting Notification of Underlying Protocol State Changes . . . . . . . . . . . . . . . . 157 4.7 Modifying an Existing SIP Call via re-INVITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 4.7.1 Overview of the SIP re-INVITE Method . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
Contents 4.15.5 Sending NOTIFY Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231 4.15.6 Receiving Responses to NOTIFY Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . .234 4.15.7 Receiving NOTIFY Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235 4.15.8 Responding to NOTIFY Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235 4.16 Handling DTMF. . . . . . . . . . . . .
Summary of the content on the page No. 7
Contents 4.26.2 Specifying Manual Operating Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 4.26.3 Initiating a Switch from Audio to T.38 Fax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 4.26.4 Associating a T.38 Fax Device with a Media Device When a Fax Request is Received. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 4.26.5 Accepting/Rejecting a Request to Switch Between Audio and
Summary of the content on the page No. 8
Contents 7.2 Configuring the Logging Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .378 7.2.1 Configuration File Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .378 7.2.2 Configuring the gc_h3r Logging Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .379 7.2.3 Configuring SIP Stack Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .382 7.2.4 Configuring H.3
Summary of the content on the page No. 9
Contents 8.3.28 gc_Stop( ) Variances for IP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 8.3.29 gc_UnListen( ) Variances for IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 ® 8.4 Dialogic Global Call API States Supported by IP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 ® 8.5 Dialogic Global Call API Events Supported by IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 9 IP-Specific Paramet
Summary of the content on the page No. 10
Contents IP_REGISTER_ADDRESS – gatekeeper registration information. . . . . . . . . . . . . . . . . .550 IP_TUNNELPROTOCOL_ALTID – TSM protocol alternate ID. . . . . . . . . . . . . . . . . . . . .551 IP_TUNNELPROTOCOL_OBJECTID – tunneled signaling protocol object ID . . . . . . . .552 IP_VIRTBOARD – information about an IPT board device . . . . . . . . . . . . . . . . . . . . . . .553 IPCCLIB_START_DATA – IP call control library configuration information . . . . . . . . . . .558 REQUEST_ERROR –
Summary of the content on the page No. 11
Contents Figures 1 Typical H.323 Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 2 H.323 Protocol Stack. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 3 Basic H.323 Network with a Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 4 Basic SIP Call Scenario. . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 12
Contents 39 SIP Call Transfer Failure - Party C is Busy When Transfer Attempted . . . . . . . . . . . . . . . . . . .96 40 Sending T.38 Fax in an Established Audio Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98 41 Receiving T.38 Fax in an Established Audio Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100 42 Sending T.38 Fax Without an Established Audio Session . . . . . . . . . . . . . . . . . . . . . . . . . . . .101 43 Receiving T.38 Fax Wi
Summary of the content on the page No. 13
Contents Tables 1 Summary of Call-Related Information that can be Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 2 Coders Supported for Dialogic® Host Media Processing (HMP) Software . . . . . . . . . . . . . . . 127 3 Capabilities Set by Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 4 Retrievable Call Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 14
Contents 42 Summary of Parameter Sets and Parameter Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .499 43 GCSET_CALL_CONFIG Parameter Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .511 44 IPSET_CALLINFO Parameter Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .512 45 IPSET_CONFERENCE Parameter Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .514 46 IPSE
Summary of the content on the page No. 15
Revision History This revision history summarizes the changes made in each published version of this document. Document No. Publication Date Description of Revisions 05-2239-009 November 2007 Made global changes to reflect Dialogic brand. 05-2239-008 August 2006 Setting Coder Information: Added G.726 coder info SIP Rejection Responses: New section Using H.323 Annex M Tunneled Signaling Messages: Revised entire section for updated implementation of feature Retrieving User-to-User Information
Summary of the content on the page No. 16
Revision History Document No. Publication Date Description of Revisions 05-2239-007 Retrieving SIP Message Header Fields section: Added note on truncation of too-long (continued) header fields Sending Nonstandard Protocol Messages (H.323): Updated for NS data >255 bytes Using MIME Bodies in SIP Messages (SIP-T) section: Updated for MIME header field parameters >255 bytes Using H.323 Annex M Tunneled Signaling Messages section: Updated for NS data >255 bytes. Updated defines for object IDs. R
Summary of the content on the page No. 17
Revision History Document No. Publication Date Description of Revisions 05-2239-006 August 2005 Call Control Library Initialization section: Expanded information on items that can be configured, including 3PCC mode Fast Start and Slow Start Call Setup section: Added subsections with H.323 and SIP specifics and notes on non-support in 3PCC mode H.323 Fast Start with Optional H.245 Channel: new section Summary of Call-Related Information that can be Set table: Added DiffServ field Specifying Tra
Summary of the content on the page No. 18
Revision History Document No. Publication Date Description of Revisions 05-2239-005 April 2005 Call Control Library Initialization section: Added more detail about how to set configuration items before calling gc_Start( ) Setting and Retrieving SIP Message Header Fields section: Rewritten to document generic access mechanism and long header support Sending OPTIONS Requests section: added note on inclusion of MIME SDP body Responding to OPTIONS Requests section: Added information about automat
Summary of the content on the page No. 19
Revision History Document No. Publication Date Description of Revisions 05-2239-005 IPSET_TUNNELEDSIGNALMSG parameter set: New section (continued) GC_PARM_DATA_EXT data structure: New section IP_AUTHENTICATION data structure: New section IP_TUNNELPROTOCOL_ALTID data structure: New section IP_VIRTBOARD data structure: Added new h323_msginfo_mask value for Annex M tunneled signaling messages. Added sip_registration_registrar field. IPCCLIB_START_DATA data structure: Added max_parm_data_size field
Summary of the content on the page No. 20
Revision History Document No. Publication Date Description of Revisions 05-2239-004 Host LAN Disconnection Alarms: New section and subsection (continued) Debugging Global Call IP Applications chapter : Completely rewritten to describe new RTF logging facilities gc_AcceptInitXfer( ) Variances for IP section: Added SIP variances gc_AcceptXfer( ) Variances for IP section: Added SIP variances gc_Extension( ) Variances for IP section: Added IPEXTID_MSGINFO entry and added SIP message type in entrie
