doubango-android/schemas/OMA-SUP-AC_ap0009_presence-V1_0-20081223-C.txt

COMMENT

This file is the Presence Application Characteristics file of OMA PRS 2.0

FILE INFORMATION

OMA Permanent Document
   File: OMA-SUP-AC_ap0009_presence-V1_0-20081223-C

   Type: Text

Public Reachable Information
   Path: http://www.openmobilealliance.org/Tech/omna/omna-dm_ac.aspx
   Name: ac_ap0009_presence-v1_0.txt

NORMATIVE INFORMATION

Information about this file can be found in PRS 2.0 Technical Specification available at
http://www.openmobilealliance.org/

Send comments to technical-comments@mail.openmobilealliance.org
	
LEGAL DISCLAIMER

Use of this document is subject to all of the terms and conditions
of the Use Agreement located at
	http://www.openmobilealliance.org/UseAgreement.html

You may use this document or any part of the document for internal
or educational purposes only, provided you do not modify, edit or
take out of context the information in this document in any manner.
Information contained in this document may be used, at your sole
risk, for any purposes.

You may not use this document in any other manner without the prior
written permission of the Open Mobile Alliance.  The Open Mobile
Alliance authorizes you to copy this document, provided that you
retain all copyright and other proprietary notices contained in the
original materials on any copies of the materials and that you
comply strictly with these terms.  This copyright permission does
not constitute an endorsement of the products or services.  The
Open Mobile Alliance assumes no responsibility for errors or
omissions in this document.

Each Open Mobile Alliance member has agreed to use reasonable
endeavors to inform the Open Mobile Alliance in a timely manner of
Essential IPR as it becomes aware that the Essential IPR is related
to the prepared or published specification.  However, the members
do not have an obligation to conduct IPR searches.  The declared
Essential IPR is publicly available to members and non-members of
the Open Mobile Alliance and may be found on the "OMA IPR
Declarations" list at http://www.openmobilealliance.org/ipr.html.
The Open Mobile Alliance has not conducted an independent IPR review
of this document and the information contained herein, and makes no
representations or warranties regarding third party IPR, including
without limitation patents, copyrights or trade secret rights.  This
document may contain inventions for which you must obtain licenses
from third parties before making, using or selling the inventions.
Defined terms above are set forth in the schedule to the Open Mobile
Alliance Application Form.

NO REPRESENTATIONS OR WARRANTIES (WHETHER EXPRESS OR IMPLIED) ARE
MADE BY THE OPEN MOBILE ALLIANCE OR ANY OPEN MOBILE ALLIANCE MEMBER
OR ITS AFFILIATES REGARDING ANY OF THE IPR’S REPRESENTED ON THE "OMA
IPR DECLARATIONS" LIST, INCLUDING, BUT NOT LIMITED TO THE ACCURACY,
COMPLETENESS, VALIDITY OR RELEVANCE OF THE INFORMATION OR WHETHER OR
NOT SUCH RIGHTS ARE ESSENTIAL OR NON-ESSENTIAL.

THE OPEN MOBILE ALLIANCE IS NOT LIABLE FOR AND HEREBY DISCLAIMS ANY
DIRECT, INDIRECT, PUNITIVE, SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR
EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF
DOCUMENTS AND THE INFORMATION CONTAINED IN THE DOCUMENTS.

© 2008 Open Mobile Alliance Ltd.  All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the
terms set forth above.

IDENTIFYING INFORMATION
#######################
APPID: ap0009.
APPID type: OMNA.
Owner: OMA Presence and Availability Working Group.
Contact: OMA Presence and Availability Working Group <TECHNICAL-COMMENTS@MAIL.OPENMOBILEALLIANCE.ORG>. 
Registration version: 1.0.
Registration timestamp: 2008-12-23.
Application description: Presence.
Application reference: 
Presence_SIMPLE (PRS) V2.0 enabler. OMA PRS Enabler Release 2.0 specifications,
URL:http://www.openmobilealliance.org/documents.asp.
 

WELL-KNOWN PARAMETERS
#####################
Characteristic/name: APPLICATION/APPID.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: ap0009.
Interpretation: To uniquely identify the Presence enabler.
-------
Characteristic/name: APPLICATION/NAME.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: N/A.
Interpretation: User displayable name for the Presence enabler.
-------
Characteristic/name: APPLICATION/PROVIDER-ID.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: Identity of the Presence service provider.
-------
Characteristic/name: APPLICATION/TO-APPREF.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: N/A.
Interpretation: It specifies the linkage between Presence and the SIP-IP-core, e.g. IMS.
-------
Characteristic/name: APPLICATION/TO-NAPID.
Status: Required if direct use of Network Access Point supported.
Occurs: 1/*. 
Default value: None.
Used values: N/A.
Interpretation: Specifies the network access point used for a given application.
-------
Characteristic/name: APPLICATION/CLIENT-OBJ-DATA-LIMIT.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: An Integer.
Interpretation: Limits the size of the MIME object data to the specified value in bytes when PUBLISH requests are used in the Presence Source. When the Presence Server does not support the MIME objects as direct content of PUBLISH requests, this parameter is set to zero.
-------
Characteristic/name: APPLICATION/CONTENT-SERVER-URI.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: A HTTP URI.
Interpretation: Defines the HTTP URI of the Content Server to be used for content indirection.
-------
Characteristic/name: APPLICATION/SOURCE-THROTTLE-PUBLISH.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: An Integer.
Interpretation: Defines the minimum time interval (in seconds) between two consecutive publications from a Presence Source.
-------
Characteristic/name: MAX-NUMBER-OF-SUBSCRIPTIONS-IN-PRESENCE-LIST.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: An Integer.
Interpretation: Limits the number of back-end subscriptions allowed for Presence List.
-------
Characteristic/name: APPLICATION/SERVICE-URI-TEMPLATE.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: Defines the syntax of the Service URI.
-------
Characteristic/name: RLS-URI.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: A SIP URI.
Interpretation: Defines the SIP URI of the Resource List Server to be used for subscribing to Request-contained Presence List.
-------
EXAMPLE
#######
<characteristic type="APPLICATION">
<parm name="APPID" value="ap0009"/>
<parm name="NAME" value="Presence"/>
<parm name="PROVIDER-ID" value="Best"/> 
<parm name="TO-APPREF" value="SIP-IP CORE"/>
<parm name="TO-NAPID" value="IMS-NAP"/>
<parm name="CLIENT-OBJ-DATA-LIMIT" value="5120"/>
<parm name="CONTENT-SERVER-URI" value="http://example.operator.com"/>
<parm name="SOURCE-THROTTLE-PUBLISH" value="3600"/>
<parm name="MAX-NUMBER-OF-SUBSCRIPTIONS-IN-PRESENCE-LIST" value="10"/>
<parm name="SERVICE-URI-TEMPLATE" value="&lt;xui&gt;;pres-list=&lt;id&gt;"/>
<parm name="RLS-URI" value="sip:rls@rls.operator.com"/>
</characteristic>
###END###