ETSI TS 129 198-15-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-15 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 15: Multi-media Messaging (MM)Service Capability Feature (SCF

2、) (3GPP TS 29.198-15 version 9.0.0 Release 9)floppy3ETSI ETSI TS 129 198-15 V9.0.0 (2010-01)13GPP TS 29.198-15 version 9.0.0 Release 9Reference RTS/TSGC-0029198-15v900 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

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

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

5、SI 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 present document, pl

6、ease 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. European Telecommunic

7、ations 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 Organizational Pa

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

9、ntellectual 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

10、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 investigation, includin

11、g 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 Specification (TS) has b

12、een 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. The cross refe

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

14、 9g33 Definitions and abbreviations . 10g33.1 Definitions 10g33.2 Abbreviations . 10g34 Multi Media Messaging SCF . 10g35 Sequence Diagrams 11g35.1 Sending messages and receiving delivery notification . 11g35.2 Sending, and receiving messages in same context . 13g35.3 Setting notification of receive

15、d messages 14g35.4 Using Mailbox functions 15g35.5 Using Mailbox to send and receive 17g35.6 Setting notification of received messages 19g36 Class Diagrams . 20g37 The Service Interface Specifications 21g37.1 Interface Specification Format . 21g37.1.1 Interface Class 21g37.1.2 Method descriptions 21

16、g37.1.3 Parameter descriptions 21g37.1.4 State Model . 21g37.2 Base Interface . 22g37.2.1 Interface Class IpInterface 22g37.3 Service Interfaces . 22g37.3.1 Overview 22g37.4 Generic Service Interface . 23g37.4.1 Interface Class IpService 23g37.4.1.1 Method setCallback() 23g37.4.1.2 Method setCallbac

17、kWithSessionID() 23g38 Multi Media Messaging Interface Classes . 24g38.1 Interface Class IpMultiMediaMessagingManager . 25g38.1.1 Method openMailbox() . 25g38.1.2 Method openMultiMediaMessaging() 26g38.1.3 Method createNotification() 27g38.1.4 Method destroyNotification() . 28g38.1.5 Method changeNo

18、tification() 28g38.1.6 Method getNextNotification() 28g38.1.7 Method enableNotifications() . 29g38.1.8 Method disableNotifications() 30g38.2 Interface Class IpAppMultiMediaMessagingManager . 31g38.2.1 Method mailboxTerminated() . 31g38.2.2 Method reportNotification() 31g38.2.3 Method notificationsIn

19、terrupted() . 32g38.2.4 Method notificationsResumed() 32g38.2.5 Method multiMediaMessagingTerminated() 32g38.2.6 Method terminateMultipleMailboxes() . 32g38.2.7 Method terminateMultipleMultiMediaMessagingSessions() 33g3ETSI ETSI TS 129 198-15 V9.0.0 (2010-01)43GPP TS 29.198-15 version 9.0.0 Release

20、98.3 Interface Class IpMailbox 34g38.3.1 Method close() 35g38.3.2 Method getMessageInfoPropertiesReq() 35g38.3.3 Method setMessageInfoPropertiesReq() . 35g38.3.4 Method createFolderReq() 36g38.3.5 Method getFoldersReq() . 36g38.3.6 Method deleteFolderReq() 37g38.3.7 Method copyFolderReq() 37g38.3.8

21、Method moveFolderReq() . 38g38.3.9 Method putMessageReq() . 38g38.3.10 Method copyMessageReq() 39g38.3.11 Method moveMessageReq() . 40g38.3.12 Method deleteMessageReq() 40g38.3.13 Method listMessagesReq() . 41g38.3.14 Method listMessageBodyPartsReq() 42g38.3.15 Method getMessageBodyPartsReq() 42g38.

22、3.16 Method getMessageHeadersReq() 43g38.3.17 Method getMessageContentReq() 44g38.3.18 Method getFullMessageReq() . 44g38.3.19 Method getMailboxInfoPropertiesReq() . 45g38.3.20 Method getFolderInfoPropertiesReq() 45g38.4 Interface Class IpAppMailbox . 47g38.4.1 Method getMessageInfoPropertiesRes() .

23、 48g38.4.2 Method setMessageInfoPropertiesRes() . 49g38.4.3 Method setMessageInfoPropertiesErr() 49g38.4.4 Method getMailboxInfoPropertiesErr() 49g38.4.5 Method getFolderInfoPropertiesErr() . 50g38.4.6 Method getMessageInfoPropertiesErr() 50g38.4.7 Method createFolderRes() 51g38.4.8 Method createFol

24、derErr() . 51g38.4.9 Method getFoldersRes() . 51g38.4.10 Method getFoldersErr() 52g38.4.11 Method deleteFolderRes() 52g38.4.12 Method deleteFolderErr() . 52g38.4.13 Method copyFolderRes() 53g38.4.14 Method copyFolderErr() . 53g38.4.15 Method moveFolderRes() . 54g38.4.16 Method moveFolderErr() 54g38.

25、4.17 Method putMessageRes() . 54g38.4.18 Method putMessageErr() 55g38.4.19 Method copyMessageRes() . 55g38.4.20 Method copyMessageErr() . 55g38.4.21 Method moveMessageRes() 56g38.4.22 Method moveMessageErr() 56g38.4.23 Method deleteMessageRes() . 56g38.4.24 Method deleteMessageErr() 57g38.4.25 Metho

26、d listMessagesRes() 57g38.4.26 Method listMessagesErr() . 58g38.4.27 Method listMessageBodyPartsRes() . 58g38.4.28 Method listMessageBodyPartsErr() 58g38.4.29 Method getMessageBodyPartsRes() . 59g38.4.30 Method getMessageBodyPartsErr() 59g38.4.31 Method getMessageHeadersRes() 59g38.4.32 Method getMe

27、ssageHeadersErr() . 60g38.4.33 Method getMessageContentRes() . 60g38.4.34 Method getMessageContentErr() 61g38.4.35 Method getFullMessageRes() . 61g38.4.36 Method getFullMessageErr() 61g38.4.37 Method getMailboxInfoPropertiesRes() . 62g38.4.38 Method getFolderInfoPropertiesRes() 62g38.5 Interface Cla

28、ss IpMultiMediaMessaging 63g38.5.1 Method sendMessageReq() . 63g3ETSI ETSI TS 129 198-15 V9.0.0 (2010-01)53GPP TS 29.198-15 version 9.0.0 Release 98.5.2 Method cancelMessageReq() 64g38.5.3 Method queryStatusReq() . 65g38.5.4 Method close() 65g38.5.5 Method sendMessageWithNotifyReq() 66g38.6 Interfac

29、e Class IpAppMultiMediaMessaging . 68g38.6.1 Method sendMessageRes() . 68g38.6.2 Method sendMessageErr() 69g38.6.3 Method cancelMessageRes() 69g38.6.4 Method cancelMessageErr() . 69g38.6.5 Method queryStatusRes() . 70g38.6.6 Method queryStatusErr() 70g38.6.7 Method messageStatusReport() 70g38.6.8 Me

30、thod messageReceived() 71g38.6.9 Method sendMessageWithNotifyRes() . 71g38.6.10 Method sendMessageWithNotifyErr() 72g39 State Transition Diagrams 73g310 Multi-Media Messaging Service Properties . 73g311 Data Definitions . 74g311.1 Multi-Media Messaging data definitions 74g311.1.1 IpMultiMediaMessagi

31、ngManager . 74g311.1.2 IpMultiMediaMessagingManagerRef . 74g311.1.3 IpAppMultiMediaMessagingManager 74g311.1.4 IpAppMultiMediaMessagingManagerRef 74g311.1.5 IpMailbox . 74g311.1.6 IpMailboxRef 74g311.1.7 IpAppMailbox . 74g311.1.8 IpAppMailboxRef . 74g311.1.9 IpMultiMediaMessaging . 74g311.1.10 IpMul

32、tiMediaMessagingRef . 74g311.1.11 IpAppMultiMediaMessaging 74g311.1.12 IpAppMultiMediaMessagingRef 75g311.1.13 TpBodyPartDescription 75g311.1.14 TpBodyPartDescriptionList 75g311.1.15 TpBodyPart . 75g311.1.16 TpBodyPartList . 75g311.1.17 TpDeliveryTime . 75g311.1.18 TpDeliveryTimeType . 76g311.1.19 T

33、pFolderInfoProperty . 76g311.1.20 TpFolderInfoPropertyName 76g311.1.21 TpFolderInfoPropertySet 76g311.1.22 TpGenericHeaderField 76g311.1.23 TpListMessagesCriteria 77g311.1.24 TpMailboxFolderStatusInformation . 77g311.1.25 TpMailboxIdentifier 77g311.1.26 TpMailboxIdentifierSet 77g311.1.27 TpMailboxIn

34、foProperty 77g311.1.28 TpMailboxInfoPropertyName. 77g311.1.29 TpMailboxInfoPropertySet . 78g311.1.30 TpMailboxMessageStatus . 78g311.1.31 TpMessageDeliveryType 78g311.1.32 TpMessageInfoProperty 78g311.1.33 TpMessageInfoPropertyName 79g311.1.34 TpMessageInfoPropertySet 79g311.1.35 TpMessageHeaderFiel

35、dType 80g311.1.36 TpMessageHeaderField 81g311.1.37 TpMessageHeaderFieldSet . 81g311.1.38 TpMessagePriority 81g311.1.39 TpMessageDeliveryReportType . 82g311.1.40 TpMessageTreatment 82g311.1.41 TpMessageTreatmentType . 82g3ETSI ETSI TS 129 198-15 V9.0.0 (2010-01)63GPP TS 29.198-15 version 9.0.0 Releas

36、e 911.1.42 TpMessageTreatmentSet 82g311.1.43 TpMultiMediaMessagingIdentifier . 82g311.1.44 TpMultiMediaMessagingIdentifierSet 83g311.1.45 TpQueryStatusReport . 83g311.1.46 TpQueryStatusReportSet 83g311.1.47 TpTerminatingAddressList . 83g311.2 Event Notification data definitions . 84g311.2.1 TpMessag

37、ingEventName 84g311.2.2 TpMessagingEventCriteria . 84g311.2.3 TpMessagingEventCriteriaSet 84g311.2.4 TpNewMailboxMessageArrivedCriteria 84g311.2.5 TpNewMessageArrivedCriteria 85g311.2.6 TpMessagingEventInfo . 85g311.2.7 TpMessagingEventInfoSet 85g311.2.8 TpNewMailboxMessageArrivedInfo 85g311.2.9 TpN

38、ewMessageArrivedInfo . 86g311.2.10 TpMessageDescription . 86g311.2.11 TpMessageDescriptionList . 86g311.2.12 TpMessagingNotificationRequested . 86g311.2.13 TpMessagingNotificationRequestedSet 86g311.2.14 TpMessagingNotificationRequestedSetEntry . 87g311.2.15 TpNewMessageStatusReportArrivedInfo . 87g

39、311.3 Error type data definitions 88g311.3.1 TpMessageInfoPropertyError . 88g311.3.2 TpMessagingError 88g311.3.3 TpMessageInfoPropertyErrorSet 88g311.3.4 TpSetPropertyError . 88g312 Exception Classes . 90g3Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF 91g3Annex B (informative

40、): W3C WSDL Description of Multi-Media Messaging SCF. 92g3Annex C (informative): Java API Description of the Multi-Media Messaging SCF 93g3Annex D (informative): Description of Parlay X Web Services Part 1: Common Definitions Multi Media Messaging for 3GPP2 cdma2000 networks . 94g3D.1 General Except

41、ions. 94g3D.2 Specific Exceptions 94g3D.2.1 Clause 1: Scope 94g3D.2.2 Clause 2: References 94g3D.2.3 Clause 3: Definitions and abbreviations . 94g3D.2.4 Clause 4: Multi Media Messaging SCF 94g3D.2.5 Clause 5: Sequence Diagrams 94g3D.2.6 Clause 6: Class Diagrams . 95g3D.2.7 Clause 7: The Service Inte

42、rface Specifications 95g3D.2.8 Clause 8: Multi Media Messaging Interface Classes 95g3D.2.9 Clause 9: State Transition Diagrams 95g3D.2.10 Clause 10: Multi-Media Messaging Service Properties . 95g3D.2.11 Clause 11: Data Definitions 95g3D.2.12 Clause 12: Exception Classes . 95g3D.2.13 Annex A (normati

43、ve): OMG IDL Description of Multi-Media Messaging SCF . 95g3D.2.14 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF . 95g3D.2.15 Annex C (informative): Java API Description of the Multi-Media Messaging SCF 95g3Annex E (informative): Change history . 96g3History 97g3ETSI ETSI

44、TS 129 198-15 V9.0.0 (2010-01)73GPP TS 29.198-15 version 9.0.0 Release 9Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the present document are subject to continuing work within the TSG and may change following formal TSG appr

45、oval. 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 x.y.z where: x the first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3

46、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 digit is incremented when editorial only changes have been incorporated in the document. Introduction T

47、he present document is part 15 of a multi-part TS covering the 3rdGeneration Partnership Project: Technical Specification Group Core Network and Terminals; Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (3GPP TS 29.198) is structured in

48、 the following Parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Framework“; 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

49、-part 5: “Conference Call Control SCF“; Part 5: “User Interaction 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 8) Part 10: “Connectivity Manager SCF“; (new in Release 8) 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“. ETSI ETSI TS 129 198-15 V9.0.0 (2010-01)83GPP TS 29.198-15 version 9.0.0 Relea