ETSI TS 129 198-15 V6.6.1 (2008-01)

ETSI TS 129 198-15 V6.6.1 (2008-01)
Technical Specification

Universal Mobile Telecommunications System (UMTS);
Open Service Access (OSA)
Application Programming Interface (API);
Part 15: Multi-media Messaging (MM)
Service Capability Feature (SCF)
(3GPP TS 29.198-15 version 6.6.1 Release 6)






�

---------------------- Page: 1 ----------------------
3GPP TS 29.198-15 version 6.6.1 Release 6 1 ETSI TS 129 198-15 V6.6.1 (2008-01)



Reference
RTS/TSGC-0529198-15v661
Keywords
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

Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture 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 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 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, 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.

© European Telecommunications Standards Institute 2008.
All rights reserved.

TM TM TM TM
DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered
for the benefit of its Members.
TM
3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.
ETSI

---------------------- Page: 2 ----------------------
3GPP TS 29.198-15 version 6.6.1 Release 6 2 ETSI TS 129 198-15 V6.6.1 (2008-01)
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, 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 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) which are, or may be, or may become, essential to the present document.
Foreword
This Technical Specification (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.
The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under
http://webapp.etsi.org/key/queryform.asp.
ETSI

---------------------- Page: 3 ----------------------
3GPP TS 29.198-15 version 6.6.1 Release 6 3 ETSI TS 129 198-15 V6.6.1 (2008-01)
Contents
Intellectual Property Rights.2
Foreword.2
Foreword.7
Introduction .7
1 Scope.9
2 References.9
3 Definitions and abbreviations.10
3.1 Definitions.10
3.2 Abbreviations.10
4 Multi Media Messaging SCF .10
5 Sequence Diagrams.10
5.1 Sending messages and receiving delivery notification .10
5.2 Sending, and receiving messages in same context .12
5.3 Setting notification of received messages .14
5.4 Using Mailbox functions.14
5.5 Using Mailbox to send and receive .16
5.6 Setting notification of received messages .18
6 Class Diagrams.19
7 The Service Interface Specifications.21
7.1 Interface Specification Format .21
7.1.1 Interface Class.21
7.1.2 Method descriptions.21
7.1.3 Parameter descriptions.21
7.1.4 State Model.21
7.2 Base Interface.21
7.2.1 Interface Class IpInterface .21
7.3 Service Interfaces.22
7.3.1 Overview.22
7.4 Generic Service Interface .22
7.4.1 Interface Class IpService .22
7.4.1.1 Method setCallback().22
7.4.1.2 Method setCallbackWithSessionID().23
8 Multi Media Messaging Interface Classes .23
8.1 Interface Class IpMultiMediaMessagingManager .23
8.1.1 Method openMailbox().24
8.1.2 Method openMultiMediaMessaging().25
8.1.3 Method createNotification().26
8.1.4 Method destroyNotification().26
8.1.5 Method changeNotification().27
8.1.6 Method getNextNotification().27
8.1.7 Method enableNotifications().28
8.1.8 Method disableNotifications().29
8.2 Interface Class IpAppMultiMediaMessagingManager.29
8.2.1 Method mailboxTerminated().29
8.2.2 Method reportNotification().30
8.2.3 Method notificationsInterrupted().30
8.2.4 Method notificationsResumed().30
8.2.5 Method multiMediaMessagingTerminated().30
8.2.6 Method terminateMultipleMailboxes().31
8.2.7 Method terminateMultipleMultiMediaMessagingSessions().31
ETSI

---------------------- Page: 4 ----------------------
3GPP TS 29.198-15 version 6.6.1 Release 6 4 ETSI TS 129 198-15 V6.6.1 (2008-01)
8.3 Interface Class IpMailbox .31
8.3.1 Method close().32
8.3.2 Method getMessageInfoPropertiesReq().33
8.3.3 Method setMessageInfoPropertiesReq().33
8.3.4 Method createFolderReq().34
8.3.5 Method getFoldersReq().34
8.3.6 Method deleteFolderReq().35
8.3.7 Method copyFolderReq().35
8.3.8 Method moveFolderReq().36
8.3.9 Method putMessageReq().36
8.3.10 Method copyMessageReq().37
8.3.11 Method moveMessageReq().38
8.3.12 Method deleteMessageReq().38
8.3.13 Method listMessagesReq().39
8.3.14 Method listMessageBodyPartsReq().40
8.3.15 Method getMessageBodyPartsReq().40
8.3.16 Method getMessageHeadersReq().41
8.3.17 Method getMessageContentReq().42
8.3.18 Method getFullMessageReq().42
8.3.19 Method getMailboxInfoPropertiesReq().43
8.3.20 Method getFolderInfoPropertiesReq().43
8.4 Interface Class IpAppMailbox .44
8.4.1 Method getMessageInfoPropertiesRes().46
8.4.2 Method setMessageInfoPropertiesRes().47
8.4.3 Method setMessageInfoPropertiesErr().47
8.4.4 Method getMailboxInfoPropertiesErr().47
8.4.5 Method getFolderInfoPropertiesErr().48
8.4.6 Method getMessageInfoPropertiesErr().48
8.4.7 Method createFolderRes().49
8.4.8 Method createFolderErr().49
8.4.9 Method getFoldersRes().49
8.4.10 Method getFoldersErr().50
8.4.11 Method deleteFolderRes().50
8.4.12 Method deleteFolderErr().51
8.4.13 Method copyFolderRes().51
8.4.14 Method copyFolderErr().51
8.4.15 Method moveFolderRes().52
8.4.16 Method moveFolderErr().52
8.4.17 Method putMessageRes().52
8.4.18 Method putMessageErr().53
8.4.19 Method copyMessageRes().53
8.4.20 Method copyMessageErr().53
8.4.21 Method moveMessageRes().54
8.4.22 Method moveMessageErr().54
8.4.23 Method deleteMessageRes().54
8.4.24 Method deleteMessageErr().55
8.4.25 Method listMessagesRes().55
8.4.26 Method listMessagesErr().56
8.4.27 Method listMessageBodyPartsRes().56
8.4.28 Method listMessageBodyPartsErr().56
8.4.29 Method getMessageBodyPartsRes().57
8.4.30 Method getMessageBodyPartsErr().57
8.4.31 Method getMessageHeadersRes().57
8.4.32 Method getMessageHeadersErr().58
8.4.33 Method getMessageContentRes().58
8.4.34 Method getMessageContentErr().59
8.4.35 Method getFullMessageRes().59
8.4.36 Method getFullMessageErr().59
8.4.37 Method getMailboxInfoPropertiesRes().60
8.4.38 Method getFolderInfoPropertiesRes().60
8.5 Interface Class IpMultiMediaMessaging.61
8.5.1 Method sendMessageReq().61
ETSI

---------------------- Page: 5 ----------------------
3GPP TS 29.198-15 version 6.6.1 Release 6 5 ETSI TS 129 198-15 V6.6.1 (2008-01)
8.5.2 Method cancelMessageReq().62
8.5.3 Method queryStatusReq().63
8.5.4 Method close().63
8.5.5 Method <> sendMessageWithNotifyReq().64
8.6 Interface Class IpAppMultiMediaMessaging.65
8.6.1 Method sendMessageRes().66
8.6.2 Method sendMessageErr().66
8.6.3 Method cancelMessageRes().67
8.6.4 Method cancelMessageErr().67
8.6.5 Method queryStatusRes().68
8.6.6 Method queryStatusErr().68
8.6.7 Method messageStatusReport().68
8.6.8 Method messageReceived().69
8.6.9 Method <> sendMessageWithNotifyRes() .69
8.6.10 Method <> sendMessageWithNotifyErr() .70
9 State Transition Diagrams.70
10 Multi-Media Messaging Service Properties .70
11 Data Definitions.71
11.1 Multi-Media Messaging data definitions.71
11.1.1 IpMultiMediaMessagingManager.71
11.1.2 IpMultiMediaMessagingManagerRef.71
11.1.3 IpAppMultiMediaMessagingManager.71
11.1.4 IpAppMultiMediaMessagingManagerRef.71
11.1.5 IpMailbox.71
11.1.6 IpMailboxRef.71
11.1.7 IpAppMailbox.71
11.1.8 IpAppMailboxRef.71
11.1.9 IpMultiMediaMessaging.71
11.1.10 IpMultiMediaMessagingRef.72
11.1.11 IpAppMultiMediaMessaging.72
11.1.12 IpAppMultiMediaMessagingRef.72
11.1.13 TpBodyPartDescription.72
11.1.14 TpBodyPartDescriptionList.72
11.1.15 TpBodyPart.72
11.1.16 TpBodyPartList.73
11.1.17 TpDeliveryTime.73
11.1.18 TpDeliveryTimeType.73
11.1.19 TpFolderInfoProperty.73
11.1.20 TpFolderInfoPropertyName.73
11.1.21 TpFolderInfoPropertySet.74
11.1.22 TpGenericHeaderField.74
11.1.23 TpListMessagesCriteria.74
11.1.24 TpMailboxFolderStatusInformation.74
11.1.25 TpMailboxIdentifier.74
11.1.26 TpMailboxIdentifierSet.74
11.1.27 TpMailboxInfoProperty.75
11.1.28 TpMailboxInfoPropertyName.75
11.1.29 TpMailboxInfoPropertySet.75
11.1.30 TpMailboxMessageStatus.75
11.1.31 TpMessageDeliveryType.76
11.1.32 TpMessageInfoProperty.76
11.1.33 TpMessageInfoPropertyName.77
11.1.34 TpMessageInfoPropertySet.77
11.1.35 TpMessageHeaderFieldType.78
11.1.36 TpMessageHeaderField.79
11.1.37 TpMessageHeaderFieldSet.
...