Using push request reliability
In your push request, you can specify that you want the BlackBerry device to return a result notification when the pushed data is successfully delivered. The BlackBerry MDS Connection Service receives notifications from each BlackBerry device that successfully receives the pushed data and forwards those notifications to the push originator. Similarly, the BlackBerry MDS Connection Service sends a notification to the push originator if a push request is not successfully delivered to one or more BlackBerry devices within the allotted time.
If you do not specify a reliability level for your push method, the BlackBerry MDS Connection Service does not provide the push originator with any notification regarding the outcome of the push request.
You must also specify a notification URL to which the BlackBerry MDS Connection Service will send result notifications, with every push request that specifies a reliability option. A push request that requests some level of reliability but does not provide a notification URL is considered invalid and is rejected by the BlackBerry MDS Connection Service.
You must register the ApplicationID which sets the parameters for the client-side listener application with the BlackBerry MDS Connection Service if you are creating a custom BlackBerry Java Application to receive and process pushed data and intend to use application-reliable push requests. Contact your organization's BlackBerry Device Service Administrator with the unique port numbers that you defined for any client-side apps you develop.
If you have created a client-side app and you want to use application-reliable push requests, you might need to design your app to make a request to the BlackBerry MDS Connection Service the first time the user opens it.
Before you can submit an application-reliable push request, the BlackBerry MDS Connection Service must know the BlackBerry Device Software version information for each recipient BlackBerry device, since application-reliable push requests are only supported by BlackBerry devices running BlackBerry Device Software 3.8 or later. The BlackBerry MDS Connection Service acquires the BlackBerry device information from the device profile, which is identified in the UAProf header that is included when a user makes a request for content using the BlackBerry Browser.
If the user must register to use your push application, then the BlackBerry MDS Connection Service will already have registered the device information for each recipient. Otherwise, the BlackBerry MDS Connection Service will not have the user profile information it needs before permitting application-reliable requests. You can develop your app so that it sends an HTTP request, to make sure that the BlackBerry MDS Connection Service registers profile information for each BlackBerry device that receives pushed data.
To specify a reliable push request
- Using the PAP push format: Include the <quality-of-service> element in the <push-message> element of the control entity.
- Using the BlackBerry push format: Include the X-Rim-Push-Reliability header in the request.
Was this information helpful? Send us your comments.