Querying the status of push requests
If you use the PAP push format, you can query the status of a previously submitted push request for one or more specified recipients. A PAP status-query request includes the XML-based PAP control entity. The PAP control entity identifies the associated push request and the recipient addresses that you want to query.
The BlackBerry MDS Connection Service returns a single response that contains the status of the push request for all of the specified recipient BlackBerry devices.
You can specify zero or more recipients in the status-query 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 query the status of 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 queries the push request status for all recipient BlackBerry devices.
Querying the status of push requests can result in unnecessary network traffic which can negatively impact the performance of the BlackBerry MDS Connection Service. If it is important to know whether a push request was successfully delivered, requesting a result notification is typically more efficient.
To query the status of a push request, you send an HTTP POST request containing the PAP status-query request to the BlackBerry MDS Connection Service.
To create a status-query request
- Using the PAP push format: Use the <statusquery-message> element in the PAP control entity.
Was this information helpful? Send us your comments.