SIST ES 204 915-15 V1.1.1:2008

• Abstract:

  ETSI OSA APIs Phase 4. Based on ES 203 915 and the new requirements for OSA Phase 4, to produce ES 204 915 V1.1.1. ETSI OSA Phase 4 incorporates 3GPP OSA Release 7 and is also known as Parlay 6.0.The present document is part 15 of the Stage 3 specification for an Application Programming Interface (API) for Open Service Access (OSA).; The OSA specifications define an architecture that enables application developers to make use of network functionality through an open standardised interface, i.e. the OSA APIs.; The present document specifies the Multi Media Messaging Service Capability Feature (SCF) aspects of the interface.; All aspects of the Multi Media Messaging SCF are defined here, these being:; • Sequence Diagrams.; • Class Diagrams.; • Interface specification plus detailed method descriptions.; • State Transition diagrams.; • Data Definitions.; • IDL Description of the interfaces.; The process by which this task is accomplished is through the use of object modelling techniques described by the Unified Modelling Language (UML).

• Status: Published
• Publication Date: 02-Jul-2008
• ICS: 35.100.01 - Open systems interconnection in general
• Technical Committee: SPN - Services and Protocols for Networks
• Current Stage: 6060 - National Implementation/Publication (Adopted Project)
• Start Date: 11-Jun-2008
• Due Date: 16-Aug-2008
• Completion Date: 03-Jul-2008
• Ref Project: ETSI ES 204 915-15 V1.1.1 (2008-05) - Open Service Access (OSA); Application Programming Interface (API); Part 15: Multi-Media Messaging SCF (Parlay 6)

SIST ES 204 915-15 V1.1.1:2008 is an ETSI Standard for the Open Service Access (OSA) Application Programming Interface (API), Part 15 on the Multi-Media Messaging Service Capability Feature (SCF) known as Parlay 6. It specifies the service interface that lets application developers use network messaging functions through an open standardized interface, with support for both mailbox-based and non-mailbox messaging use cases.

What does SIST ES 204 915-15 V1.1.1:2008 specify?

SIST ES 204 915-15 V1.1.1:2008 specifies the Stage 3 API for the Multi Media Messaging SCF within OSA. It focuses on how applications invoke messaging functions, how the network returns results and notifications, and how the interface is described in UML-based artifacts.

The document is organized around the main interface views used to implement and test the service. Clause 5 gives sequence diagrams, clause 6 gives class diagrams, clause 7 gives the general service interface specification format, clause 8 defines the messaging interface classes, clause 9 covers state transition diagrams, clause 10 lists service properties, clause 11 defines data types, and clause 12 lists exception classes.

Annex	What it covers
Annex A	Normative OMG IDL description of the Multi-Media Messaging SCF
Annex B	Informative W3C WSDL description of the Multi-Media Messaging SCF
Annex C	Informative Java API description of the Multi-Media Messaging SCF
Annex D	Informative contents of 3GPP OSA R7 Multi-Media Messaging
Annex E	Informative description for 3GPP2 cdma2000 networks
Annex F	Informative record of changes

Clause 3 points to ES 204 915-1 for the general definitions and abbreviations used across the OSA series.

What are the key requirements of SIST ES 204 915-15 V1.1.1:2008?

SIST ES 204 915-15 V1.1.1:2008 defines how an application opens messaging objects, sends and receives messages, subscribes to notifications, and reads mailbox content. It also defines the callback methods the application must implement so the service can report asynchronous events.

Core implementation rule

Clause 4 states that if an implementation supports a method, it shall support the described functionality for at least one valid set of parameter values. If a service interface does not support a method, the call shall return P_METHOD_NOT_SUPPORTED.

That matters in practice because implementers cannot claim partial support without a working method path, and buyers can check whether the methods they need are actually available.

Service manager and callback setup

IpMultiMediaMessagingManager is the service manager for opening mailbox objects and MultiMediaMessaging objects, and for enabling or disabling event notifications. IpAppMultiMediaMessagingManager is the callback interface used by the application to receive mailbox termination reports, delivery and message notifications, and interruption or resumption notices.

IpService provides setCallback() and setCallbackWithSessionID(). That is the basic mechanism that lets the service call back into the application when results or events arrive later.

Mailbox-based messaging

IpMailbox provides mailbox access and manipulation functions such as creating folders, listing folders, listing messages, and getting message headers, content, or full messages. putMessageReq() places a message into a chosen folder, and the document explains that messages put into the folder named by the service property P_PUT_MESSAGE_FOLDER_TO_SEND are sent automatically.

This matters because mailbox use is not just storage - it can also be the sending path. The interface supports nested folders, case-sensitive names, and retrieval by folder and message identifiers.

Non-mailbox messaging

IpMultiMediaMessaging covers sending and receiving when the mailbox model is not used. Its main operations are sendMessageReq(), cancelMessageReq(), queryStatusReq(), close(), and sendMessageWithNotifyReq().

The send methods accept source and destination addresses, a TpMessageDeliveryType, a TpMessageTreatmentSet, the message body, and additional headers. In conflicts, the source and destination address parameters take priority over duplicate information in additionalHeaders. In practice, this means the caller should treat the address parameters as the authoritative routing data.

Notifications and message status

The sequence diagrams show three main event patterns: delivery and read receipts after sending, incoming message notifications, and delivery status reports requested through notification subscriptions. The document uses event criteria such as P_EVENT_MSG_NEW_MESSAGE_ARRIVED, P_EVENT_MSG_NEW_MAILBOX_MESSAGE_ARRIVED, and P_EVENT_MSG_STATUS_REPORT_ARRIVED.

IpAppMultiMediaMessaging receives the asynchronous results, including sendMessageRes(), sendMessageErr(), queryStatusRes(), messageStatusReport(), messageReceived(), and the sendMessageWithNotify response methods. In practice, this is how the application correlates an earlier request with later delivery or receipt information.

Service properties and access control

Clause 10 lists service properties for capability and policy control. P_MESSAGE_DELIVERY_TYPE and P_PUT_MESSAGE_FOLDER_TO_SEND describe service capabilities, while P_NOTIFICATION_ADDRESS_RANGES and P_SOURCE_ADDRESS_RANGES restrict which addresses can be used for notifications or as sender identities.

These properties matter for provisioning and governance because they let the service control what kinds of delivery are supported and which addresses are allowed under the service agreement.

Errors and exceptions

Clause 12 defines the exception classes used by the interface, including invalid mailbox, message, folder, part, delivery type, header, and size conditions. The methods also return messaging-specific errors such as invalid network state, resource unavailable, and resource timeout through the data definitions in clause 11.

For implementation and testing, that means client code must be prepared to handle both API-level exceptions and messaging-status errors.

What terms does SIST ES 204 915-15 V1.1.1:2008 define?

• OSA - Open Service Access, the architecture that lets application developers use network functionality through an open standardized interface.
• SCF - Service Capability Feature, the service area defined here for Multi-Media Messaging.
• UML - Unified Modelling Language, the object-modelling technique used for the sequence, class, and state representations.
• IDL - Interface Definition Language, used in Annex A for the OMG IDL description of the interface.
• IpService - The base service interface that provides callback setup for service interactions.
• Mailbox paradigm - The messaging model where messages are stored in folders inside a mailbox and can later be listed, queried, or retrieved.
• AssignmentID - The identifier returned for a request so later status, result, or error callbacks can be matched to the original operation.

Who uses SIST ES 204 915-15 V1.1.1:2008?

Application developers use SIST ES 204 915-15 V1.1.1:2008 to build client software that sends messages, receives message events, and works with mailbox content through OSA APIs. Network and platform implementers use it to expose messaging capabilities in a standard way to applications.

It is relevant to teams working with voice mail, electronic mail, Instant Messaging (IM), SMS, MMS, and GSM USSD, because the document says the MultiMedia Messaging SCF supports those messaging mechanisms and contexts. It is also useful for testers, integrators, and quality teams validating callbacks, delivery reports, message retrieval, and folder operations.

Annex E is aimed at developers working in 3GPP2 cdma2000 network environments, where the OSA Stage 3 definitions are interpreted with the stated cdma2000-specific exceptions.

Which standards are used with SIST ES 204 915-15 V1.1.1:2008?

• ETSI ES 204 915-1, Open Service Access (OSA); Application Programming Interface (API); Part 1: Overview (Parlay 6) - supplies the common definitions and abbreviations used here and defines the Java Realisation rules referenced by Annex C.
• ETSI ES 204 915-2, Common Data Definitions - provides common data types that this part references but does not redefine.
• 3GPP TS 29.198-15 V7.1.0 (Release 7) - the document is stated to be equivalent to this 3GPP part.
• UML - used as the modelling approach for the interface structure, diagrams, and state descriptions.
• OMG IDL, W3C WSDL, Java API realization rules - these are the realization formats covered in Annexes A, B, and C.

What does the SIST ES 204 915-15 V1.1.1:2008 document contain?

SIST ES 204 915-15 V1.1.1:2008 contains sequence diagrams for sending messages, receiving delivery notifications, using the same communication context for send and receive, subscribing to message arrival notifications, browsing a mailbox, using a mailbox for send and receive, and requesting status reports. It also contains class diagrams, detailed interface method descriptions, parameter definitions, and callback interfaces for the manager, mailbox, and message objects.

Clause 10 provides service-property tables for capability and policy control, while clause 11 expands the messaging data types, event notification data types, and error data types used by the methods. Clause 12 lists the exception classes and their meanings.

Clause 9 states that there are no State Transition Diagrams for the Multi-Media Messaging SCF, and the annexes provide alternative technical representations in IDL, WSDL, and Java, plus the 3GPP OSA R7 and cdma2000 contextual notes and a record of changes.

Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 15: Multi-Media Messaging SCF
(Parlay 6)
�
2 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)

Reference
DES/TISPAN-01032-15-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

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.
© The Parlay Group 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
3 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
Contents
Intellectual Property Rights.8
Foreword.8
1 Scope.9
2 References.9
3 Definitions and abbreviations.9
3.1 Definitions.9
3.2 Abbreviations.9
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 .13
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.20
7.1 Interface Specification Format .20
7.1.1 Interface Class.20
7.1.2 Method descriptions.20
7.1.3 Parameter descriptions.20
7.1.4 State Model.20
7.2 Base Interface.20
7.2.1 Interface Class IpInterface .20
7.3 Service Interfaces.21
7.3.1 Overview.21
7.4 Generic Service Interface .21
7.4.1 Interface Class IpService .21
7.4.1.1 Method setCallback().21
7.4.1.2 Method setCallbackWithSessionID().21
8 Multi Media Messaging Interface Classes .22
8.1 Interface Class IpMultiMediaMessagingManager .22
8.1.1 Method openMailbox().23
8.1.2 Method openMultiMediaMessaging().24
8.1.3 Method createNotification().25
8.1.4 Method destroyNotification().25
8.1.5 Method changeNotification().26
8.1.6 Method getNextNotification().26
8.1.7 Method enableNotifications().27
8.1.8 Method disableNotifications().27
8.2 Interface Class IpAppMultiMediaMessagingManager.27
8.2.1 Method mailboxTerminated().28
8.2.2 Method reportNotification().28
8.2.3 Method notificationsInterrupted().29
8.2.4 Method notificationsResumed().29
8.2.5 Method multiMediaMessagingTerminated().29
8.2.6 Method terminateMultipleMailboxes().29
8.2.7 Method terminateMultipleMultiMediaMessagingSessions().29
8.3 Interface Class IpMailbox .30
8.3.1 Method close().31
8.3.2 Method getMessageInfoPropertiesReq().31
ETSI
4 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
8.3.3 Method setMessageInfoPropertiesReq().31
8.3.4 Method createFolderReq().32
8.3.5 Method getFoldersReq().32
8.3.6 Method deleteFolderReq().33
8.3.7 Method copyFolderReq().33
8.3.8 Method moveFolderReq().34
8.3.9 Method putMessageReq().34
8.3.10 Method copyMessageReq().35
8.3.11 Method moveMessageReq().36
8.3.12 Method deleteMessageReq().36
8.3.13 Method listMessagesReq().37
8.3.14 Method listMessageBodyPartsReq().37
8.3.15 Method getMessageBodyPartsReq().38
8.3.16 Method getMessageHeadersReq().39
8.3.17 Method getMessageContentReq().39
8.3.18 Method getFullMessageReq().40
8.3.19 Method getMailboxInfoPropertiesReq().40
8.3.20 Method getFolderInfoPropertiesReq().41
8.4 Interface Class IpAppMailbox .41
8.4.1 Method getMessageInfoPropertiesRes().43
8.4.2 Method setMessageInfoPropertiesRes().43
8.4.3 Method setMessageInfoPropertiesErr().44
8.4.4 Method getMailboxInfoPropertiesErr().44
8.4.5 Method getFolderInfoPropertiesErr().44
8.4.6 Method getMessageInfoPropertiesErr().45
8.4.7 Method createFolderRes().45
8.4.8 Method createFolderErr().46
8.4.9 Method getFoldersRes().46
8.4.10 Method getFoldersErr().46
8.4.11 Method deleteFolderRes().47
8.4.12 Method deleteFolderErr().47
8.4.13 Method copyFolderRes().47
8.4.14 Method copyFolderErr().48
8.4.15 Method moveFolderRes().48
8.4.16 Method moveFolderErr().48
8.4.17 Method putMessageRes().49
8.4.18 Method putMessageErr().49
8.4.19 Method copyMessageRes().49
8.4.20 Method copyMessageErr().50
8.4.21 Method moveMessageRes().50
8.4.22 Method moveMessageErr().50
8.4.23 Method deleteMessageRes().51
8.4.24 Method deleteMessageErr().51
8.4.25 Method listMessagesRes().51
8.4.26 Method listMessagesErr().52
8.4.27 Method listMessageBodyPartsRes().52
8.4.28 Method listMessageBodyPartsErr().52
8.4.29 Method getMessageBodyPartsRes().53
8.4.30 Method getMessageBodyPartsErr().53
8.4.31 Method getMessageHeadersRes().53
8.4.32 Method getMessageHeadersErr().54
8.4.33 Method getMessageContentRes().54
8.4.34 Method getMessageContentErr().55
8.4.35 Method getFullMessageRes().55
8.4.36 Method getFullMessageErr().55
8.4.37 Method getMailboxInfoPropertiesRes().56
8.4.38 Method getFolderInfoPropertiesRes().56
8.5 Interface Class IpMultiMediaMessaging.56
8.5.1 Method sendMessageReq().57
8.5.2 Method cancelMessageReq().58
8.5.3 Method queryStatusReq().58
8.5.4 Method close().59
ETSI
5 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
8.5.5 Method sendMessageWithNotifyReq().59
8.6 Interface Class IpAppMultiMediaMessaging.60
8.6.1 Method sendMessageRes().61
8.6.2 Method sendMessageErr().61
8.6.3 Method cancelMessageRes().62
8.6.4 Method cancelMessageErr().62
8.6.5 Method queryStatusRes().62
8.6.6 Method queryStatusErr().63
8.6.7 Method messageStatusReport().63
8.6.8 Method messageReceived().64
8.6.9 Method sendMessageWithNotifyRes().64
8.6.10 Method sendMessageWithNotifyErr().64
9 State Transition Diagrams.65
10 Multi-Media Messaging Service Properties .65
11 Data Definitions.65
11.1 Multi-Media Messaging data definitions.66
11.1.1 IpMultiMediaMessagingManager.66
11.1.2 IpMultiMediaMessagingManagerRef.66
11.1.3 IpAppMultiMediaMessagingManager.66
11.1.4 IpAppMultiMediaMessagingManagerRef.66
11.1.5 IpMailbox.66
11.1.6 IpMailboxRef.66
11.1.7 IpAppMailbox.66
11.1.8 IpAppMailboxRef.66
11.1.9 IpMultiMediaMessaging.66
11.1.10 IpMultiMediaMessagingRef.66
11.1.11 IpAppMultiMediaMessaging.66
11.1.12 IpAppMultiMediaMessagingRef.66
11.1.13 TpBodyPartDescription.67
11.1.14 TpBodyPartDescriptionList.67
11.1.15 TpBodyPart.67
11.1.16 TpBodyPartList.67
11.1.17 TpDeliveryTime.67
11.1.18 TpDeliveryTimeType.68
11.1.19 TpFolderInfoProperty.68
11.1.20 TpFolderInfoPropertyName.68
11.1.21 TpFolderInfoPropertySet.68
11.1.22 TpGenericHeaderField.69
11.1.23 TpListMessagesCriteria.69
11.1.24 TpMailboxFolderStatusInformation.69
11.1.25 TpMailboxIdentifier.69
11.1.26 TpMailboxIdentifierSet.69
11.1.27 TpMailboxInfoProperty.69
11.1.28 TpMailboxInfoPropertyName.70
11.1.29 TpMailboxInfoPropertySet.70
11.1.30 TpMailboxMessageStatus.70
11.1.31 TpMessageDeliveryType.71
11.1.32 TpMessageInfoProperty.71
11.1.33 TpMessageInfoPropertyName.71
11.1.34 TpMessageInfoPropertySet.71
11.1.35 TpMessageHeaderFieldType.72
11.1.36 TpMessageHeaderField.73
11.1.37 TpMessageHeaderFieldSet.73
11.1.38 TpMessagePriority.73
11.1.39 TpMessageDeliveryReportType.74
11.1.40 TpMessageTreatment.74
11.1.41 TpMessageTreatmentType.74
11.1.42 TpMessageTreatmentSet.74
11.1.43 TpMultiMediaMessagingIdentifier.75
11.1.44 TpMultiMediaMessagingIdentifierSet.75
ETSI
6 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
11.1.45 TpQueryStatusReport.75
11.1.46 TpQueryStatusReportSet.75
11.1.47 TpTerminatingAddressList.75
11.2 Event Notification data definitions.75
11.2.1 TpMessagingEventName.75
11.2.2 TpMessagingEventCriteria.76
11.2.3 TpMessagingEventCriteriaSet.76
11.2.4 TpNewMailboxMessageArrivedCriteria.76
11.2.5 TpNewMessageArrivedCriteria.76
11.2.6 TpMessagingEventInfo.77
11.2.7 TpMessagingEventInfoSet.77
11.2.8 TpNewMailboxMessageArrivedInfo.77
11.2.9 TpNewMessageArrivedInfo.77
11.2.10 TpMessageDescription.78
11.2.11 TpMessageDescriptionList.78
11.2.12 TpMessagingNotificationRequested.78
11.2.13 TpMessagingNotificationRequestedSet.78
11.2.14 TpMessagingNotificationRequestedSetEntry.78
11.2.15 TpNewMessageStatusReportArrivedInfo.79
11.3 Error type data definitions.79
11.3.1 TpMessageInfoPropertyError.79
11.3.2 TpMessagingError .79
11.3.3 TpMessageInfoPropertyErrorSet.80
11.3.4 TpSetPropertyError.80
12 Exception Classes.80
Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .82
Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF.83
Annex C (informative): Java API Description of the Multi-Media Messaging SCF.84
Annex D (informative): Contents of 3GPP OSA R7 Multi-Media Messaging .85
Annex E (informative): Description of Multi Media Messaging for 3GPP2 cdma2000
networks.86
E.1 General Exceptions.86
E.2 Specific Exceptions.86
E.2.1 Clause 1: Scope .86
E.2.2 Clause 2: References .86
E.2.3 Clause 3: Definitions and abbreviations.86
E.2.4 Clause 4: Multi Media Messaging SCF.86
E.2.5 Clause 5: Sequence Diagrams .86
E.2.6 Clause 6: Class Diagrams.86
E.2.7 Clause 7: The Service Interface Specifications .86
E.2.8 Clause 8: Multi Media Messaging Interface Classes.87
E.2.9 Clause 9: State Transition Diagrams .87
E.2.10 Clause 10: Multi-Media Messaging Service Properties .87
E.2.11 Clause 11: Data Definitions.87
E.2.12 Clause 12: Exception Classes.87
E.2.13 Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .87
E.2.14 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF .87
E.2.15 Annex C (informative): Java API Description of the Multi-Media Messaging SCF.87
Annex F (informative): Record of changes .88
F.1 Interfaces.88
F.1.1 New.88
F.1.2 Deprecated.88
F.1.3 Removed.88
ETSI
7 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
F.2 Methods.88
F.2.1 New.88
F.2.2 Deprecated.88
F.2.3 Modified.89
F.2.4 Removed.89
F.3 Data Definitions.89
F.3.1 New.89
F.3.2 Modified.89
F.3.3 Removed.89
F.4 Service Properties.89
F.4.1 New.89
F.4.2 Deprecated.90
F.4.3 Modified.90
F.4.4 Removed.90
F.5 Exceptions.90
F.5.1 New.90
F.5.2 Modified.90
F.5.3 Removed.90
F.6 Others.90
History .91

ETSI
8 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
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 ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet
converged Services and Protocols for Advanced Networking (TISPAN), and is now submitted for the ETSI standards
Membership Approval Procedure.
The present document is part 15 of a multi-part deliverable covering Open Service Access (OSA); Application
Programming Interface (API), as identified below. The API specification (ES 204 915) is structured in the following
parts:
Part 1: "Overview";
Part 2: "Common Data Definitions";
Part 3: "Framework";
Part 4: "Call Control";
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";
Part 10: "Connectivity Manager SCF";
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".
The present document has been defined jointly between ETSI, The Parlay Group (http://www.parlay.org) and the 3GPP,
in co-operation with a number of JAIN™ Community (http://www.java.sun.com/products/jain) member companies.
The present document forms part of the Parlay 6.0 set of specifications.
The present document is equivalent to 3GPP TS 29.198-15 V7.1.0 (Release 7).
ETSI
9 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
1 Scope
The present document is part 15 of the Stage 3 specification for an Application Programming Interface (API) for Open
Service Access (OSA).
The OSA specifications define an architecture that enables application developers to make use of network functionality
through an open standardised interface, i.e. the OSA APIs.
The present document specifies the Multi Media Messaging Service Capability Feature (SCF) aspects of the interface.
All aspects of the Multi Media Messaging SCF are defined here, these being:
• Sequence Diagrams.
• Class Diagrams.
• Interface specification plus detailed method descriptions.
• State Transition diagrams.
• Data Definitions.
• IDL Description of the interfaces.
The process by which this task is accomplished is through the use of object modelling techniques described by the
Unified Modelling Language (UML).
2 References
The references listed in clause 2 of ES 204 915-1 contain provisions which, through reference in this text, constitute
provisions of the present document.
ETSI ES 204 915-1: "Open Service Access (OSA); Application Programming Interface (API); Part 1: Overview
(Parlay 6)".
3 Definitions and abbreviations
3.1 Definitions
For the purposes of the present document, the terms and definitions given in ES 204 915-1 apply.
3.2 Abbreviations
For the purposes of the present document, the abbreviations given in ES 204 915-1 apply.
ETSI
10 Final draft ETSI ES 204 915-15 V1.1.1 (2008-02)
4 Multi Media Messaging SCF
The following clauses describe each aspect of the Multi Media Messaging Service Capability Feature (SCF).
The order is as follows:
• The Sequence diagrams give the reader a practical idea of how each of the SCF is implemented.
• The Class relationships clause s
...

ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 15: Multi-Media Messaging SCF
(Parlay 6)
�
2 ETSI ES 204 915-15 V1.1.1 (2008-05)

Reference
DES/TISPAN-01032-15-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

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.
© The Parlay Group 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
3 ETSI ES 204 915-15 V1.1.1 (2008-05)
Contents
Intellectual Property Rights.8
Foreword.8
1 Scope.9
2 References.9
3 Definitions and abbreviations.9
3.1 Definitions.9
3.2 Abbreviations.9
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 .13
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.20
7.1 Interface Specification Format .20
7.1.1 Interface Class.20
7.1.2 Method descriptions.20
7.1.3 Parameter descriptions.20
7.1.4 State Model.20
7.2 Base Interface.20
7.2.1 Interface Class IpInterface .20
7.3 Service Interfaces.21
7.3.1 Overview.21
7.4 Generic Service Interface .21
7.4.1 Interface Class IpService .21
7.4.1.1 Method setCallback().21
7.4.1.2 Method setCallbackWithSessionID().21
8 Multi Media Messaging Interface Classes .22
8.1 Interface Class IpMultiMediaMessagingManager .22
8.1.1 Method openMailbox().23
8.1.2 Method openMultiMediaMessaging().24
8.1.3 Method createNotification().25
8.1.4 Method destroyNotification().25
8.1.5 Method changeNotification().26
8.1.6 Method getNextNotification().26
8.1.7 Method enableNotifications().27
8.1.8 Method disableNotifications().27
8.2 Interface Class IpAppMultiMediaMessagingManager.27
8.2.1 Method mailboxTerminated().28
8.2.2 Method reportNotification().28
8.2.3 Method notificationsInterrupted().29
8.2.4 Method notificationsResumed().29
8.2.5 Method multiMediaMessagingTerminated().29
8.2.6 Method terminateMultipleMailboxes().29
8.2.7 Method terminateMultipleMultiMediaMessagingSessions().29
8.3 Interface Class IpMailbox .30
8.3.1 Method close().31
8.3.2 Method getMessageInfoPropertiesReq().31
ETSI
4 ETSI ES 204 915-15 V1.1.1 (2008-05)
8.3.3 Method setMessageInfoPropertiesReq().31
8.3.4 Method createFolderReq().32
8.3.5 Method getFoldersReq().32
8.3.6 Method deleteFolderReq().33
8.3.7 Method copyFolderReq().33
8.3.8 Method moveFolderReq().34
8.3.9 Method putMessageReq().34
8.3.10 Method copyMessageReq().35
8.3.11 Method moveMessageReq().36
8.3.12 Method deleteMessageReq().36
8.3.13 Method listMessagesReq().37
8.3.14 Method listMessageBodyPartsReq().37
8.3.15 Method getMessageBodyPartsReq().38
8.3.16 Method getMessageHeadersReq().39
8.3.17 Method getMessageContentReq().39
8.3.18 Method getFullMessageReq().40
8.3.19 Method getMailboxInfoPropertiesReq().40
8.3.20 Method getFolderInfoPropertiesReq().41
8.4 Interface Class IpAppMailbox .41
8.4.1 Method getMessageInfoPropertiesRes().43
8.4.2 Method setMessageInfoPropertiesRes().43
8.4.3 Method setMessageInfoPropertiesErr().44
8.4.4 Method getMailboxInfoPropertiesErr().44
8.4.5 Method getFolderInfoPropertiesErr().44
8.4.6 Method getMessageInfoPropertiesErr().45
8.4.7 Method createFolderRes().45
8.4.8 Method createFolderErr().46
8.4.9 Method getFoldersRes().46
8.4.10 Method getFoldersErr().46
8.4.11 Method deleteFolderRes().47
8.4.12 Method deleteFolderErr().47
8.4.13 Method copyFolderRes().47
8.4.14 Method copyFolderErr().48
8.4.15 Method moveFolderRes().48
8.4.16 Method moveFolderErr().48
8.4.17 Method putMessageRes().49
8.4.18 Method putMessageErr().49
8.4.19 Method copyMessageRes().49
8.4.20 Method copyMessageErr().50
8.4.21 Method moveMessageRes().50
8.4.22 Method moveMessageErr().50
8.4.23 Method deleteMessageRes().51
8.4.24 Method deleteMessageErr().51
8.4.25 Method listMessagesRes().51
8.4.26 Method listMessagesErr().52
8.4.27 Method listMessageBodyPartsRes().52
8.4.28 Method listMessageBodyPartsErr().52
8.4.29 Method getMessageBodyPartsRes().53
8.4.30 Method getMessageBodyPartsErr().53
8.4.31 Method getMessageHeadersRes().53
8.4.32 Method getMessageHeadersErr().54
8.4.33 Method getMessageContentRes().54
8.4.34 Method getMessageContentErr().55
8.4.35 Method getFullMessageRes().55
8.4.36 Method getFullMessageErr().55
8.4.37 Method getMailboxInfoPropertiesRes().56
8.4.38 Method getFolderInfoPropertiesRes().56
8.5 Interface Class IpMultiMediaMessaging.56
8.5.1 Method sendMessageReq().57
8.5.2 Method cancelMessageReq().58
8.5.3 Method queryStatusReq().58
8.5.4 Method close().59
ETSI
5 ETSI ES 204 915-15 V1.1.1 (2008-05)
8.5.5 Method sendMessageWithNotifyReq().59
8.6 Interface Class IpAppMultiMediaMessaging.60
8.6.1 Method sendMessageRes().61
8.6.2 Method sendMessageErr().61
8.6.3 Method cancelMessageRes().62
8.6.4 Method cancelMessageErr().62
8.6.5 Method queryStatusRes().62
8.6.6 Method queryStatusErr().63
8.6.7 Method messageStatusReport().63
8.6.8 Method messageReceived().64
8.6.9 Method sendMessageWithNotifyRes().64
8.6.10 Method sendMessageWithNotifyErr().64
9 State Transition Diagrams.65
10 Multi-Media Messaging Service Properties .65
11 Data Definitions.65
11.1 Multi-Media Messaging data definitions.66
11.1.1 IpMultiMediaMessagingManager.66
11.1.2 IpMultiMediaMessagingManagerRef.66
11.1.3 IpAppMultiMediaMessagingManager.66
11.1.4 IpAppMultiMediaMessagingManagerRef.66
11.1.5 IpMailbox.66
11.1.6 IpMailboxRef.66
11.1.7 IpAppMailbox.66
11.1.8 IpAppMailboxRef.66
11.1.9 IpMultiMediaMessaging.66
11.1.10 IpMultiMediaMessagingRef.66
11.1.11 IpAppMultiMediaMessaging.66
11.1.12 IpAppMultiMediaMessagingRef.66
11.1.13 TpBodyPartDescription.67
11.1.14 TpBodyPartDescriptionList.67
11.1.15 TpBodyPart.67
11.1.16 TpBodyPartList.67
11.1.17 TpDeliveryTime.67
11.1.18 TpDeliveryTimeType.68
11.1.19 TpFolderInfoProperty.68
11.1.20 TpFolderInfoPropertyName.68
11.1.21 TpFolderInfoPropertySet.68
11.1.22 TpGenericHeaderField.69
11.1.23 TpListMessagesCriteria.69
11.1.24 TpMailboxFolderStatusInformation.69
11.1.25 TpMailboxIdentifier.69
11.1.26 TpMailboxIdentifierSet.69
11.1.27 TpMailboxInfoProperty.69
11.1.28 TpMailboxInfoPropertyName.70
11.1.29 TpMailboxInfoPropertySet.70
11.1.30 TpMailboxMessageStatus.70
11.1.31 TpMessageDeliveryType.71
11.1.32 TpMessageInfoProperty.71
11.1.33 TpMessageInfoPropertyName.71
11.1.34 TpMessageInfoPropertySet.71
11.1.35 TpMessageHeaderFieldType.72
11.1.36 TpMessageHeaderField.73
11.1.37 TpMessageHeaderFieldSet.73
11.1.38 TpMessagePriority.73
11.1.39 TpMessageDeliveryReportType.74
11.1.40 TpMessageTreatment.74
11.1.41 TpMessageTreatmentType.74
11.1.42 TpMessageTreatmentSet.74
11.1.43 TpMultiMediaMessagingIdentifier.75
11.1.44 TpMultiMediaMessagingIdentifierSet.75
ETSI
6 ETSI ES 204 915-15 V1.1.1 (2008-05)
11.1.45 TpQueryStatusReport.75
11.1.46 TpQueryStatusReportSet.75
11.1.47 TpTerminatingAddressList.75
11.2 Event Notification data definitions.75
11.2.1 TpMessagingEventName.75
11.2.2 TpMessagingEventCriteria.76
11.2.3 TpMessagingEventCriteriaSet.76
11.2.4 TpNewMailboxMessageArrivedCriteria.76
11.2.5 TpNewMessageArrivedCriteria.76
11.2.6 TpMessagingEventInfo.77
11.2.7 TpMessagingEventInfoSet.77
11.2.8 TpNewMailboxMessageArrivedInfo.77
11.2.9 TpNewMessageArrivedInfo.77
11.2.10 TpMessageDescription.78
11.2.11 TpMessageDescriptionList.78
11.2.12 TpMessagingNotificationRequested.78
11.2.13 TpMessagingNotificationRequestedSet.78
11.2.14 TpMessagingNotificationRequestedSetEntry.78
11.2.15 TpNewMessageStatusReportArrivedInfo.79
11.3 Error type data definitions.79
11.3.1 TpMessageInfoPropertyError.79
11.3.2 TpMessagingError .79
11.3.3 TpMessageInfoPropertyErrorSet.80
11.3.4 TpSetPropertyError.80
12 Exception Classes.80
Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .82
Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF.83
Annex C (informative): Java API Description of the Multi-Media Messaging SCF.84
Annex D (informative): Contents of 3GPP OSA R7 Multi-Media Messaging .85
Annex E (informative): Description of Multi Media Messaging for 3GPP2 cdma2000
networks.86
E.1 General Exceptions.86
E.2 Specific Exceptions.86
E.2.1 Clause 1: Scope .86
E.2.2 Clause 2: References .86
E.2.3 Clause 3: Definitions and abbreviations.86
E.2.4 Clause 4: Multi Media Messaging SCF.86
E.2.5 Clause 5: Sequence Diagrams .86
E.2.6 Clause 6: Class Diagrams.86
E.2.7 Clause 7: The Service Interface Specifications .86
E.2.8 Clause 8: Multi Media Messaging Interface Classes.87
E.2.9 Clause 9: State Transition Diagrams .87
E.2.10 Clause 10: Multi-Media Messaging Service Properties .87
E.2.11 Clause 11: Data Definitions.87
E.2.12 Clause 12: Exception Classes.87
E.2.13 Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .87
E.2.14 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF .87
E.2.15 Annex C (informative): Java API Description of the Multi-Media Messaging SCF.87
Annex F (informative): Record of changes .88
F.1 Interfaces.88
F.1.1 New.88
F.1.2 Deprecated.88
F.1.3 Removed.88
ETSI
7 ETSI ES 204 915-15 V1.1.1 (2008-05)
F.2 Methods.88
F.2.1 New.88
F.2.2 Deprecated.88
F.2.3 Modified.89
F.2.4 Removed.89
F.3 Data Definitions.89
F.3.1 New.89
F.3.2 Modified.89
F.3.3 Removed.89
F.4 Service Properties.89
F.4.1 New.89
F.4.2 Deprecated.90
F.4.3 Modified.90
F.4.4 Removed.90
F.5 Exceptions.90
F.5.1 New.90
F.5.2 Modified.90
F.5.3 Removed.90
F.6 Others.90
History .91

ETSI
8 ETSI ES 204 915-15 V1.1.1 (2008-05)
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 ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet
converged Services and Protocols for Advanced Networking (TISPAN).
The present document is part 15 of a multi-part deliverable covering Open Service Access (OSA); Application
Programming Interface (API), as identified below. The API specification (ES 204 915) is structured in the following
parts:
Part 1: "Overview";
Part 2: "Common Data Definitions";
Part 3: "Framework";
Part 4: "Call Control";
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";
Part 10: "Connectivity Manager SCF";
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".
The present document has been defined jointly between ETSI, The Parlay Group (http://www.parlay.org) and the 3GPP,
in co-operation with a number of JAIN™ Community (http://www.java.sun.com/products/jain) member companies.
The present document forms part of the Parlay 6.0 set of specifications.
The present document is equivalent to 3GPP TS 29.198-15 V7.1.0 (Release 7).
ETSI
9 ETSI ES 204 915-15 V1.1.1 (2008-05)
1 Scope
The present document is part 15 of the Stage 3 specification for an Application Programming Interface (API) for Open
Service Access (OSA).
The OSA specifications define an architecture that enables application developers to make use of network functionality
through an open standardised interface, i.e. the OSA APIs.
The present document specifies the Multi Media Messaging Service Capability Feature (SCF) aspects of the interface.
All aspects of the Multi Media Messaging SCF are defined here, these being:
• Sequence Diagrams.
• Class Diagrams.
• Interface specification plus detailed method descriptions.
• State Transition diagrams.
• Data Definitions.
• IDL Description of the interfaces.
The process by which this task is accomplished is through the use of object modelling techniques described by the
Unified Modelling Language (UML).
2 References
The references listed in clause 2 of ES 204 915-1 contain provisions which, through reference in this text, constitute
provisions of the present document.
ETSI ES 204 915-1: "Open Service Access (OSA); Application Programming Interface (API); Part 1: Overview
(Parlay 6)".
3 Definitions and abbreviations
3.1 Definitions
For the purposes of the present document, the terms and definitions given in ES 204 915-1 apply.
3.2 Abbreviations
For the purposes of the present document, the abbreviations given in ES 204 915-1 apply.
ETSI
10 ETSI ES 204 915-15 V1.1.1 (2008-05)
4 Multi Media Messaging SCF
The following clauses describe each aspect of the Multi Media Messaging Service Capability Feature (SCF).
The order is as follows:
• The Sequence diagrams give the reader a practical idea of how each of the SCF is implemented.
• The Class relationships clause shows how each of the interfaces applicable to the SCF, relate to one another.
• The Interface specification clause describes in detail each of the interfaces shown within the Class diagram
part.
...

SLOVENSKI STANDARD
01-september-2008
2GSUWLGRVWRSGRVWRULWYH26$$SOLNDFLMVNLSURJUDPVNLYPHVQLN$3,GHO
/DVWQRVWVWRULWYHQH]PRåQRVWL6&)]DYHþSUHGVWDYQRVWQRVSRURþDQMH3DUOD\
Open Service Access (OSA) - Application Programming Interface (API) - Part 15: Multi-
Media Messaging SCF (Parlay 6)
Ta slovenski standard je istoveten z: ES 204 915-15 Version 1.1.1
ICS:
35.100.01 Medsebojno povezovanje Open systems
odprtih sistemov na splošno interconnection in general
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 15: Multi-Media Messaging SCF
(Parlay 6)
�
2 ETSI ES 204 915-15 V1.1.1 (2008-05)

Reference
DES/TISPAN-01032-15-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

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.
© The Parlay Group 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
3 ETSI ES 204 915-15 V1.1.1 (2008-05)
Contents
Intellectual Property Rights.8
Foreword.8
1 Scope.9
2 References.9
3 Definitions and abbreviations.9
3.1 Definitions.9
3.2 Abbreviations.9
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 .13
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.20
7.1 Interface Specification Format .20
7.1.1 Interface Class.20
7.1.2 Method descriptions.20
7.1.3 Parameter descriptions.20
7.1.4 State Model.20
7.2 Base Interface.20
7.2.1 Interface Class IpInterface .20
7.3 Service Interfaces.21
7.3.1 Overview.21
7.4 Generic Service Interface .21
7.4.1 Interface Class IpService .21
7.4.1.1 Method setCallback().21
7.4.1.2 Method setCallbackWithSessionID().21
8 Multi Media Messaging Interface Classes .22
8.1 Interface Class IpMultiMediaMessagingManager .22
8.1.1 Method openMailbox().23
8.1.2 Method openMultiMediaMessaging().24
8.1.3 Method createNotification().25
8.1.4 Method destroyNotification().25
8.1.5 Method changeNotification().26
8.1.6 Method getNextNotification().26
8.1.7 Method enableNotifications().27
8.1.8 Method disableNotifications().27
8.2 Interface Class IpAppMultiMediaMessagingManager.27
8.2.1 Method mailboxTerminated().28
8.2.2 Method reportNotification().28
8.2.3 Method notificationsInterrupted().29
8.2.4 Method notificationsResumed().29
8.2.5 Method multiMediaMessagingTerminated().29
8.2.6 Method terminateMultipleMailboxes().29
8.2.7 Method terminateMultipleMultiMediaMessagingSessions().29
8.3 Interface Class IpMailbox .30
8.3.1 Method close().31
8.3.2 Method getMessageInfoPropertiesReq().31
ETSI
4 ETSI ES 204 915-15 V1.1.1 (2008-05)
8.3.3 Method setMessageInfoPropertiesReq().31
8.3.4 Method createFolderReq().32
8.3.5 Method getFoldersReq().32
8.3.6 Method deleteFolderReq().33
8.3.7 Method copyFolderReq().33
8.3.8 Method moveFolderReq().34
8.3.9 Method putMessageReq().34
8.3.10 Method copyMessageReq().35
8.3.11 Method moveMessageReq().36
8.3.12 Method deleteMessageReq().36
8.3.13 Method listMessagesReq().37
8.3.14 Method listMessageBodyPartsReq().37
8.3.15 Method getMessageBodyPartsReq().38
8.3.16 Method getMessageHeadersReq().39
8.3.17 Method getMessageContentReq().39
8.3.18 Method getFullMessageReq().40
8.3.19 Method getMailboxInfoPropertiesReq().40
8.3.20 Method getFolderInfoPropertiesReq().41
8.4 Interface Class IpAppMailbox .41
8.4.1 Method getMessageInfoPropertiesRes().43
8.4.2 Method setMessageInfoPropertiesRes().43
8.4.3 Method setMessageInfoPropertiesErr().44
8.4.4 Method getMailboxInfoPropertiesErr().44
8.4.5 Method getFolderInfoPropertiesErr().44
8.4.6 Method getMessageInfoPropertiesErr().45
8.4.7 Method createFolderRes().45
8.4.8 Method createFolderErr().46
8.4.9 Method getFoldersRes().46
8.4.10 Method getFoldersErr().46
8.4.11 Method deleteFolderRes().47
8.4.12 Method deleteFolderErr().47
8.4.13 Method copyFolderRes().47
8.4.14 Method copyFolderErr().48
8.4.15 Method moveFolderRes().48
8.4.16 Method moveFolderErr().48
8.4.17 Method putMessageRes().49
8.4.18 Method putMessageErr().49
8.4.19 Method copyMessageRes().49
8.4.20 Method copyMessageErr().50
8.4.21 Method moveMessageRes().50
8.4.22 Method moveMessageErr().50
8.4.23 Method deleteMessageRes().51
8.4.24 Method deleteMessageErr().51
8.4.25 Method listMessagesRes().51
8.4.26 Method listMessagesErr().52
8.4.27 Method listMessageBodyPartsRes().52
8.4.28 Method listMessageBodyPartsErr().52
8.4.29 Method getMessageBodyPartsRes().53
8.4.30 Method getMessageBodyPartsErr().53
8.4.31 Method getMessageHeadersRes().53
8.4.32 Method getMessageHeadersErr().54
8.4.33 Method getMessageContentRes().54
8.4.34 Method getMessageContentErr().55
8.4.35 Method getFullMessageRes().55
8.4.36 Method getFullMessageErr().55
8.4.37 Method getMailboxInfoPropertiesRes().56
8.4.38 Method getFolderInfoPropertiesRes().56
8.5 Interface Class IpMultiMediaMessaging.56
8.5.1 Method sendMessageReq().57
8.5.2 Method cancelMessageReq().58
8.5.3 Method queryStatusReq().58
8.5.4 Method close().59
ETSI
5 ETSI ES 204 915-15 V1.1.1 (2008-05)
8.5.5 Method sendMessageWithNotifyReq().59
8.6 Interface Class IpAppMultiMediaMessaging.60
8.6.1 Method sendMessageRes().61
8.6.2 Method sendMessageErr().61
8.6.3 Method cancelMessageRes().62
8.6.4 Method cancelMessageErr().62
8.6.5 Method queryStatusRes().62
8.6.6 Method queryStatusErr().63
8.6.7 Method messageStatusReport().63
8.6.8 Method messageReceived().64
8.6.9 Method sendMessageWithNotifyRes().64
8.6.10 Method sendMessageWithNotifyErr().64
9 State Transition Diagrams.65
10 Multi-Media Messaging Service Properties .65
11 Data Definitions.65
11.1 Multi-Media Messaging data definitions.66
11.1.1 IpMultiMediaMessagingManager.66
11.1.2 IpMultiMediaMessagingManagerRef.66
11.1.3 IpAppMultiMediaMessagingManager.66
11.1.4 IpAppMultiMediaMessagingManagerRef.66
11.1.5 IpMailbox.66
11.1.6 IpMailboxRef.66
11.1.7 IpAppMailbox.66
11.1.8 IpAppMailboxRef.66
11.1.9 IpMultiMediaMessaging.66
11.1.10 IpMultiMediaMessagingRef.66
11.1.11 IpAppMultiMediaMessaging.66
11.1.12 IpAppMultiMediaMessagingRef.66
11.1.13 TpBodyPartDescription.67
11.1.14 TpBodyPartDescriptionList.67
11.1.15 TpBodyPart.67
11.1.16 TpBodyPartList.67
11.1.17 TpDeliveryTime.67
11.1.18 TpDeliveryTimeType.68
11.1.19 TpFolderInfoProperty.68
11.1.20 TpFolderInfoPropertyName.68
11.1.21 TpFolderInfoPropertySet.68
11.1.22 TpGenericHeaderField.69
11.1.23 TpListMessagesCriteria.69
11.1.24 TpMailboxFolderStatusInformation.69
11.1.25 TpMailboxIdentifier.69
11.1.26 TpMailboxIdentifierSet.69
11.1.27 TpMailboxInfoProperty.69
11.1.28 TpMailboxInfoPropertyName.70
11.1.29 TpMailboxInfoPropertySet.70
11.1.30 TpMailboxMessageStatus.70
11.1.31 TpMessageDeliveryType.71
11.1.32 TpMessageInfoProperty.71
11.1.33 TpMessageInfoPropertyName.71
11.1.34 TpMessageInfoPropertySet.71
11.1.35 TpMessageHeaderFieldType.72
11.1.36 TpMessageHeaderField.73
11.1.37 TpMessageHeaderFieldSet.73
11.1.38 TpMessagePriority.73
11.1.39 TpMessageDeliveryReportType.74
11.1.40 TpMessageTreatment.74
11.1.41 TpMessageTreatmentType.74
11.1.42 TpMessageTreatmentSet.74
11.1.43 TpMultiMediaMessagingIdentifier.75
11.1.44 TpMultiMediaMessagingIdentifierSet.75
ETSI
6 ETSI ES 204 915-15 V1.1.1 (2008-05)
11.1.45 TpQueryStatusReport.75
11.1.46 TpQueryStatusReportSet.75
11.1.47 TpTerminatingAddressList.75
11.2 Event Notification data definitions.75
11.2.1 TpMessagingEventName.75
11.2.2 TpMessagingEventCriteria.76
11.2.3 TpMessagingEventCriteriaSet.76
11.2.4 TpNewMailboxMessageArrivedCriteria.76
11.2.5 TpNewMessageArrivedCriteria.76
11.2.6 TpMessagingEventInfo.77
11.2.7 TpMessagingEventInfoSet.77
11.2.8 TpNewMailboxMessageArrivedInfo.77
11.2.9 TpNewMessageArrivedInfo.77
11.2.10 TpMessageDescription.78
11.2.11 TpMessageDescriptionList.78
11.2.12 TpMessagingNotificationRequested.78
11.2.13 TpMessagingNotificationRequestedSet.78
11.2.14 TpMessagingNotificationRequestedSetEntry.78
11.2.15 TpNewMessageStatusReportArrivedInfo.79
11.3 Error type data definitions.79
11.3.1 TpMessageInfoPropertyError.79
11.3.2 TpMessagingError .79
11.3.3 TpMessageInfoPropertyErrorSet.80
11.3.4 TpSetPropertyError.80
12 Exception Classes.80
Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .82
Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF.83
Annex C (informative): Java API Description of the Multi-Media Messaging SCF.84
Annex D (informative): Contents of 3GPP OSA R7 Multi-Media Messaging .85
Annex E (informative): Description of Multi Media Messaging for 3GPP2 cdma2000
networks.86
E.1 General Exceptions.86
E.2 Specific Exceptions.86
E.2.1 Clause 1: Scope .86
E.2.2 Clause 2: References .86
E.2.3 Clause 3: Definitions and abbreviations.86
E.2.4 Clause 4: Multi Media Messaging SCF.86
E.2.5 Clause 5: Sequence Diagrams .86
E.2.6 Clause 6: Class Diagrams.86
E.2.7 Clause 7: The Service Interface Specifications .86
E.2.8 Clause 8: Multi Media Messaging Interface Classes.87
E.2.9 Clause 9: State Transition Diagrams .87
E.2.10 Clause 10: Multi-Media Messaging Service Properties .87
E.2.11 Clause 11: Data Definitions.87
E.2.12 Clause 12: Exception Classes.87
E.2.13 Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF .87
E.2.14 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF .87
E.2.15 Annex C (informative): Java API Description of the Multi-Media Messaging SCF.87
Annex F (informative): Record of changes .88
F.1 Interfaces.88
F.1.1 New.88
F.1.2 Deprecated.88
F.1.3 Removed.88
ETSI
7 ETSI ES 204 915-15 V1.1.1 (2008-05)
F.2 Methods.88
F.2.1 New.88
F.2.2 Deprecated.88
F.2.3 Modified.89
F.2.4 Removed.89
F.3 Data Definitions.89
F.3.1 New.89
F.3.2 Modified.89
F.3.3 Removed.89
F.4 Service Properties.89
F.4.1 New.89
F.4.2 Deprecated.90
F.4.3 Modified.90
F.4.4 Removed.90
F.5 Exceptions.90
F.5.1 New.90
F.5.2 Modified.90
F.5.3 Removed.90
F.6 Others.90
History .91

ETSI
8 ETSI ES 204 915-15 V1.1.1 (2008-05)
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 ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet
converged Services and Protocols for Advanced Networking (TISPAN).
The present document is part 15 of a multi-part deliverable covering Open Service Access (OSA); Application
Programming Interface (API), as identified below. The API specification (ES 204 915) is structured in the following
parts:
Part 1: "Overview";
Part 2: "Common Data Definitions";
Part 3: "Framework";
Part 4: "Call Control";
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";
Part 10: "Connectivity Manager SCF";
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".
The present document has been defined jointly between ETSI, The Parlay Group (http://www.parlay.org) and the 3GPP,
in co-operation with a number of JAIN™ Community (http://www.java.sun.com/products/jain) member companies.
The present document forms part of the Parlay 6.0 set of specifications.
The present document is equivalent to 3GPP TS 29.198-15 V7.1.0 (Release 7).
ETSI
9 ETSI ES 204 915-15 V1.1.1 (2008-05)
1 Scope
The present document is part 15 of the Stage 3 specification for an Application Programming Interface (API) for Open
Service Access (OSA).
The OSA specifications define an architecture that enables application developers to make use of network functionality
through an open standardised interface, i.e. the OSA APIs.
The present document specifies the Multi Media Messaging Service Capability Feature (SCF) aspects of the interface.
All aspects of the Multi Media Messaging SCF are defined here, these being:
• Sequence Diagrams.
• Class Diagrams.
• Interface specification plus detailed method descriptions.
• State Transition diagrams.
• Data Definitions.
• IDL Description of the interfaces.
The process by which this task is accomplished is through the use of object modelling techniques described by the
Unified Modelling Language (UML).
2 References
T
...