When you run the sample application for the first time, you need to specify whether the
PPG is the BlackBerry
Internet Service or the BlackBerry Enterprise Server. If you're using the BlackBerry
Internet Service as the PPG, you also need to provide the information from the
confirmation email message that you received when you signed up with Research In Motion to use the Push Service. When you develop your application, you can code this information
into your application instead of displaying it in a configuration screen and requiring
the user to type the information.
-
Load the appropriate version of the PushDemo_BlackBerryOS*.cod file on your
device from the .zip file that you downloaded. For more information about the
.zip file, see Download the sample
application.
-
Press the Menu key on your device,
and click Settings.
The Push Configuration screen appears.
-
If you use the BlackBerry
Internet Service as the PPG, in the Port field, type the port number specified in the confirmation
email message. If you use the BlackBerry Enterprise Server as the PPG, ask your administrator for the port number.
-
In the Application ID
field, perform one of the following actions:
- If you use the BlackBerry
Internet Service as the PPG, type the application ID specified in the
confirmation email message that you received from RIM.
- If you use the BlackBerry Enterprise Server as the PPG, leave the field blank.
-
If you use the BlackBerry
Internet Service as the PPG, in the BPS server
URL field, type the PPG base URL specified in the confirmation
email message. The sample application uses this URL to subscribe to the PPG. For
an evaluation environment, the URL is http://cp<cpid>.pushapi.eval.blackberry.com, where
<cpid> is your content provider ID.
For a production environment, the URL is http://cp<cpid>.pushapi.na.blackberry.com.
-
If you use the BlackBerry
Internet Service as the PPG, in the Push
Initiator application URL field, type
https://<server_address>/high-level-sample or
https://<server_address>/low-level-sample, where <server_address> is the address of the server
where our high-level or low-level sample Push Initiator is deployed. The SDK
includes the high-level or low-level sample Push Initiator that is deployed on
the Apache Tomcat server. The URL must be accessible from the Internet.
Depending on how you implemented your Push Initiator, you might want to
use your own Push Initiator that handles subscriptions instead of using one of
our sample Push Initiators.
-
The Push Initiator can send a confirmed push message with application-level
reliability that requires an acknowledgement from the push-enabled application.
Select the App Acknowledgment check box to make the
application acknowledge the push message when it arrives.
-
Select Use public (BIS) network if
the PPG is the BlackBerry
Internet Service or Use enterprise (BES)
network if the PPG is the BlackBerry Enterprise Server.
-
Press the Escape key, and click
Save.