Making a push request

Whether you are using the PAP push format or the BlackBerry push format, a push request is made up of the data to be pushed and a set of delivery parameters. These define how, when, and to whom the data is pushed. The principle difference between the two formats is the way in which the delivery parameters are specified.

Both the PAP push and BlackBerry push formats support the following features:

  • Reliable push requests: request that the BlackBerry MDS Connection Service send a result notification to indicate the success or failure of the push request for each recipient address.
  • Deliver-Before time stamp: provide a time stamp before which the BlackBerry MDS Connection Service must deliver the pushed data. If the BlackBerry MDS Connection Service is unable to deliver the data by the specified time, the push request is considered to have failed.
  • Deliver-After time stamp: provide a time stamp before which the push must not be delivered. If a push is not successfully delivered after the specified time, the push is considered to have failed.

In addition, the PAP push format supports the following features:

  • Push cancellation: cancel a push submission that has already been sent.
  • Push status query: check the status of a push submission.