Canceling 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 canceled.
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 try 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 don't specify an address, the BlackBerry MDS Connection Service tries 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 tries to cancel the push request for the recipients listed in the cancellation request. The BlackBerry MDS Connection Service doesn't try to recall content from BlackBerry devices that have received the pushed content.
To cancel a push request, you send an HTTP POST request containing the PAP cancellation request to the BlackBerry MDS Connection Service.
Using the PAP push format
When you use the PAP push format, you must use the <cancel-message> element.
Last modified: 2015-06-11