1、 ETSI TR 129 998-4-1 V8.0.0 (2009-01)Technical Report Digital cellular telecommunications system (Phase 2+);Universal Mobile Telecommunications System (UMTS);Open Service Access (OSA) Application ProgrammingInterface (API) Mapping for Open Service Access;Part 4: Call Control Service Mapping;Subpart
2、1: API to CAP Mapping (3GPP TR 29.998-04-1 version 8.0.0 Release 8)GLOBAL SYSTEM FOR MOBILE COMMUNICATIONSRETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 1 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Reference RTR/TSGC-0029998-04-1v800 Keywords GSM, UMTS ETSI 650 Route des Lucioles F-06921 Sophia Antipol
3、is Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present
4、document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of
5、the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status
6、/status.asp If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction
7、extend to reproduction in all media. European Telecommunications Standards Institute 2009. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for th
8、e benefit of its Members and of the 3GPP Organizational Partners. LTE is a Trade Mark of ETSI currently being registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks registered and owned by the GSM Association. ETSI ETSI TR 129 998-4-1
9、V8.0.0 (2009-01) 2 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-membe
10、rs, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.a
11、sp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the pr
12、esent document. Foreword This Technical Report (TR) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be interpreted as being referenc
13、es to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi.org/key/queryform.asp. ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 3 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Contents Intellectual Property Rights2 Forewo
14、rd.2 Foreword.4 Introduction 4 1 Scope 5 2 References 5 3 Definitions and abbreviations.6 3.1 Definitions6 3.2 Abbreviations .6 4 Generic Call Control CAMEL Call Flows.6 4.1 Call Control Manager.6 4.1.1 enableCallNotification6 4.1.2 disableCallNotification .7 4.1.3 changeCallNotification .8 4.1.4 ge
15、tCriteria .9 4.1.5 setCallLoadControl.9 4.1.6 callNotificationInterrupted10 4.1.7 callNotificationContinued.11 4.1.8 callAborted .11 4.1.9 callEventNotify.12 4.2 Call .14 4.2.1 routeReq14 4.2.2 routeRes 18 4.2.3 routeErr.19 4.2.4 release .20 4.2.5 deassignCall21 4.2.6 getCallInfoReq21 4.2.7 getCallI
16、nfoRes 22 4.2.8 getCallInfoErr.23 4.2.9 superviseCallReq 24 4.2.10 superviseCallRes.24 4.2.11 superviseCallErr .25 4.2.12 setAdviceOfCharge.26 4.2.13 setCallChargePlan.27 4.2.14 callFaultDetected 28 4.2.15 callEnded 28 5 Detailed Parameter Mappings 29 5.1 TpCallMonitorMode 29 5.2 TpCallReportType30
17、5.3 TpCallEventName30 5.4 TpCallAdditionalReportInfo 31 Annex A: Change history 32 History 33 ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 4 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Foreword This Technical Report has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the
18、present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows: Version
19、x.y.z where: x the first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third
20、digit is incremented when editorial only changes have been incorporated in the document. Introduction Structure of the OSA API Mapping (3GPP TR 29.998) The present document is part 4 subpart 1 of a multi-part deliverable covering the Open Service Access (OSA); Application Programming Interface (API)
21、 Mapping for OSA. Table: Overview of the OSA APIs Application Programming Interface (API); Part 1: Overview“. 2 3GPP TS 22.127: “Service Requirement for the Open Service Access (OSA); Stage 1“. 3 3GPP TS 23.198: “Open Service Access (OSA); Stage 2“. 4 3GPP TR 21.905: “Vocabulary for 3GPP Specificati
22、ons“. 5 3GPP TS 29.198-4-1/5: “Open Service Access (OSA); Application Programming Interface (API); Part 4: Call control; Sub-part 1: Call Control Common Definitions“. Sub-part 2: Generic Call Control SCF“. Sub-part 3: “Multi-Party Call Control SCF“. Sub-part 4: “Multi-Media Call Control SCF“. Sub-pa
23、rt 5: “Conference call control SCF“. 6 3GPP TS 29.002: “Mobile Application Part (MAP) specification“. 7 3GPP TS 29.078: “Customised Applications for Mobile network Enhanced Logic (CAMEL); CAMEL Application Part (CAP) specification“. 8 3GPP TS 22.101: “Service Aspects; Service Principles“. 9 ITU-T Re
24、commendation Q.850: “Usage of cause and location in the Digital Subscriber Signalling System No. 1 and the Signalling System No. 7 ISDN User Part“. 10 3GPP TR 29.998-1: “Open Service Access (OSA); Application Programming Interface (API) Mapping for OSA; Part 1: General Issues on API Mapping“. ETSI E
25、TSI TR 129 998-4-1 V8.0.0 (2009-01) 6 3GPP TR 29.998-04-1 version 8.0.0 Release 8 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in TS 29.198-1 1 apply. 3.2 Abbreviations For the purposes of the present document, the abbrevia
26、tions given in TS 29.198-1 1 apply. 4 Generic Call Control CAMEL Call Flows 4.1 Call Control Manager The generic call manager interface class provides the management functions to the generic call SCFs. The application programmer can use this interface to create call objects and to enable or disable
27、call-related event notifications. 4.1.1 enableCallNotification enableCallNotification is used to enable call notifications to be sent to the application. HLRgsmSCFSCS ApplicationenableCallNotificationMAP AnyTimeModificationFigure 4-1: Call Flow for enableCallNotification Two alternatives have been i
28、dentified. 1. The application requests notifications to be enabled (see table 4-1). 2. HLR rejects CSI updates (see table 4-2). Table 4-1: Normal Operation Pre-conditions An agreement is established between the network operator and the service provider for the event notification to be enabled 1 The
29、application invokes the enableCallNotification method 2 The gsmSCF sends a MAP AnyTimeModification to the HLR in order to Activate the necessary CAMEL Subscription Information (O-CSI, D-CSI, T-CSI, VT-CSI). NOTE: CAMEL phase 3 only allows for activation/deactivation of the CSI and not modification o
30、f the contents of the CSIs. The O-CSI and D-CSI will be activated if the originating address is present and the T-CSI and VT-CSI will be activated if the destination address is present. ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 7 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Table 4-2: Error condition
31、 Pre-conditions gsmSCF had previously sent a MAP AnyTimeModification message to the HLR as a result of an enableCallNotification request from the application 1 HLR rejects the request to update the CSI 2 The gsmSCF sends an internal message to the SCS to indicate the up date failure 3 The SCS invoke
32、s the exception on enableCallNotification Table 4-3: Parameter Mapping From: enableCallNotification To: MAP AnyTimeModification appInterface eventCriteria (TpCallEventCriteria) : DestinationAddress subscriberIdentity (see note) modificationRequestFor-CSI OriginationAddress subscriberIdentity (see No
33、te) modificationRequestFor-CSI CallEventName (TpCallEventName) CAMEL Subscription Information: - T-CSI; - VT-CSI; - O-CSI; - D-CSI. CallNotificationType assignmentID modificationRequestFor-SS-Info gsmSCF address NOTE: In case an address range is used, a separate MAP AnyTimeModificationRequest shall
34、be sent for every address in the range. 4.1.2 disableCallNotification disableCallNotification is used by the application to disable call notifications. HLR ApplicationdisableCallNotificationMAP AnyTimeModificationRequestgsmSCFSCSFigure 4-2: Call Flow for disableCallNotification Table 4-4: Normal Ope
35、ration Pre-conditions An agreement is established between the network operator and the service provider for the event notification to be disabled 1 The application invokes the disableCallNotification method 2 The gsmSCF sends a MAP AnyTimeModification to the HLR in order to de-activate the CAMEL sub
36、scription Information (O-CSI, D-CSI, T-CSI, VT-CSI). NOTE: CAMEL Phase 3 only allows the capability to activate/deactivate CSI and not to modify the triggering information. The O-CSI and D-CSI will be deactivated if the originating address is present and the T-CSI and VT-CSI will be deactivated if t
37、he destination address is present. ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 8 3GPP TR 29.998-04-1 version 8.0.0 Release 8 Table 4-5: Parameter Mapping From: disableCallNotification To: MAP AnyTimeModification assignmentID gsmSCFAddress 4.1.3 changeCallNotification changeCallNotification is used by
38、the application to change the call notifications previously set by enableCallNotification(). HLR ApplicationchangeCallNotificationMAP AnyTimeModificationgsmSCF SCSFigure 4-3: Call Flow for changeCallNotification Table 4-6: Normal Operation Pre-conditions Notifications have been enabled by the applic
39、ation. 1 The application invokes the changeCallNotification method 2 The gsmSCF sends a MAP AnyTimeModification to the HLR in order to active and de-activate the CAMEL subscription Information (O-CSI, T-CSI, VT-CSI). The SCS and gsmSCF will have to determine which CSIs to active and which to de-acti
40、vate in order to reflect the changed set of notifications. The O-CSI and D-CSI will be modified if the originating address is present and the T-CSI and VT-CSI will be modified if the destination address is present Table 4-7: Parameter Mapping From: changeCallNotification To: MAP AnyTimeModification
41、assignmentID eventCriteria (TpCallEventCriteria): DestinationAddress subscriberIdentity (see note) modificationRequestFor-CSI OriginationAddress subscriberIdentity (see note) modificationRequestFor-CSI CallEventName (TpCallEventName) CAMEL Subscription Information: - T-CSI; - VT-CSI; - O-CSI; - D-CS
42、I. CallNotificationType modificationRequestFor-SS-Info gsmSCFAddress NOTE: In case an address range is used, a separate MAP AnyTimeModificationRequest shall be sent for every address in the range ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 9 3GPP TR 29.998-04-1 version 8.0.0 Release 8 4.1.4 getCriteri
43、a getCriteria is used by the application to query the event criteria set with enableCallNotification. HLR ApplicationgetCriteriagsmSCFSCSNo appropriate CAP orMAP messageFigure 4-4: Call Flow for getCriteria Table 4-8: Normal Operation Pre-conditions Notifications have been enabled by the application
44、 1 The application invokes the getCriteria method 2 The SCS returns the criteria Parameter Mapping None. 4.1.5 setCallLoadControl setCallLoadControl is a method used to control the number of invoked methods i.e. to restrict the load placed on the application server. gsmSCF SCS ApplicationCAP CallGap
45、setCallLoadControlCAP CallGapgsmSSFFigure 4-5: Call Flow for release Table 4-9: Normal Operation Pre-conditions Call Control Manager is in active state 1 The application invokes the setCallLoadControl method 2 The SCS sends an equivalent message to the gsmSCF 3 The gsmSCF may invoke the CAP CallGap
46、operations towards different gsmSSFs. CallGap can be sent in CAP only after the dialogue has been opened first by sending InitialDP. ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 103GPP TR 29.998-04-1 version 8.0.0 Release 8 Table 4-10: Parameter Mapping From: setCallLoadControl To: CAP CallGap duration
47、 gapIndicators duration mechanism callLoadControlPerInterval gapIndicators gapInterval treatment ReleaseCause AdditionalTreatmentInfo InformationToSend gapTreatment ReleaseCause InformationToSend addressRange gapCriteria basicGapCriteria calledAddressValue assignmentID 4.1.6 callNotificationInterrup
48、ted callNotificationInterrupted indicates to the application that all event notifications have been interrupted, for example due to faults detected. HLR gsmSCF SCS ApplicationcallNotificationInterruptedNo appropriate MAP or CAPmessageFigure 4-6: Call Flow for callNotificationInterrupted Table 4-11:
49、Normal Operation Pre-conditions Call notifications have been enabled using the enableNotification method on the Call Manager interface 1 The SCS has detected, or has been informed of, a fault which prevents further events from being notified 2 The SCS invokes the callNotificationInterrupted method Parameter Mapping None. ETSI ETSI TR 129 998-4-1 V8.0.0 (2009-01) 113GPP TR 29.998-04-1 version 8.0.0 Release 8 4.1.7 callNotificationContinued callNotificationContinued indicates to the application that all event notifications have been previously interrupted,
