Network transport options

Transport

Additional information

TCP Cellular

When you create a connection using the TCP Cellular transport, you may need to specify the following parameters:

  • APN
  • Tunnel authorization user name
  • Tunnel authorization password

If you are using the Network API, you can use the TCPCellularOptions class to configure these options. For BlackBerry® devices that are running BlackBerry® 6 and later, you can determine whether these options are already set by invoking TCPCellularOptions.isDefaultAPNSet().

If you are using the GCF, you could use a connection string that is similar to the following:

"http://www.blackberry.com;deviceside=true; apn=carriergateway;TunnelAuthusername=GW@CARRIERGPRS.COM; TunnelAuthPassword=CARRIER"

TCP Wi-Fi®

If you are using the GCF, you can use the Wi-Fi® transport with a connection string that is similar to the following:

"http://www.blackberry.com;interface=wifi"

WAP 2.0

If WAP 2.0 is configured on a device, you need to retreive a connection ID from the service book. If you are using the GCF, you could use a connection string that is similar to the following:

"http://www.blackberry.com;deviceside=true;ConnectionUID=H6Q1234"

For more information about retrieving a connection ID, see the knowledge base article at http://supportforums.blackberry.com/t5/Java-Development/What-Is-Network-API-alternative-for-legacy-OS/ta-p/614822

WAP 1.0 and 1.1

Like TCP Cellular, you may need to specify additional parameters to use the WAP 1.0 or 1.1 gateway:

  • Gateway APN
  • Gateway IP address
  • Gateway port
  • Source IP address
  • Source port
  • Tunnel authorization user name
  • Tunnel authorization password
  • Enable WTLS

If you are using the Network API, you can use the WapOptions class to configure these options.

If you are using the GCF, you could use a connection string that is similar to the following:

"http://www.blackberry.com;deviceside=true; WapGatewayIP=127.0.0.1;WapGatewayPort:9201; WapGatewayAPN=carriergateway"

BlackBerry® Mobile Data System

If you are using the GCF, you can use the BlackBerry MDS transport with a connection string that is similar to the following:

"http://www.blackberry.com;deviceside=false"

BlackBerry® Internet Service

To use the BlackBerry Internet Service transport, you must sign up for the BlackBerry® Push Service. For more information, visit http://na.blackberry.com/eng/developers/javaappdev/pushapi.jsp


Was this information helpful? Send us your comments.