1、 ETSI ES 202 915-6 V1.4.1 (2006-12)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 6: Mobility SCF(Parlay 4)floppy3 ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 2 Reference RES/TISPAN-01028-06-OSA Keywords API, IDL, OSA, UML ETSI 650 Route des Lucioles F-06921 Sophia
2、Antipolis 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 p
3、resent 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 print
4、ers of 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
5、/status/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 restr
6、iction extend to reproduction in all media. European Telecommunications Standards Institute 2006. The Parlay Group 2006. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo are Trade Marks currently being
7、registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 3 Contents Intellectual Property Rights7 Foreword.7 1 Scope 8 2 References 8 3 Definitions and
8、abbreviations.8 3.1 Definitions8 3.2 Abbreviations .8 4 Mobility SCF9 4.1 General requirements on support of methods.9 5 Sequence Diagrams 9 5.1 User Location Sequence Diagrams.9 5.1.1 User Location Interrogation - Triggered Request .9 5.1.2 User Location Interrogation - Periodic Request11 5.1.3 Use
9、r Location Interrogation - Interactive Request12 5.2 User Location Camel Sequence Diagrams .13 5.2.1 User Location Camel Interrogation - Triggered Request13 5.2.2 User Location Camel Interrogation - Periodic Request 14 5.2.3 User Location Camel Interrogation - Interactive Request 15 5.3 User Locatio
10、n Emergency Sequence Diagrams .16 5.3.1 Subscription and Network Induced Location Reports 16 5.3.2 Network Induced Location Reports 17 5.3.3 Interactive Location Request 17 5.4 User Status Sequence Diagrams.18 5.4.1 Triggered Reporting18 5.4.2 Interactive Request .19 6 Class Diagrams.19 6.1 User Loc
11、ation Class Diagrams .19 6.2 User Location Camel Class Diagrams21 6.3 User Location Emergency Class Diagrams 22 6.4 User Status Class Diagrams23 7 The Service Interface Specifications23 7.1 Interface Specification Format .23 7.1.1 Interface Class 23 7.1.2 Method descriptions24 7.1.3 Parameter descri
12、ptions24 7.1.4 State Model.24 7.2 Base Interface.24 7.2.1 Interface Class IpInterface 24 7.3 Service Interfaces .24 7.3.1 Overview 24 7.4 Generic Service Interface .25 7.4.1 Interface Class IpService 25 7.4.1.1 Method setCallback()25 7.4.1.2 Method setCallbackWithSessionID()25 8 Mobility Interface C
13、lasses26 8.1 User Location Interface Classes .26 8.1.1 Interface Class IpUserLocation.26 8.1.1.1 Method locationReportReq().26 8.1.1.2 Method extendedLocationReportReq().27 8.1.1.3 Method periodicLocationReportingStartReq()27 8.1.1.4 Method periodicLocationReportingStop() 28 ETSI ETSI ES 202 915-6 V
14、1.4.1 (2006-12) 4 8.1.2 Interface Class IpAppUserLocation29 8.1.2.1 Method locationReportRes().29 8.1.2.2 Method locationReportErr()29 8.1.2.3 Method extendedLocationReportRes() .30 8.1.2.4 Method extendedLocationReportErr() 30 8.1.2.5 Method periodicLocationReport().30 8.1.2.6 Method periodicLocati
15、onReportErr()30 8.1.3 Interface Class IpTriggeredUserLocation.31 8.1.3.1 Method triggeredLocationReportingStartReq() 31 8.1.3.2 Method triggeredLocationReportingStop().32 8.1.4 Interface Class IpAppTriggeredUserLocation 32 8.1.4.1 Method triggeredLocationReport() .32 8.1.4.2 Method triggeredLocation
16、ReportErr() 33 8.2 User Location Camel Interface Classes33 8.2.1 Interface Class IpUserLocationCamel 33 8.2.1.1 Method locationReportReq().34 8.2.1.2 Method periodicLocationReportingStartReq()34 8.2.1.3 Method periodicLocationReportingStop() 35 8.2.1.4 Method triggeredLocationReportingStartReq() 35
17、8.2.1.5 Method triggeredLocationReportingStop().35 8.2.2 Interface Class IpAppUserLocationCamel .36 8.2.2.1 Method locationReportRes().36 8.2.2.2 Method locationReportErr()36 8.2.2.3 Method periodicLocationReport().37 8.2.2.4 Method periodicLocationReportErr()37 8.2.2.5 Method triggeredLocationRepor
18、t() .37 8.2.2.6 Method triggeredLocationReportErr() 37 8.3 User Location Emergency Interface Classes 38 8.3.1 Interface Class IpUserLocationEmergency 38 8.3.1.1 Method emergencyLocationReportReq()38 8.3.1.2 Method subscribeEmergencyLocationReports().39 8.3.1.3 Method unSubscribeEmergencyLocationRepo
19、rts() 39 8.3.2 Interface Class IpAppUserLocationEmergency39 8.3.2.1 Method emergencyLocationReport() 40 8.3.2.2 Method emergencyLocationReportErr() .40 8.4 User Status Interface Classes40 8.4.1 Interface Class IpAppUserStatus 41 8.4.1.1 Method statusReportRes().41 8.4.1.2 Method statusReportErr()41
20、8.4.1.3 Method triggeredStatusReport()42 8.4.1.4 Method triggeredStatusReportErr().42 8.4.2 Interface Class IpUserStatus.42 8.4.2.1 Method statusReportReq() 43 8.4.2.2 Method triggeredStatusReportingStartReq().43 8.4.2.3 Method triggeredStatusReportingStop() .43 9 State Transition Diagrams44 9.1 Use
21、r Location .44 9.2 User Location Camel44 9.2.1 State Transition Diagrams for IpUserLocationCamel.44 9.2.1.1 Active State.44 9.3 User Location Emergency 45 9.4 User Status45 9.4.1 State Transition Diagrams for IpUserStatus .45 9.4.1.1 Active State.45 10 Service Properties.45 10.1 Mobility Properties.
22、45 10.1.1 Emergency Application Subtypes.45 10.1.2 Value Added Application Subtypes46 10.1.3 PLMN Operator Application Subtypes.46 10.1.4 Lawful Intercept Application Subtypes 46 ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 5 10.1.5 Altitude Obtainable.46 10.1.6 Location Methods .47 10.1.7 Priorities47 1
23、0.1.8 Max Interactive Requests47 10.1.9 Max Triggered Users 47 10.1.10 Max Periodic Users.47 10.1.11 Min Periodic Interval Duration.47 10.1.12 Initial Report.47 10.2 User Location Service Properties .48 10.3 User Location Camel Service Properties48 10.4 User Location Emergency Service Properties 49
24、10.5 User Status Service Properties49 11 Data Definitions .49 11.1 Common Mobility Data Definitions.49 11.1.1 TpGeographicalPosition .49 11.1.2 TpLocationPriority51 11.1.3 TpLocationRequest.51 11.1.4 TpLocationResponseIndicator 51 11.1.5 TpLocationResponseTime 51 11.1.6 TpLocationType .51 11.1.7 TpL
25、ocationUncertaintyShape .52 11.1.8 TpMobilityDiagnostic.52 11.1.9 TpMobilityError .53 11.1.10 TpMobilityStopAssignmentData 53 11.1.11 TpMobilityStopScope.53 11.1.12 TpTerminalType .53 11.2 User Location Data Definitions54 11.2.1 IpUserLocation .54 11.2.2 IpUserLocationRef54 11.2.3 IpAppUserLocation
26、54 11.2.4 IpAppUserLocationRef.54 11.2.5 IpTriggeredUserLocation54 11.2.6 IpTriggeredUserLocationRef54 11.2.7 IpAppTriggeredUserLocation.54 11.2.8 IpAppTriggeredUserLocationRef .54 11.2.9 TpUlExtendedData .54 11.2.10 TpUlExtendedDataSet 54 11.2.11 TpUserLocationExtended .55 11.2.12 TpUserLocationExt
27、endedSet 55 11.2.13 TpLocationTrigger55 11.2.14 TpLocationTriggerSet.55 11.2.15 TpLocationTriggerCriteria55 11.2.16 TpUserLocation 56 11.2.17 TpUserLocationSet .56 11.3 User Location Camel Data Definitions 56 11.3.1 IpUserLocationCamel.56 11.3.2 IpUserLocationCamelRef .56 11.3.3 IpAppUserLocationCam
28、el 56 11.3.4 IpAppUserLocationCamelRef 56 11.3.5 TpLocationCellIDOrLAI 56 11.3.6 TpLocationTriggerCamel .57 11.3.7 TpUserLocationCamel57 11.3.8 TpUserLocationCamelSet.57 11.4 User Location Emergency Data Definitions.57 11.4.1 IpUserLocationEmergency .57 11.4.2 IpUserLocationEmergencyRef .57 11.4.3 I
29、pAppUserLocationEmergency 57 11.4.4 IpAppUserLocationEmergencyRef.58 11.4.5 TpIMEI .58 11.4.6 TpNaESRD.58 11.4.7 TpNaESRK.58 ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 6 11.4.8 TpUserLocationEmergencyRequest .58 11.4.9 TpUserLocationEmergency 59 11.4.10 TpUserLocationEmergencyTrigger 59 11.5 User Statu
30、s Data Definitions 59 11.5.1 IpUserStatus59 11.5.2 IpUserStatusRef59 11.5.3 IpAppUserStatus.59 11.5.4 IpAppUserStatusRef .59 11.5.5 TpUserStatus.60 11.5.6 TpUserStatusSet .60 11.5.7 TpUserStatusIndicator 60 11.6 Units and Validations of Parameters 60 12 Exception Classes.61 Annex A (normative): OMG
31、IDL Description of Mobility SCF 62 Annex B (informative): W3C WSDL Description of Mobility SCF.63 Annex C (informative): Java API Description of the Mobility SCFs 64 Annex D (informative): Contents of 3GPP OSA R5 Mobility 65 Annex E (informative): Record of changes 66 E.1 Interfaces 66 E.1.1 New 66
32、E.1.2 Deprecated66 E.1.3 Removed.66 E.2 Methods67 E.2.1 New 67 E.2.2 Deprecated67 E.2.3 Modified.67 E.2.4 Removed.68 E.3 Data Definitions .69 E.3.1 New 69 E.3.2 Modified.69 E.3.3 Removed.69 E.4 Service Properties.70 E.4.1 New 70 E.4.2 Deprecated70 E.4.3 Modified.70 E.4.4 Removed.70 E.5 Exceptions 71
33、 E.5.1 New 71 E.5.2 Modified.71 E.5.3 Removed.71 E.6 Others .71 History 72 ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 7 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
34、, is publicly available for ETSI members and non-members, 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
35、 the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). 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) wh
36、ich are, or may be, or may become, essential to the present document. Foreword This ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet converged Services and Protocols for Advanced Networking (TISPAN). The present document is part 6 of a multi-part deliv
37、erable covering Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (ES 202 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Framework“; Part 4: “Call Control“; Part 5: “User Interact
38、ion SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session Control SCF“; Part 9: “Generic Messaging SCF“; Part 10: “Connectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Charging SCF“; Part 13: “Policy Management SCF“; Part 14: “Presence and Availa
39、bility Management SCF“. The present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation with a number of JAIN Community (http:/ member companies. The present document forms part of the Parlay 4.3 set of specifications. A subset of the
40、 present document is in 3GPP TS 29.198-6 V5.8.0 (Release 5). ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 8 1 Scope The present document is part 6 of the Stage 3 specification for an Application Programming Interface (API) for Open Service Access (OSA). The OSA specifications define an architecture that
41、enables application developers to make use of network functionality through an open standardised interface, i.e. the OSA APIs. The present document specifies the Mobility Service Capability Feature (SCF) aspects of the interface. All aspects of the Mobility SCF are defined here, these being: Sequenc
42、e Diagrams. Class Diagrams. Interface specification plus detailed method descriptions. State Transition diagrams. Data Definitions. IDL Description of the interfaces. WSDL Description of the interfaces. Reference to the Java API description of the interfaces. The process by which this task is accomp
43、lished is through the use of object modelling techniques described by the Unified Modelling Language (UML). 2 References The references listed in clause 2 of ES 202 915-1 contain provisions which, through reference in this text, constitute provisions of the present document. ETSI ES 202 915-1: “Open
44、 Service Access (OSA); Application Programming Interface (API); Part 1: Overview (Parlay 4)“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in ES 202 915-1 apply. 3.2 Abbreviations For the purposes of the present document, t
45、he abbreviations defined in ES 202 915-1 apply. ETSI ETSI ES 202 915-6 V1.4.1 (2006-12) 9 4 Mobility SCF The following clauses describe each aspect of the Mobility Service Capability Feature (SCF). The order is as follows: The Sequence diagrams give the reader a practical idea of how each of the SCF
46、s is implemented. The Class relationships clause show how each of the interfaces applicable to the SCF, relate to one another. The Interface specification clause describes in detail each of the interfaces shown within the Class diagram part. The State Transition Diagrams (STD) show the transition be
47、tween states in the SCF. The states and transitions are well-defined; either methods specified in the Interface specification or events occurring in the underlying networks cause state transitions. The Data Definitions clause show a detailed expansion of each of the data types associated with the me
48、thods within the classes. Note that some data types are used in other methods and classes and are therefore defined within the Common Data types part ES 202 915-2. 4.1 General requirements on support of methods An implementation of this API which supports or implements a method described in the pres
49、ent document, shall support or implement the functionality described for that method, for at least one valid set of values for the parameters of that method. Where a method is not supported by an implementation of a Service interface, the exception P_METHOD_NOT_SUPPORTED shall be returned to any call of that method. Where a method is not supported by an implementation of an Application interface, a call to that method shall be possible, and no exception shall be returned. 5 Sequence Diagrams 5.1 User Location Sequen
