Troubleshooting guide

224
BlackBerry Java Development Environment Development Guide
Work with a server-side push request
Send a request to cancel a PAP push
submission.
1. Use the cancel-message push-id header. For example:
<cancel-message push-id="[e-mail]">
2. To specify the address to which the application submitted the push message, use the
address address-value header. This is a required tag.
<address address-value="WAPPUSH=aisha.wahl%40blackberry.com%3A7874/
TYPE=[e-mail]" />
The following example shows a PAP push cancellation request:
Content-Type: application/xml
<?xml version="1.0"?>
<!DOCTYPE pap PUBLIC "-//WAPFORUM//DTD PAP 2.0//EN"
"http://www.wapforum.org/DTD/pap_2.0.dtd">
<pap>
<cancel-message push-id=“a_push_id">
<address address-value=
“WAPPUSH=aisha.wahl%40blackberry.com%3A7874/TYPE=[e-mail]”/>
</cancel-message>
</pap>
Note: When pushing to a Group address, you cannot determine the status of delivery to a
particular recipient or cancel delivery to one or more recipients. If the application requires this
functionality, specify multiple recipient addresses in the push submission.
Query the status of a PAP push request. 1. To specify the push message on which you want to obtain status information, send a PAP push
query request using the
statusquery-message push-id header. For example:
<statusquery-message push-id="[e-mail]">
2. To specify the address to which you want to submit the push message, in the PAP push query
request, use the
address-value header. For example:
<address address-value="WAPPUSH=aisha.wahl%40blackberry.com%3A7874/
TYPE=[e-mail]" />
The following example shows a RIM network status query request:
Content-Type: application/xml
<?xml version="1.0"?>
<!DOCTYPE pap PUBLIC "-//WAPFORUM//DTD PAP 2.0//EN"
"http://www.wapforum.org/DTD/pap_2.0.dtd"
[<?wap-pap-ver supported-versions="2.0,1.*"?>]> <pap>
<statusquery-message push-id="[e-mail] ">
<address
address-value="aisha.wahl%40blackberry.com%3A7874/
TYPE=[e-mail]"/>
</statusquery-message>
</pap>