wiki:faq

  1. General questions
    1. I'm using E-Mail service XYZ. How do I configure LogicMail to access it?
  2. Troubleshooting
    1. When I try to connect to my mail server, it fails with an error.
    2. I'm able to connect, but LogicMail gets stuck on another error.
    3. I'm using a BlackBerry 1234 device, running BlackBerry OS vX.Y, will LogicMail work?
    4. I'm trying to send E-Mail, but I'm getting "Problem with Sender" errors.
    5. Why does SMTP switch to port 465 when I enable SSL?
    6. Whenever I start LogicMail, I have to confirm the connection.
    7. When I run LogicMail 1.1 on the BlackBerry Storm, the screen does not rotate.
  3. Other questions
    1. What about new message notification?
    2. Is HTML message display supported?
  4. Development
    1. What do I need to setup a development environment for LogicMail?
    2. Why are there separate builds for different BlackBerry OS versions?
    3. Can I develop/build LogicMail on Linux?

General questions

I'm using E-Mail service XYZ. How do I configure LogicMail to access it?

I don't know. I don't use E-Mail service XYZ. Please check their website. All I can tell you is that the settings aren't that different from configuring any other desktop E-Mail client.

This is a surprisingly common question, however, and it appears the  Mozilla Thunderbird project is working on building a  mail server list that they can eventually use to automate client configuration. When and if they finish implementing it, I may consider integrating support for the list into LogicMail.

Troubleshooting

When I try to connect to my mail server, it fails with an error.

a.k.a. Why does it say "Unable to reopen connection?
a.k.a. Why does it say "Unable to connect to server?
a.k.a. Why does it say "I/O Error?

First, double-check all your configuration settings. (If using v1.1, you should especially try the "Use MDS Proxy" setting, which may or may not be required for your unit.) If you are sure they are correct, then chances are that your BlackBerry is not properly configured for TCP networking.

Make sure that "TCP" is setup in your Blackberry's configuration (Options -> Advanced Options -> TCP). The exact settings are provider-specific, so you'll have to search the web and/or ask your provider.

Two decent lists of APN/TCP settings are:
 http://www.blackberryfaq.com/index.php/Carrier_specific_APN/TCP_settings
 http://pinstack.com/carrier_settings_apn_gateway.html

One for UK users:
 http://www.filesaveas.com/gprs.html

To test TCP connectivity, try LogicMail again, or try any other program that uses TCP (Opera Mini and BBSSH are good options).

I'm able to connect, but LogicMail gets stuck on another error.

This other error would mention the issue if LogicMail has some idea as to what it is, or it will simply say "Unknown error" otherwise. The best thing you can do at this point is to capture a transcript of the network traffic between your BlackBerry (or a simulator) and your mail server. Alternatively, you can simulate that traffic using something like telnet. This information can be used to produce a useful bug report that action can be taken upon. For more information on how to do this, you should look at the Debugging page.

I'm using a BlackBerry 1234 device, running BlackBerry OS vX.Y, will LogicMail work?

All LogicMail releases will work on the mentioned version of BlackBerry OS, or any higher version. I don't believe in coding for specific devices. LogicMail 1.1 will work on OS 4.1 or higher, and LogicMail 2.0 will work on OS 4.5 or higher.

I'm trying to send E-Mail, but I'm getting "Problem with Sender" errors.

You need to go into the Identity configuration screen ("Config" menu option, then select the Identity entry associated with your account. Usually it is just called "Default".), and make sure the "Full name" and "E-Mail address" fields are set correctly.

Why does SMTP switch to port 465 when I enable SSL?

There are two common ways you can establish a network connection using SSL:

  • Connect directly to a special port that expects SSL
  • Connect to a non-SSL port, then send "STARTTLS" to switch to SSL mode

Typically, POP and IMAP servers use the first approach. (ports 110/143 vs. ports 993/995). The same approach is supported with SMTP (port 25 vs. port 465), but is less common to see. LogicMail 1.x does not support the second approach, requiring you to use an SMTP server that supports direct SSL connections. LogicMail 2.0 does support the second approach (STARTTLS) on all protocols.

Whenever I start LogicMail, I have to confirm the connection.

Whenever you start LogicMail, you get a message that looks like:

"The application LogicMail has attempted to access a low-level network connection. Would you like to allow this?"

  • From your BlackBerry's main screen, go to Options --> Security Options --> Firewall
  • Change the firewall status to Enabled, and save changes
  • Start LogicMail and try to connect
  • When it prompts you, there will be an option to always allow the connection and never be prompted again.

NOTE: enabling the firewall may cause problems for other applications on your device, such as JiveTalk. After following the above steps, ensure that all your other applications are working correctly by testing each one.

When I run LogicMail 1.1 on the BlackBerry Storm, the screen does not rotate.

The fix for this is to disable compatibility mode for LogicMail.  This web page has some instructions that may be helpful with that. LogicMail 2.0 fully supports touchscreen devices, provided that you installed the correct version for your device.

Other questions

What about new message notification?

a.k.a. How can I get my BB to buzz when I get a new message?
a.k.a. Can you implement an auto-refresh feature? It should be easy, right?
a.k.a. Can I have it check for new mail automatically?

I get this feature request often enough, that I figured I might as well provide a general explanation. LogicMail 1.x was a very synchronous application. It didn't do anything unless you were interacting with it. Nothing ran in the background, and it did not really have any sort of data model behind the screens the user saw.

LogicMail 2.0 was a major undertaking, as it essentially transformed the internals of LogicMail from a minimalist proof-of-concept into a full-fledged application. This took far more time and effort than originally expected. LogicMail 2.0 does now have full support for IMAP IDLE, so your phone may buzz if you get new messages while actively connected to an IMAP server. However, to avoid delaying the release any longer, 2.0 lacks the code to actually reestablish broken connections and automatically poll your mail server in the background. These features are coming in 2.1, and are currently under active development.

Is HTML message display supported?

LogicMail 2.0 includes correct HTML rendering using the built-in HTML display capabilities of the BlackBerry API. The implementation of this is currently somewhat basic, and does not include support for loading external images. Furthermore, replying to an HTML message may result in an empty quoted section or a quoted block of raw HTML in the reply text. It is still recommended that you view messages as plain text, if possible, as HTML support is mostly there for the cases when someone sends you an HTML-only message.

Development

What do I need to setup a development environment for LogicMail?

Why are there separate builds for different BlackBerry OS versions?

Each new version of the BlackBerry OS adds additional features, and LogicMail is designed to take advantage of these whenever possible. These different configurations make it possible to leverage those features without abandoning users of older OS versions.

Can I develop/build LogicMail on Linux?

  • While I do most of my actual development work on Windows, the build server is running Linux.
  • The trunk (latest development code), 2.0, and 1.1 branches can be built directly using ant, some files from the RIM JDE, and some files from the Sun J2ME SDK. The README.txt file in the lib subdirectory should have the necessary details on what you will need to download.
  • The simulator will pretend to work with  WINE, though newer simulators sometimes act very quirky.
  • The  Slashdev blog has a lot of useful articles on running the BlackBerry development tools on Linux.
  • You may run into problems due to hard-coded backslashes in both rapc.jar and SignatureTool.jar, which the Slashdev blog outlines the basic approaches for resolving. These problems appear to be fixed in the BlackBerry OS 5.0 and 6.0 tools, but may exist in older versions.