Would you like to tell us how we are doing?

You bet No thanks
Fork me on GitHub

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Configure the sample application

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.
  1. 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.
  2. Press the Menu key on your device, and click Settings. The Push Configuration screen appears.

    Configuration screen Push for Java 200

  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Press the Escape key, and click Save.