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

1、 ETSI TS 129 198-13 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 13: Policy management Service Capability Feature (SCF) (3GPP T

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

3、ret 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 one electronic version

4、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 drive within ETSI Secret

5、ariat. 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 present document, please send

6、 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. European Telecommunications St

7、andards 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 Organizational Partners. L

8、TE 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-13 V9.0.0 (2010-01)23GPP TS 29.198-13 version 9.0.0 Release 9Intellectu

9、al 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: “Intellectual Property Rights (I

10、PRs); 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 investigation, including IPR sea

11、rches, 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 Specification (TS) has been produ

12、ced 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. The cross reference bet

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

14、efinitions and abbreviations . 11g33.1 Definitions 11g33.2 Abbreviations . 11g34 Policy Management SCF 11g35 Sequence Diagrams 12g35.1 Use of Policy Repository 12g35.2 Introduce condition and action into rule . 14g35.3 Create event 16g35.4 Create and modify domain . 18g35.5 ASP offering services to

15、prepaid subscribers . 20g35.6 Create Signature for an evaluation context . 22g35.7 Request Evaluation of Policies . 24g35.8 Register for and Receive Notification of a Policy Event 25g36 Class Diagrams . 25g36.1 PM Provisioning SCF Class Diagrams . 25g36.2 PM Policy Evaluation SCF Class Diagrams . 27

16、g37 The Service Interface Specifications 28g37.1 Interface Specification Format . 28g37.1.1 Interface Class 28g37.1.2 Method descriptions 28g37.1.3 Parameter descriptions 28g37.1.4 State Model . 29g37.2 Base Interface . 29g37.2.1 Interface Class IpInterface 29g37.3 Service Interfaces . 29g37.3.1 Ove

17、rview 29g37.4 Generic Service Interface . 29g37.4.1 Interface Class IpService 29g37.4.1.1 Method setCallback() 29g37.4.1.2 Method setCallbackWithSessionID() 30g38 Policy Management (PM) Interface Classes 30g38.1 PM Provisioning SCF Interface Classes . 30g38.1.1 Interface Class IpPolicyManager 30g38.

18、1.1.1 Method createDomain() 31g38.1.1.2 Method getDomain(). 32g38.1.1.3 Method removeDomain() 32g38.1.1.4 Method getDomainCount() . 32g38.1.1.5 Method getDomainIterator() . 33g38.1.1.6 Method findMatchingDomains() . 33g38.1.1.7 Method createRepository() 33g38.1.1.8 Method getRepository() 34g38.1.1.9

19、 Method removeRepository() . 34g38.1.1.10 Method getRepositoryCount(). 34g38.1.1.11 Method getRepositoryIterator(). 35g3ETSI ETSI TS 129 198-13 V9.0.0 (2010-01)43GPP TS 29.198-13 version 9.0.0 Release 98.1.1.12 Method startTransaction() . 35g38.1.1.13 Method commitTransaction() 36g38.1.1.14 Method a

20、bortTransaction() 36g38.1.2 Interface Class IpPolicy 36g38.1.2.1 Attributes . 37g38.1.2.2 Method getAttribute() . 37g38.1.2.3 Method setAttribute() 38g38.1.2.4 Method getAttributes() 38g38.1.2.5 Method setAttributes() 38g38.1.3 Interface Class IpPolicyDomain . 39g38.1.3.1 Attributes . 41g38.1.3.2 Me

21、thod getParentDomain() . 42g38.1.3.3 Method createDomain() 42g38.1.3.4 Method getDomain() . 42g38.1.3.5 Method removeDomain() 43g38.1.3.6 Method getDomainCount() . 43g38.1.3.7 Method getDomainIterator() . 43g38.1.3.8 Method createGroup() . 44g38.1.3.9 Method getGroup() 44g38.1.3.10 Method removeGrou

22、p() 45g38.1.3.11 Method getGroupCount() 45g38.1.3.12 Method getGroupIterator() 45g38.1.3.13 Method createRule() 46g38.1.3.14 Method getRule() 46g38.1.3.15 Method removeRule() . 46g38.1.3.16 Method getRuleCount() 47g38.1.3.17 Method getRuleIterator() 47g38.1.3.18 Method createEventDefinition() . 47g3

23、8.1.3.19 Method getEventDefinition() 48g38.1.3.20 Method removeEventDefinition() . 48g38.1.3.21 Method getEventDefinitionCount() 48g38.1.3.22 Method getEventDefinitionIterator() 49g38.1.3.23 Method createVariableSet() 49g38.1.3.24 Method getVariableSet() . 49g38.1.3.25 Method removeVariableSet() 50g

24、38.1.3.26 Method getVariableSetCount() . 50g38.1.3.27 Method getVariableSetIterator() . 50g38.1.3.28 Method createVariable() . 51g38.1.3.29 Method setVariableValue() . 51g38.1.3.30 Method getVariableType() 52g38.1.3.31 Method getVariableValue(). 52g38.1.3.32 Method getVariable() 52g38.1.3.33 Method

25、removeVariable() . 53g38.1.3.34 Method createSignature() 53g38.1.3.35 Method getSignature() 53g38.1.3.36 Method removeSignature() . 54g38.1.3.37 Method getSignatureCount() . 54g38.1.3.38 Method getSignatureIterator(). 54g38.1.4 Interface Class IpPolicyGroup 55g38.1.4.1 Attributes . 56g38.1.4.2 Metho

26、d getParentDomain() . 57g38.1.4.3 Method getParentGroup() . 57g38.1.4.4 Method createGroup() . 57g38.1.4.5 Method getGroup() 58g38.1.4.6 Method removeGroup() 58g38.1.4.7 Method getGroupCount() 58g38.1.4.8 Method getGroupIterator() 59g38.1.4.9 Method createRule() 59g38.1.4.10 Method getRule() 59g38.1

27、.4.11 Method removeRule() . 60g38.1.4.12 Method getRuleCount() 60g38.1.4.13 Method getRuleIterator() 60g3ETSI ETSI TS 129 198-13 V9.0.0 (2010-01)53GPP TS 29.198-13 version 9.0.0 Release 98.1.5 Interface Class IpPolicyRepository . 61g38.1.5.1 Attributes . 62g38.1.5.2 Method getParentRepository() 63g3

28、8.1.5.3 Method createRepository() 63g38.1.5.4 Method getRepository() 63g38.1.5.5 Method removeRepository() . 64g38.1.5.6 Method getRepositoryCount(). 64g38.1.5.7 Method getRepositoryIterator(). 64g38.1.5.8 Method createCondition() . 65g38.1.5.9 Method getCondition() 65g38.1.5.10 Method removeConditi

29、on() . 66g38.1.5.11 Method getConditionCount() 66g38.1.5.12 Method getConditionIterator() 66g38.1.5.13 Method createAction() 67g38.1.5.14 Method getAction() . 67g38.1.5.15 Method removeAction() 68g38.1.5.16 Method getActionCount() . 68g38.1.5.17 Method getActionIterator() . 68g38.1.6 Interface Class

30、 IpPolicyRule. 69g38.1.6.1 Attributes . 71g38.1.6.2 Method getParentGroup() . 73g38.1.6.3 Method getParentDomain() . 73g38.1.6.4 Method createCondition() . 74g38.1.6.5 Method getCondition() 74g38.1.6.6 Method removeCondition() . 74g38.1.6.7 Method getConditionCount() 75g38.1.6.8 Method getConditionI

31、terator() 75g38.1.6.9 Method createAction() 75g38.1.6.10 Method getAction() . 76g38.1.6.11 Method removeAction() 76g38.1.6.12 Method getActionCount() . 77g38.1.6.13 Method getActionIterator() . 77g38.1.6.14 Method setValidityPeriodConditionByName() . 77g38.1.6.15 Method setValidityPeriodCondition()

32、. 78g38.1.6.16 Method getValidityPeriodCondition() 78g38.1.6.17 Method unsetValidityPeriodCondition() . 78g38.1.6.18 Method setConditionList() 79g38.1.6.19 Method getConditionList() 79g38.1.6.20 Method setActionList() . 79g38.1.6.21 Method getActionList(). 80g38.1.7 Interface Class IpPolicyCondition

33、 80g38.1.7.1 Attributes . 81g38.1.7.2 Method getParentRepository() 82g38.1.7.3 Method getParentRule() 82g38.1.8 Interface Class IpPolicyTimePeriodCondition . 82g38.1.8.1 Attributes . 83g38.1.9 Interface Class IpPolicyAction . 86g38.1.9.1 Attributes . 86g38.1.9.2 Method getParentRepository() 87g38.1.

34、9.3 Method getParentRule() 87g38.1.10 Interface Class IpPolicyEventDefinition 88g38.1.10.1 Attributes . 88g38.1.10.2 Method setRequiredAttributes() 89g38.1.10.3 Method setOptionalAttributes() 89g38.1.10.4 Method getRequiredAttributes() . 89g38.1.10.5 Method getOptionalAttributes() 90g38.1.10.6 Metho

35、d getParentDomain() . 90g38.1.11 Interface Class IpPolicyEventCondition . 90g38.1.11.1 Attributes . 90g38.1.12 Interface Class IpPolicyExpressionCondition 91g38.1.12.1 Attributes . 92g38.1.13 Interface Class IpPolicyEventAction 92g3ETSI ETSI TS 129 198-13 V9.0.0 (2010-01)63GPP TS 29.198-13 version 9

36、.0.0 Release 98.1.13.1 Attributes . 93g38.1.14 Interface Class IpPolicyExpressionAction 93g38.1.14.1 Attributes . 94g38.1.15 Interface Class IpPolicyIterator 94g38.1.15.1 Attributes . 95g38.1.15.2 Method getList() . 95g38.1.16 Interface Class IpPolicySignature . 96g38.1.16.1 Attributes . 96g38.1.16.

37、2 Method setInputVariables(). 98g38.1.16.3 Method setOutputVariables() 98g38.1.16.4 Method getInputVariables() 98g38.1.16.5 Method getOutputVariables() . 99g38.1.16.6 Method setGroupNames() . 99g38.1.16.7 Method setPolicyRoles(). 99g38.1.16.8 Method getGroupNames() 100g38.1.16.9 Method getPolicyRole

38、s() 100g38.1.16.10 Method getParentDomain() . 100g38.2 PM Policy Evaluation SCF Interface Classes . 101g38.2.1 Interface Class IpPolicyEvalManager . 101g38.2.1.1 Method evalPolicy() 101g38.2.1.2 Method evalPolicyReq() . 102g38.2.1.3 Method abortEvalPolicyReq(). 103g38.2.1.4 Method generateEvent() 10

39、3g38.2.1.5 Method createNotification() 104g38.2.1.6 Method destroyNotification() 104g38.2.2 Interface Class IpAppPolicyDomain 104g38.2.2.1 Method reportNotification() 105g38.2.2.2 Method evalPolicyRes() 105g38.2.2.3 Method evalPolicyErr() . 105g39 State Transition Diagrams 106g39.1 PM Provisioning S

40、CF State Transition Diagrams 106g39.2 PM Policy Evaluation SCF State Transition Diagrams 106g310 PM Service Properties 106g311 Data Definitions . 107g311.1 Policy Management Data Definitions. 107g311.1.1 TpPolicyConditionListType . 107g311.1.2 TpPolicyConditionListElement 107g311.1.3 TpPolicyConditi

41、onList 107g311.1.4 TpPolicyConditionType 107g311.1.5 TpPolicyActionListElement . 108g311.1.6 TpPolicyActionList . 108g311.1.7 TpPolicyActionType . 108g311.1.8 TpPolicyEvent 108g311.1.9 TpPolicyKeyword . 108g311.1.10 TpPolicyKeywordSet 109g311.1.11 TpPolicyError . 110g311.1.12 IpPolicyDomain 110g311.

42、1.13 IpPolicyDomainRef 110g311.1.14 IpPolicyRepository . 110g311.1.15 IpPolicyRepositoryRef 110g311.1.16 IpPolicyGroup . 110g311.1.17 IpPolicyGroupRef . 110g311.1.18 IpPolicyRule . 110g311.1.19 IpPolicyRuleRef . 110g311.1.20 IpPolicyEventDefinition . 110g311.1.21 IpPolicyEventDefinitionRef . 110g311

43、.1.22 IpAppPolicyDomain . 111g311.1.23 IpAppPolicyDomainRef . 111g311.1.24 IpPolicyCondition . 111g311.1.25 IpPolicyConditionRef . 111g3ETSI ETSI TS 129 198-13 V9.0.0 (2010-01)73GPP TS 29.198-13 version 9.0.0 Release 911.1.26 IpPolicyTimePeriodCondition 111g311.1.27 IpPolicyTimePeriodConditionRef 11

44、1g311.2 Data Types for PM Variables . 111g311.2.1 TpPolicyVar 111g311.2.2 TpPolicyVarSet . 111g311.2.3 TpPolicyRecordType 111g311.2.4 TpPolicyListType . 112g311.2.5 TpPolicyTypeInfo . 112g311.2.6 TpPolicyType . 112g311.2.7 TpPolicyNameValue . 112g311.2.8 TpPolicyNameValueList 113g311.3 eBNF for Cond

45、ition and Action expressions 113g311.3.1 Basic Definition 113g311.3.2 Definitions of Constant (Literals) . 113g311.3.3 Definition of Operators . 114g311.3.4 Allowable arithmetic expressions 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the seco

46、nd digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third digit is incremented when editorial only changes have been incorporated in the document. Introduction The present document is part 13 of a multi-part TS covering the 3rdGeneratio

47、n Partnership Project: Technical Specification Group Core Network; Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Fra

48、mework“; 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-part 5: “Conference Call Control SCF“; (new in 3GPP Release 7) Part 5: “User Interaction

49、 SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session Control SCF“; Part 9: “Generic Messaging SCF“; (not part of 3GPP Release 7) Part 10: “Connectivity Manager SCF“; (not part of 3GPP Release 7) Part 11: “Account Management SCF“; Part 12: “Charging SCF“. Part 13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“; Part 15: “Multi Media Messaging SCF“; Part 16: “Service Broker SCF“. (new in Release 7) The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. A map