2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms as stated in this document. [OMA-Template-SpecWAP-20040205]
Push Access Protocol
Candidate Version 2.1 – 22 Nov 2005
Open Mobile Alliance
OMA-WAP-TS-PAP-V2_1-20051122-C
Continues the Technical Activities
Originated in the WAP Forum
OMA-WAP-TS-PAP-V2_1-20051122-C Page 2 (48)
2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms as stated in this document. [OMA-Template-SpecWAP-20040205]
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
.
Unless this document is clearly designated as an approved specification, this document is a work in process, is not an
approved Open Mobile Alliance™ specification, and is subject to revision or removal without notice.
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.
© 2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms set forth above.
OMA-WAP-TS-PAP-V2_1-20051122-C Page 3 (48)
2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms as stated in this document. [OMA-Template-SpecWAP-20040205]
Contents
1. SCOPE................................................................................................................................................................................5
2. REFERENCES ..................................................................................................................................................................6
2.1 NORMATIVE REFERENCES..........................................................................................................................................6
2.2 INFORMATIVE REFERENCES.......................................................................................................................................7
3. TERMINOLOGY AND CONVENTIONS......................................................................................................................8
3.1 CONVENTIONS .............................................................................................................................................................8
3.2 DEFINITIONS................................................................................................................................................................8
3.3 ABBREVIATIONS ..........................................................................................................................................................9
4. INTRODUCTION (INFORMATIVE)..........................................................................................................................10
5. OPERATIONS (NORMATIVE) ...................................................................................................................................11
5.1 PUSH SUBMISSION .....................................................................................................................................................11
5.2 RESULT NOTIFICATION.............................................................................................................................................12
5.3 PUSH CANCELLATION ...............................................................................................................................................13
5.4 STATUS QUERY..........................................................................................................................................................13
5.5 CLIENT CAPABILITIES QUERY .................................................................................................................................14
6. ADDRESSING (NORMATIVE) ...................................................................................................................................15
6.1 MULTIPLE RECIPIENT ADDRESSING ........................................................................................................................15
6.2 MULTICAST/BROADCAST ADDRESSES......................................................................................................................15
7. MESSAGE FORMAT (NORMATIVE) .......................................................................................................................16
7.1 CONTROL ENTITY FORMAT......................................................................................................................................16
7.2 CONTENT ENTITY FORMAT ......................................................................................................................................16
7.3 CAPABILITIES ENTITY FORMAT ...............................................................................................................................17
7.4 EXAMPLE (INFORMATIVE) .......................................................................................................................................17
8. CONTROL ELEMENTS & ATTRIBUTES (NORMATIVE) ...................................................................................18
8.1 THE PAP ELEMENT....................................................................................................................................................18
8.2 THE PUSH-MESSAGE ELEMENT.................................................................................................................................18
8.2.1 The address Element ..........................................................................................................................................20
8.2.2 The quality-of-service Element..........................................................................................................................21
8.3 THE PUSH-RESPONSE ELEMENT ...............................................................................................................................22
8.3.1 The progress-note Element ................................................................................................................................22
8.3.2 The response-result Element..............................................................................................................................23
8.4 THE CANCEL-MESSAGE ELEMENT............................................................................................................................23
8.5 THE CANCEL-RESPONSE ELEMENT...........................................................................................................................23
8.5.1 The cancel-result Element..................................................................................................................................24
8.6 THE RESULTNOTIFICATION-MESSAGE ELEMENT ....................................................................................................24
8.7 THE RESULTNOTIFICATION-RESPONSE ELEMENT ...................................................................................................25
8.8 THE STATUSQUERY-MESSAGE ELEMENT .................................................................................................................26
8.9 THE STATUSQUERY-RESPONSE ELEMENT ................................................................................................................26
8.9.1 The statusquery-result Element..........................................................................................................................26
8.10 THE CCQ-MESSAGE ELEMENT ..................................................................................................................................27
8.11 THE CCQ-RESPONSE ELEMENT.................................................................................................................................27
8.12 THE BADMESSAGE-RESPONSE ELEMENT..................................................................................................................28
8.13 STATUS CODES ..........................................................................................................................................................28
8.14 STATUS CODE DEFINITIONS......................................................................................................................................30
8.14.1 Success 1xxx......................................................................................................................................................31
8.14.2 Client Error 2xxx ...............................................................................................................................................31
8.14.3 Server Error 3xxx...............................................................................................................................................32
8.14.4 Service Failure 4xxx ..........................................................................................................................................33
8.14.5 Mobile Client Abort 5xxx..................................................................................................................................33
9. VERSION CONTROL (NORMATIVE) ......................................................................................................................34
OMA-WAP-TS-PAP-V2_1-20051122-C Page 4 (48)
2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms as stated in this document. [OMA-Template-SpecWAP-20040205]
9.1 IDENTIFICATION OF VERSIONS SUPPORTED ............................................................................................................34
9.2 USE OF WAP-PAP-VER PROCESSING INSTRUCTION ..................................................................................................35
9.3 VERSION MISMATCH ................................................................................................................................................35
9.4 VERSION DISCOVERY CASES ....................................................................................................................................35
9.5 VERSION CONSISTENCY ............................................................................................................................................36
10. CAPABILITIES NEGOTIATION (NORMATIVE) ...............................................................................................37
10.1 CAPABILITIES QUERY ...............................................................................................................................................37
10.2 SUBSCRIPTION ...........................................................................................................................................................37
10.3 ASSUMED CAPABILITIES...........................................................................................................................................37
11. PAP REFERENCE INFORMATION (NORMATIVE)...........................................................................................38
11.1 DOCUMENT IDENTIFIERS ..........................................................................................................................................38
11.1.1 SGML Public Identifier .....................................................................................................................................38
11.1.2 PAP Media Type................................................................................................................................................38
11.2 DOCUMENT TYPE DEFINITION (DTD)......................................................................................................................38
12. EXAMPLES (INFORMATIVE) ...............................................................................................................................42
12.1 PUSH-MESSAGE EXAMPLE .........................................................................................................................................42
13. PUSH ACCESS PROTOCOL OVER HTTP (NORMATIVE) ..............................................................................44
13.1 ADDRESSING ..............................................................................................................................................................44
13.2 MESSAGE FORMAT....................................................................................................................................................44
13.3 EXAMPLE (INFORMATIVE)........................................................................................................................................44
13.4 MESSAGE RESPONSES ...............................................................................................................................................45
13.4.1 HTTP Response Codes ......................................................................................................................................45
APPENDIX A. STATIC CONFORMANCE REQUIREMENTS (NORMATIVE).....................................................46
A.1 PUSH PROXY GATEWAY FEATURES .........................................................................................................................46
Validation ..........................................................................................................................................................................46
Operations..........................................................................................................................................................................46
Semantics...........................................................................................................................................................................46
APPENDIX B. CHANGE HISTORY (INFORMATIVE)..............................................................................................48
B.1 APPROVED VERSION HISTORY .................................................................................................................................48
B.2 DRAFT/CANDIDATE VERSION HISTORY ...................................................................................................................48
Figures
Figure 1. Push Architecture...................................................................................................................................................10
Figure 2. Push Submission ......................................................................................................................................................11
Figure 3. Push Submission with Confirmation .....................................................................................................................12
Figure 4. Push Cancellation ....................................................................................................................................................13
Figure 5. Status Query Operation ..........................................................................................................................................13
Figure 6. Client Capabilities Query Operation .....................................................................................................................14
OMA-WAP-TS-PAP-V2_1-20051122-C Page 5 (48)
2005 Open Mobile Alliance Ltd. All Rights Reserved.
Used with the permission of the Open Mobile Alliance Ltd. under the terms as stated in this document. [OMA-Template-SpecWAP-20040205]
1. Scope
This specification defines the Push Access Protocol (PAP). The PAP is intended for use in delivering content from Push
Initiators to push proxy gateways for subsequent delivery to narrow band devices, including cellular phones and pagers.
Example messages include news, stock quotes, weather, traffic reports, and notification of events such as email arrival. With
push functionality, users are able to get information without having to request that information. In many cases it is important
for the user to get the information as soon as it is available.
The push access protocol is not intended for use over the air.