Cancelling a pending push request
If you use the PAP push format, you can send a cancellation request to cancel a push request. A PAP cancellation request includes the XML-based PAP control entity. The control entity identifies the associated push request and the recipient addresses for which the push request should be cancelled.
You can specify zero or more addresses in the cancellation request. If you specify a recipient address, it must match an address specified in the original push request. You cannot specify a BlackBerry user group in the original push request, and then attempt to cancel the push request for a single BlackBerry device, even if the BlackBerry device user is a member of the specified group.
If you do not specify an address, the BlackBerry MDS Connection Service attempts to cancel the push request for all recipient BlackBerry devices.
When the BlackBerry MDS Connection Service receives a cancellation request, it first queries the status of the push request. If the push request is still pending for one or more recipients, the BlackBerry MDS Connection Service accepts the cancellation request and attempts to cancel the push request for the recipients listed in the cancellation request. The BlackBerry MDS Connection Service does not attempt to recall data from BlackBerry devices that have received the pushed data.
To cancel a push request, you send an HTTP POST request containing the PAP cancellation request to the BlackBerry MDS Connection Service.
To create a cancellation request
- Using the PAP push format: Use the <cancel-message> element
Was this information helpful? Send us your comments.