Tech-
invite
3GPP
space
IETF
space
21
22
23
24
25
26
27
28
29
31
32
33
34
35
36
37
38
4‑5x
TS 29.198-06
Open Service Access (OSA) API –
Part 6: Mobility Service Capability Feature (SCF)
3GPP‑Page
ETSI‑search
ToC
↓
V9.0.0 (PDF)
2009/12 87 p.
V8.0.0
2008/06 87 p.
V7.0.0
2007/03 78 p.
V6.6.1
2006/07 77 p.
V5.8.0
2005/12 63 p.
V4.6.0
2005/12 67 p.
Rapporteur:
Mr. Unmehopa, Musa
full Table of Contents for
TS 29.198-06
Word version: 9.0.0
0
Introduction
p. 8
1
Scope
p. 10
2
References
p. 10
3
Definitions and abbreviations
p. 11
3.1
Definitions
p. 11
3.2
Abbreviations
p. 11
4
Mobility SCF
p. 11
4.1
General requirements on support of methods
p. 11
5
Sequence Diagrams
p. 11
5.1
User Location Sequence Diagrams
p. 11
5.1.1
User Location Interrogation - Triggered Request
p. 11
5.1.2
User Location Interrogation - Periodic Request
p. 12
5.1.3
User Location Interrogation - Interactive Request
p. 13
5.2
User Location Camel Sequence Diagrams
p. 14
5.2.1
User Location Camel Interrogation - Triggered Request
p. 14
5.2.2
User Location Camel Interrogation - Periodic Request
p. 15
5.2.3
User Location Camel Interrogation - Interactive Request
p. 16
5.3
User Location Emergency Sequence Diagrams
p. 17
5.3.1
Subscription and Network Induced Location Reports
p. 17
5.3.2
Network Induced Location Reports
p. 18
5.3.3
Interactive Location Request
p. 19
5.4
User Status Sequence Diagrams
p. 19
5.4.1
Triggered Reporting
p. 19
5.4.2
Interactive Request
p. 20
5.5
User Binding Sequence Diagrams
p. 21
5.5.1
Subscription and Binding Request Notifications
p. 21
6
Class Diagrams
p. 22
6.1
User Location Class Diagrams
p. 22
6.2
User Location Camel Class Diagrams
p. 24
6.3
User Location Emergency Class Diagrams
p. 24
6.4
User Status Class Diagrams
p. 25
6.5
User Binding Class Diagrams
p. 26
7
The Service Interface Specifications
p. 27
7.1
Interface Specification Format
p. 27
7.1.1
Interface Class
p. 27
7.1.2
Method descriptions
p. 28
7.1.3
Parameter descriptions
p. 28
7.1.4
State Model
p. 28
7.2
Base Interface
p. 28
7.2.1
Interface Class IpInterface
p. 28
7.3
Service Interfaces
p. 28
7.3.1
Overview
p. 28
7.4
Generic Service Interface
p. 28
7.4.1
Interface Class IpService
p. 28
7.4.1.1
Method setCallback()
p. 29
7.4.1.2
Method setCallbackWithSessionID()
p. 29
8
Mobility Interface Classes
p. 30
8.1
User Location Interface Classes
p. 30
8.1.1
Interface Class IpUserLocation
p. 30
8.1.1.1
Method locationReportReq()
p. 30
8.1.1.2
Method extendedLocationReportReq()
p. 31
8.1.1.3
Method periodicLocationReportingStartReq()
p. 31
8.1.1.4
Method periodicLocationReportingStop()
p. 32
8.1.1.5
Method getNextPeriodicLocationRequest()
p. 32
8.1.2
Interface Class IpAppUserLocation
p. 33
8.1.2.1
Method locationReportRes()
p. 33
8.1.2.2
Method locationReportErr()
p. 34
8.1.2.3
Method extendedLocationReportRes()
p. 34
8.1.2.4
Method extendedLocationReportErr()
p. 34
8.1.2.5
Method periodicLocationReport()
p. 35
8.1.2.6
Method periodicLocationReportErr()
p. 35
8.1.3
Interface Class IpTriggeredUserLocation
p. 35
8.1.3.1
Method triggeredLocationReportingStartReq()
p. 36
8.1.3.2
Method triggeredLocationReportingStop()
p. 36
8.1.3.3
Method getNextTriggeredLocationRequest()
p. 37
8.1.4
Interface Class IpAppTriggeredUserLocation
p. 37
8.1.4.1
Method triggeredLocationReport()
p. 38
8.1.4.2
Method triggeredLocationReportErr()
p. 38
8.1.4.3
Method triggeredReportingEnded()
p. 38
8.2
User Location Camel Interface Classes
p. 39
8.2.1
Interface Class IpUserLocationCamel
p. 39
8.2.1.1
Method locationReportReq()
p. 39
8.2.1.2
Method periodicLocationReportingStartReq()
p. 40
8.2.1.3
Method periodicLocationReportingStop()
p. 40
8.2.1.4
Method triggeredLocationReportingStartReq()
p. 41
8.2.1.5
Method triggeredLocationReportingStop()
p. 41
8.2.1.6
Method getNextPeriodicLocationRequest()
p. 42
8.2.1.7
Method getNextTriggeredLocationRequest()
p. 42
8.2.2
Interface Class IpAppUserLocationCamel
p. 43
8.2.2.1
Method locationReportRes()
p. 43
8.2.2.2
Method locationReportErr()
p. 44
8.2.2.3
Method periodicLocationReport()
p. 44
8.2.2.4
Method periodicLocationReportErr()
p. 44
8.2.2.5
Method triggeredLocationReport()
p. 44
8.2.2.6
Method triggeredLocationReportErr()
p. 45
8.2.2.7
Method triggeredReportingEnded()
p. 45
8.3
User Location Emergency Interface Classes
p. 45
8.3.1
Interface Class IpUserLocationEmergency
p. 45
8.3.1.1
Method emergencyLocationReportReq()
p. 46
8.3.1.2
Method subscribeEmergencyLocationReports()
p. 46
8.3.1.3
Method unSubscribeEmergencyLocationReports()
p. 47
8.3.2
Interface Class IpAppUserLocationEmergency
p. 47
8.3.2.1
Method emergencyLocationReport()
p. 47
8.3.2.2
Method emergencyLocationReportErr()
p. 47
8.4
User Status Interface Classes
p. 48
8.4.1
Interface Class IpAppUserStatus
p. 48
8.4.1.1
Method statusReportRes()
p. 49
8.4.1.2
Method statusReportErr()
p. 49
8.4.1.3
Method triggeredStatusReport()
p. 49
8.4.1.4
Method triggeredStatusReportErr()
p. 49
8.4.1.5
Method extendedStatusReportRes()
p. 50
8.4.1.6
Method extendedStatusReportErr()
p. 50
8.4.1.7
Method extTriggeredStatusReport()
p. 50
8.4.1.8
Method extTriggeredStatusReportErr()
p. 50
8.4.1.9
Method triggeredReportingEnded()
p. 51
8.4.2
Interface Class IpUserStatus
p. 51
8.4.2.1
Method statusReportReq()
p. 51
8.4.2.2
Method triggeredStatusReportingStartReq()
p. 52
8.4.2.3
Method triggeredStatusReportingStop()
p. 52
8.4.2.4
Method getNextTriggeredStatusRequest()
p. 53
8.4.2.5
Method extendedStatusReportReq()
p. 53
8.4.2.6
Method extTriggeredStatusReportingStartReq()
p. 54
8.4.2.7
Method extTriggeredStatusReportingStop()
p. 54
8.5
User Binding Interface Classes
p. 54
8.5.1
Interface Class IpUserBinding
p. 55
8.5.1.1
Method triggeredBindingRequestNotificationStartReq()
p. 55
8.5.1.2
Method triggeredBindingRequestNotificationStop()
p. 55
8.5.2
Interface Class IpAppUserBinding
p. 56
8.5.2.1
Method triggeredBindingRequestNotification()
p. 56
8.5.2.2
Method triggeredBindingRequestNotificationStartErr()
p. 56
9
State Transition Diagrams
p. 57
9.1
User Location
p. 57
9.2
User Location Camel
p. 57
9.2.1
State Transition Diagrams for IpUserLocationCamel
p. 57
9.2.1.1
Active State
p. 58
9.3
User Location Emergency
p. 58
9.4
User Status
p. 58
9.4.1
State Transition Diagrams for IpUserStatus
p. 58
9.4.1.1
Active State
p. 59
9.5
User Binding
p. 59
10
Service Properties
p. 59
10.1
Mobility Properties
p. 59
10.1.1
Emergency Application Subtypes
p. 59
10.1.2
Value Added Application Subtypes
p. 60
10.1.3
PLMN Operator Application Subtypes
p. 60
10.1.4
Lawful Intercept Application Subtypes
p. 60
10.1.5
Altitude Obtainable
p. 60
10.1.6
Location Methods
p. 60
10.1.7
Priorities
p. 61
10.1.8
Max Interactive Requests
p. 61
10.1.9
Max Triggered Users
p. 61
10.1.10
Max Periodic Users
p. 61
10.1.11
Min Periodic Interval Duration
p. 61
10.1.12
Initial Report
p. 61
10.1.13
Max Life Time
p. 61
10.2
User Location Service Properties
p. 61
10.3
User Location Camel Service Properties
p. 62
10.4
User Location Emergency Service Properties
p. 63
10.5
User Status Service Properties
p. 63
11
Data Definitions
p. 63
11.1
Common Mobility Data Definitions
p. 63
11.1.1
TpGeographicalPosition
p. 63
11.1.2
TpLocationPriority
p. 65
11.1.3
TpLocationRequest
p. 65
11.1.4
TpLocationResponseIndicator
p. 65
11.1.5
TpLocationResponseTime
p. 65
11.1.6
TpLocationType
p. 65
11.1.7
TpLocationUncertaintyShape
p. 66
11.1.8
TpMobilityDiagnostic
p. 66
11.1.9
TpMobilityError
p. 67
11.1.10
TpMobilityStopAssignmentData
p. 67
11.1.11
TpMobilityStopScope
p. 67
11.1.12
TpTerminalType
p. 67
11.2
User Location Data Definitions
p. 68
11.2.1
IpUserLocation
p. 68
11.2.2
IpUserLocationRef
p. 68
11.2.3
IpAppUserLocation
p. 68
11.2.4
IpAppUserLocationRef
p. 68
11.2.5
IpTriggeredUserLocation
p. 68
11.2.6
IpTriggeredUserLocationRef
p. 68
11.2.7
IpAppTriggeredUserLocation
p. 68
11.2.8
IpAppTriggeredUserLocationRef
p. 68
11.2.9
TpUlExtendedData
p. 68
11.2.10
TpUlExtendedDataSet
p. 68
11.2.11
TpUserLocationExtended
p. 69
11.2.12
TpUserLocationExtendedSet
p. 69
11.2.13
TpLocationTrigger
p. 69
11.2.14
TpLocationTriggerSet
p. 69
11.2.15
TpLocationTriggerCriteria
p. 69
11.2.16
TpUserLocation
p. 69
11.2.17
TpUserLocationSet
p. 70
11.2.18
TpTriggeredLocationRequestSetEntry
p. 70
11.2.19
TpTriggeredLocationRequestSet
p. 70
11.2.20
TpTriggeredLocationRequest
p. 70
11.2.21
TpPeriodicLocationRequestSetEntry
p. 70
11.2.22
TpPeriodicLocationRequestSet
p. 70
11.2.23
TpPeriodicLocationRequest
p. 70
11.3
User Location Camel Data Definitions
p. 71
11.3.1
IpUserLocationCamel
p. 71
11.3.2
IpUserLocationCamelRef
p. 71
11.3.3
IpAppUserLocationCamel
p. 71
11.3.4
IpAppUserLocationCamelRef
p. 71
11.3.5
TpLocationCellIDOrLAI
p. 71
11.3.6
TpLocationTriggerCamel
p. 71
11.3.7
TpUserLocationCamel
p. 72
11.3.8
TpUserLocationCamelSet
p. 72
11.4
User Location Emergency Data Definitions
p. 72
11.4.1
IpUserLocationEmergency
p. 72
11.4.2
IpUserLocationEmergencyRef
p. 72
11.4.3
IpAppUserLocationEmergency
p. 72
11.4.4
IpAppUserLocationEmergencyRef
p. 72
11.4.5
TpIMEI
p. 72
11.4.6
TpNaESRD
p. 72
11.4.7
TpNaESRK
p. 73
11.4.8
TpUserLocationEmergencyRequest
p. 73
11.4.9
TpUserLocationEmergency
p. 73
11.4.10
TpUserLocationEmergencyTrigger
p. 74
11.5
User Status Data Definitions
p. 74
11.5.1
IpUserStatus
p. 74
11.5.2
IpUserStatusRef
p. 74
11.5.3
IpAppUserStatus
p. 74
11.5.4
IpAppUserStatusRef
p. 74
11.5.5
TpUserStatus
p. 74
11.5.6
TpUserStatusSet
p. 74
11.5.7
TpUserStatusIndicator
p. 74
11.5.8
TpTriggeredStatusRequestSetEntry
p. 75
11.5.9
TpTriggeredStatusRequestSet
p. 75
11.5.10
TpTriggeredStatusRequest
p. 75
11.5.11
TpUserStatusExtended
p. 75
11.5.12
TpUserStatusExtendedSet
p. 75
11.5.13
TpUserStatusIndicatorExtended
p. 76
11.5.14
TpAuthStatusIndicator
p. 76
11.5.15
TpUserInfo
p. 76
11.5.16
TpNetworkStatusIndicator
p. 76
11.5.17
TpAccessTechnology
p. 76
11.5.18
TpRoamingStatus
p. 76
11.6
User Binding Data Definitions
p. 77
11.6.1
TpBindingSet
p. 77
11.6.2
TpBindingEntrySet
p. 77
11.6.3
TpBindingEntry
p. 77
11.6.4
TpBindingEntryType
p. 77
11.6.5
TpBindingNotificationCriteriaSet
p. 77
11.6.6
TpBindingNotificationCriteria
p. 78
11.6.7
TpBindingNotificationCriteriaType
p. 78
11.7
Units and Validations of Parameters
p. 78
12
Exception Classes
p. 79
A
(Normative) OMG IDL Description of Mobility SCF
p. 80
B
W3C WSDL Description of Mobility SCF
p. 81
C
Java API Description of the Mobility SCFs
p. 82
D
Description of Mobility SCF for 3GPP2 cdma2000 networks
p. 83
D.1
General Exceptions
p. 83
D.2
Specific Exceptions
p. 83
D.2.1
Clause 1: Scope
p. 83
D.2.2
Clause 2: References
p. 83
D.2.3
Clause 3: Definitions and abbreviations
p. 83
D.2.4
Clause 4: Mobility SCF
p. 83
D.2.5
Clause 5: Sequence Diagrams
p. 83
D.2.6
Clause 6 Class Diagrams
p. 84
D.2.7
Clause 7: The Service Interface Specifications
p. 84
D.2.8
Clause 8: Mobility Interface Classes
p. 84
D.2.9
Clause 9: State Transition Diagrams
p. 84
D.2.10
Clause 10: Service Properties
p. 84
D.2.11
Clause 11: Data Definitions
p. 84
D.2.12
Clause 12: Exception Classes
p. 84
D.2.13
Annex A (normative): OMG IDL Description of Mobility SCF
p. 84
D.2.14
Annex B (informative): W3C WSDL Description of Mobility SCF
p. 84
D.2.15
Annex C (informative): Java™ API Description of Mobility SCF
p. 84
$
Change history
p. 85