ETSI TS 129 198-14-2010 Digital cellular telecommunications system (Phase 2+) Universal Mobile Telecommunications System (UMTS) LTE Open Service Access (OSA) Application Programmin.pdf

1、 ETSI TS 129 198-14 V9.0.0 (2010-01)Technical Specification Digital cellular telecommunications system (Phase 2+);Universal Mobile Telecommunications System (UMTS);LTE;Open Service Access (OSA)Application Programming Interface (API);Part 14: Presence and Availability Management (PAM)Service Capabili

2、ty Feature (SCF) (3GPP TS 29.198-14 version 9.0.0 Release 9)floppy3ETSI ETSI TS 129 198-14 V9.0.0 (2010-01)13GPP TS 29.198-14 version 9.0.0 Release 9Reference RTS/TSGC-0029198-14v900 Keywords GSM, LTE, UMTS ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 F

3、ax: +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 document may be made available in more than

4、 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 the PDF version kept on a specific network

5、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/status.asp If you find errors in the prese

6、nt 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 extend to reproduction in all media. Europe

7、an Telecommunications Standards Institute 2010. 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 the benefit of its Members and of the 3GPP Or

8、ganizational 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 TS 129 198-14 V9.0.0 (2010-01)23GPP TS 29.198-14 version 9

9、.0.0 Release 9Intellectual 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-members, and can be found in ETSI SR 000 314: “Intelle

10、ctual 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.asp). Pursuant to the ETSI IPR Policy, no investig

11、ation, 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 present document. Foreword This Technical Specifica

12、tion (TS) 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 references to the corresponding ETSI deliverables.

13、 The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi.org/key/queryform.asp. ETSI ETSI TS 129 198-14 V9.0.0 (2010-01)33GPP TS 29.198-14 version 9.0.0 Release 9Contents Intellectual Property Rights 2g3Foreword . 2g3Foreword . 9g3Introduction 9g31 Scope

14、11g32 References 11g33 Definitions and abbreviations . 11g33.1 Definitions 11g33.2 Abbreviations . 12g34 Presence and Availability Management SCF . 12g34.1 Introduction 12g34.2 Motivation 12g34.3 Goals 12g34.4 Concepts . 13g34.4.1 Identity 13g34.4.2 Agent 13g34.4.3 Presence 14g34.4.4 Availability .

15、14g34.4.5 Events . 15g34.5 Scope of PAM information 16g34.6 Security and privacy . 16g35 Sequence Diagrams 17g35.1 Use of authentication tokens 17g35.2 Event registration and notification . 18g36 Class Diagrams . 19g36.1 PAM Provisioning SCF Class Diagrams 19g36.2 PAM Access SCF Class Diagrams . 21g

16、36.3 PAM Event SCF Class Diagrams . 22g37 The Service Interface Specifications 23g37.1 Interface Specification Format . 23g37.1.1 Interface Class 23g37.1.2 Method descriptions 24g37.1.3 Parameter descriptions 24g37.1.4 State Model . 24g37.2 Base Interface . 24g37.2.1 Interface Class IpInterface 24g3

17、7.3 Service Interfaces . 24g37.3.1 Overview 24g37.4 Generic Service Interface . 24g37.4.1 Interface Class IpService 24g37.4.1.1 Method setCallback() 25g37.4.1.2 Method setCallbackWithSessionID() 25g38 Presence and Availability Management Interface Classes . 26g38.1 PAM Provisioning SCF Interface Cla

18、sses 26g38.1.1 Interface Class IpPAMProvisioningManager . 26g38.1.1.1 Method getAuthToken() 27g38.1.1.2 Method obtainInterface() 27g38.1.1.3 Method getAccessControl() 28g38.1.1.4 Method setAccessControl() . 28g38.1.2 Interface Class IpPAMIdentityManagement 29g3ETSI ETSI TS 129 198-14 V9.0.0 (2010-01

19、)43GPP TS 29.198-14 version 9.0.0 Release 98.1.2.1 Method createIdentity() . 30g38.1.2.2 Method deleteIdentity(). 31g38.1.2.3 Method isIdentity() 31g38.1.2.4 Method createGroupIdentity(). 32g38.1.2.5 Method deleteGroupIdentity(). 32g38.1.2.6 Method addToGroup() 32g38.1.2.7 Method removeFromGroup() 3

20、3g38.1.2.8 Method listMembers() . 33g38.1.2.9 Method isGroupIdentity() . 34g38.1.2.10 Method listGroupMembership() . 34g38.1.2.11 Method addAlias() 35g38.1.2.12 Method removeAliases() . 35g38.1.2.13 Method listAliases() 36g38.1.2.14 Method lookupByAlias() 36g38.1.2.15 Method associateTypes() 36g38.1

21、.2.16 Method disassociateTypes() 37g38.1.2.17 Method listTypesOfIdentity() . 37g38.1.2.18 Method hasType() . 38g38.1.2.19 Method getIdentityAttributes() . 38g38.1.2.20 Method setIdentityAttributes() 39g38.1.3 Interface Class IpPAMAgentManagement . 39g38.1.3.1 Method createAgent() . 40g38.1.3.2 Metho

22、d deleteAgent() . 41g38.1.3.3 Method isAgent() 41g38.1.3.4 Method enableCapabilities() . 41g38.1.3.5 Method disableCapabilities() 42g38.1.3.6 Method listEnabledCapabilities() 42g38.1.3.7 Method listAllCapabilities() 43g38.1.3.8 Method isCapableOf() . 43g38.1.3.9 Method associateTypes() 44g38.1.3.10

23、Method disassociateTypes() 44g38.1.3.11 Method listTypesOfAgent() 45g38.1.3.12 Method hasType() . 45g38.1.3.13 Method getAgentAttributes() 45g38.1.3.14 Method setAgentAttributes(). 46g38.1.4 Interface Class IpPAMAgentAssignment . 47g38.1.4.1 Method assignAgent() . 47g38.1.4.2 Method unassignAgent().

24、 48g38.1.4.3 Method listAssignedAgents() 48g38.1.4.4 Method listAssociatedIdentitiesOfAgent() 49g38.1.4.5 Method listAssignedAgentsByCapability() 49g38.1.4.6 Method listCapabilitiesOfIdentity() 49g38.1.4.7 Method isIdentityCapableOf() 50g38.1.5 Interface Class IpPAMIdentityTypeManagement 50g38.1.5.1

25、 Method createIdentityAttribute() 51g38.1.5.2 Method deleteIdentityAttribute() 51g38.1.5.3 Method getIdentityAttributeDefinition() . 52g38.1.5.4 Method listAllIdentityAttributes() 52g38.1.5.5 Method createIdentityType(). 52g38.1.5.6 Method deleteIdentityType(). 53g38.1.5.7 Method listIdentityTypes()

26、 53g38.1.5.8 Method addIdentityTypeAttributes() 54g38.1.5.9 Method removeIdentityTypeAttributes() 54g38.1.5.10 Method listIdentityTypeAttributes() . 55g38.1.6 Interface Class IpPAMAgentTypeManagement . 55g38.1.6.1 Method createAgentAttribute() . 56g38.1.6.2 Method deleteAgentAttribute() . 56g38.1.6.

27、3 Method getAgentAttributeDefinition() . 57g38.1.6.4 Method listAllAgentAttributes() . 57g38.1.6.5 Method createAgentType() . 57g38.1.6.6 Method deleteAgentType() . 58g38.1.6.7 Method listAgentTypes() 58g3ETSI ETSI TS 129 198-14 V9.0.0 (2010-01)53GPP TS 29.198-14 version 9.0.0 Release 98.1.6.8 Metho

28、d addAgentTypeAttributes() . 59g38.1.6.9 Method removeAgentTypeAttributes() . 59g38.1.6.10 Method listAgentTypeAttributes() 60g38.1.7 Interface Class IpPAMCapabilityManagement 60g38.1.7.1 Method createCapabilityAttribute() 61g38.1.7.2 Method deleteCapabilityAttribute() 61g38.1.7.3 Method getCapabili

29、tyAttributeDefinition() 62g38.1.7.4 Method listAllCapabilityAttributes() 62g38.1.7.5 Method createCapability() 63g38.1.7.6 Method deleteCapability() 63g38.1.7.7 Method listCapabilities() . 63g38.1.7.8 Method addCapabilityAttributes() 64g38.1.7.9 Method removeCapabilityAttributes() 64g38.1.7.10 Metho

30、d listCapabilityAttributes() . 65g38.1.7.11 Method assignCapabilitiesToType() . 65g38.1.7.12 Method unassignCapabilitiesFromType() . 66g38.1.7.13 Method listCapabilitiesOfType() 66g38.2 PAM Access SCF Interface Classes . 66g38.2.1 Interface Class IpPAMPresenceAvailabilityManager 66g38.2.1.1 Method g

31、etAuthToken() 67g38.2.1.2 Method obtainInterface() 67g38.2.1.3 Method getAccessControl() 68g38.2.1.4 Method setAccessControl() . 68g38.2.1.5 Method activateService() 69g38.2.1.6 Method deactivateService(). 69g38.2.1.7 Method isActiveIdentity() . 69g38.2.2 Interface Class IpPAMIdentityPresence . 70g3

32、8.2.2.1 Method setIdentityPresence() 70g38.2.2.2 Method setIdentityPresenceExpiration() . 71g38.2.2.3 Method getIdentityPresence() . 71g38.2.3 Interface Class IpPAMAvailability . 72g38.2.3.1 Method getAvailability() . 73g38.2.3.2 Method getPreference(). 74g38.2.3.3 Method setPreference() . 74g38.2.4

33、 Interface Class IpPAMAgentPresence 75g38.2.4.1 Method setAgentPresence() 75g38.2.4.2 Method setCapabilityPresence() . 76g38.2.4.3 Method setAgentPresenceExpiration() 76g38.2.4.4 Method setCapabilityPresenceExpiration() . 77g38.2.4.5 Method getAgentPresence() 77g38.2.4.6 Method getCapabilityPresence

34、() . 78g38.2.5 Interface Class IpAppPAMPreferenceCheck 78g38.2.5.1 Method computeAvailability() 79g38.3 PAM Event SCF Interface Classes . 79g38.3.1 Interface Class IpPAMEventManager 79g38.3.1.1 Method getAuthToken() 80g38.3.1.2 Method obtainInterface() 80g38.3.1.3 Method getAccessControl() 81g38.3.1

35、.4 Method setAccessControl() . 81g38.3.1.5 Method activateService() 82g38.3.1.6 Method deactivateService(). 82g38.3.1.7 Method isActiveIdentity() . 82g38.3.2 Interface Class IpAppPAMEventHandler . 83g38.3.2.1 Method eventNotify() 83g38.3.2.2 Method eventNotifyErr() 83g38.3.3 Interface Class IpPAMEve

36、ntHandler 84g38.3.3.1 Method isRegistered() . 84g38.3.3.2 Method registerAppInterface() 85g38.3.3.3 Method registerForEvent() 85g38.3.3.4 Method deregisterAppInterface() 86g38.3.3.5 Method deregisterFromEvent() . 86g3ETSI ETSI TS 129 198-14 V9.0.0 (2010-01)63GPP TS 29.198-14 version 9.0.0 Release 99

37、 State Transition Diagrams 86g310 PAM Service Properties . 87g310.1 PAM Access Service 87g310.2 PAM Event Service 87g311 PAM Data Definitions 87g311.1 Entity Address Definitions . 87g311.1.1 TpPAMFQName . 87g311.1.2 TpPAMFQNameList 88g311.2 Attribute Data Definitions 88g311.2.1 TpPAMAttribute . 88g3

38、11.2.2 TpPAMAttributeList . 88g311.2.3 TpPAMAttributeDef . 88g311.2.4 TpPAMAttributeDefList . 88g311.3 Presence Data Definitions 89g311.3.1 TpPAMCapability . 89g311.3.2 TpPAMCapabilityList 89g311.3.3 TpPAMPresenceData 89g311.3.4 TpPAMPresenceDataList . 89g311.4 Pre-defined Presence type 89g311.4.1 P

39、resentity 89g311.5 Availability Data Definitions . 90g311.5.1 TpPAMAvailabilityProfile . 90g311.5.2 TpPAMAvailabilityProfileList . 90g311.5.3 TpPAMPrivacyCode . 90g311.6 Availability Context Data Definitions 90g311.6.1 TpPAMContext . 90g311.6.2 TpPAMContextName . 91g311.6.3 TpPAMContextData . 91g311

40、.6.4 TpPAMCommunicationContext . 91g311.6.5 TpPAMContextList 91g311.7 Credential data definitions 91g311.7.1 TpPAMCredential . 91g311.8 Availability and Access Control Preference Data Definitions . 91g311.8.1 IpAppPAMPreferenceCheckRef . 91g311.8.2 TpPAMAccessControlData 92g311.8.3 TpPAMACLDefault .

41、 92g311.8.4 TpPAMPreferenceOp . 92g311.8.5 TpPAMPreferenceType 92g311.8.6 TpPAMPreferenceData . 92g311.9 Time data definitions 93g311.9.1 TpPAMTimeInterval 93g311.10 Pre-defined Entity Types and Attributes 93g311.11 Interface name definitions 93g311.11.1 TpPAMProvisioningInterfaceName . 93g311.11.2

42、TpPAMPresenceAvailabilityInterfaceName. 94g311.11.3 TpPAMEventInterfaceName 94g311.12 Event data definitions . 94g311.12.1 IpAppPAMEventHandlerRef 94g311.12.2 TpPAMClientID . 94g311.12.3 TpPAMEventID 94g311.12.4 TpPAMEventName 95g311.12.5 TpPAMEventNameList 95g311.12.6 TpPAMEventInfo . 95g311.12.7 T

43、pPAMEventInfoList . 96g311.12.8 TpPAMNotificationInfo . 96g311.12.9 TpPAMNotificationInfoList . 96g311.12.10 PAM_CE_IDENTITY_CREATED . 96g311.12.10.1 TpPAMICEventData . 96g311.12.10.2 TpPAMICNotificationData . 97g311.12.11 PAM_CE_IDENTITY_DELETED 97g3ETSI ETSI TS 129 198-14 V9.0.0 (2010-01)73GPP TS

44、29.198-14 version 9.0.0 Release 911.12.11.1 TpPAMIDEventData. 97g311.12.11.2 TpPAMIDNotificationData . 97g311.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED 97g311.12.12.1 TpPAMGMCEventData 98g311.12.12.2 TpPAMGMCNotificationData 98g311.12.13 PAM_CE_AGENT_CREATED . 98g311.12.13.1 TpPAMACEventData . 98g311.12

45、.13.2 TpPAMACNotificationData . 98g311.12.14 PAM_CE_AGENT_DELETED . 98g311.12.14.1 TpPAMADEventData . 99g311.12.14.2 TpPAMADNotificationData . 99g311.12.15 PAM_CE_AGENT_ASSIGNED . 99g311.12.15.1 TpPAMAAEventData . 99g311.12.15.2 TpPAMAANotificationData . 99g311.12.16 PAM_CE_AGENT_UNASSIGNED 100g311.

46、12.16.1 TpPAMAUEventData . 100g311.12.16.2 TpPAMAUNotificationData . 100g311.12.17 PAM_CE_CAPABILITY_CHANGED 100g311.12.17.1 TpPAMCCEventData . 100g311.12.17.2 TpPAMCCNotificationData 101g311.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET . 101g311.12.18.1 TpPAMACPSEventData . 101g311.12.18.2 TpPAMACPSN

47、otificationData . 101g311.12.19 PAM_CE_AGENT_PRESENCE_SET 101g311.12.19.1 TpPAMAPSEventData . 102g311.12.19.2 TpPAMAPSNotificationData 102g311.12.20 PAM_CE_IDENTITY_PRESENCE_SET . 102g311.12.20.1 TpPAMIPSEventData . 102g311.12.20.2 TpPAMIPSNotificationData . 103g311.12.21 PAM_CE_AVAILABILITY_CHANGED

48、 . 103g311.12.21.1 TpPAMAVCEventData 103g311.12.21.2 TpPAMAVCNotificationData 103g311.12.22 PAM_CE_WATCHERS_CHANGED . 103g311.12.22.1 TpPAMWCEventData 104g311.12.22.2 TpPAMWCNotificationData 104g311.12.22.3 TpPAMwatcherChangeType . 104g311.13 Error Types . 104g311.13.1 TpPAMErrorCause . 104g311.13.2

49、 TpPAMErrorInfo 105g312 Presence and Availability Management Exception Classes . 106g3Annex A (normative): OMG IDL Description of Presence and Availability Management SCF 107g3Annex B (informative): W3C WSDL Description of the Presence and Availability Management SCFs . 108g3Annex C (informative): Java API Description of the Presence and Availability Management SCFs . 109g3Annex D (informative): Description of Presence and Availability Management for 3GPP2 cdma2000 networks . 110g3D.1 General Exceptions. 110g3D.2 Specific Exceptions 110g3D.2.1 Clause 1: Scope 110g3D.2.2 Clau