Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

Java Development


by Retired on ‎06-27-2011 01:11 PM (2,601 Views)

[Please note that this article only applies to BlackBerry devices on AT&T running BlackBerry® 7 or later.]


BlackBerry devices running BlackBerry® Device Software 7.0 or above on AT&T introduced a new gateway which is known as the PHONE APN. It optimizes throughput performance of data connections (e.g. http, https, ssl, socket etc) to provide faster speed and higher bandwidth compared to the existing WAP gateway. This new gateway is ideal for most (if not all) services and is highly recommended over WAP. The only limitation of PHONE APN today is the absence of SubID or X-Up-SubNo header information that some in-market apps may be using to authenticate users over WAP. However, note that SubID and X-Up-SubNo header information will be supported in the future through this gateway.



If your application leverages SubID or X-Up-SubNo header for user authentication purposes, you will not be able to use PHONE APN to authenticate the user. These headers are not provided by the PHONE APN today.



To authenticate users over PHONE APN, apps can leverage the mobile MSISDN of the device. Specifically, the following steps needs to be done.


Retrieve the MSISDN of the device as shown below:

int[] lineIDs = Phone.getLineIds();
String msisdn;
      for(int i = 0; i < lineIDs.length; i++){
            if(Phone.getLineType(lineIDs[i]) == Phone.MOBILE_TYPE){
                  msisdn = Phone.getLineNumber(lineIDs[i]);
  1. Once the correct MSISDN is retrieved, app can send this information to the server over PHONE APN for authentication.
  2. Applications MUST ensure that the MSISDN information is transmitted over a secure encrypted channel such as HTTPS or SSL.


Creating a connection over the PHONE APN

The PHONE APN is provisioned via the Default TCP Service Record. Hence, if an app creates a connection using the Default TCP Service Record, you are essentially creating a connection over the PHONE APN. For more information on how to leverage the Default TCP Service Record, please refer to this KB article.



In order to properly test PHONE APN on your BlackBerry 7.0 devices, your SIMs will need to be properly provisioned on the AT&T network for connectivity to the PHONE APN.  If you have any issues connecting to the PHONE APN, contact your AT&T Service Integration Manager.


If you have questions on integrating the source code into your BlackBerry application, you can post a question in the BlackBerry Java® development forums here

Users Online
Currently online: 20 members 1,557 guests
Please welcome our newest community members: