Javamail: What is the function of the "mail.pop3.timeout" and "mail.pop3.connectiontimeout" properties in plain Engish?

I'm working with a legacy app that downloads POP3 emails with javamail.  Despite reading the docs, I'm not sure I completely understand the purpose of these two properties.


Can anyone explain what they do in plain english and provide a real world example of when they might be used?

LVL 53
Who is Participating?
I wear a lot of hats...

"The solutions and answers provided on Experts Exchange have been extremely helpful to me over the last few years. I wear a lot of hats - Developer, Database Administrator, Help Desk, etc., so I know a lot of things but not a lot about one thing. Experts Exchange gives me answers from people who do know a lot about one thing, in a easy to use platform." -Todd S.

mail.pop3.connectiontimeout is how long you are willing to wait to make an initial connection to the POP3 mail server.  E.g. If you set this to 30 secs, then if you try to connect to a POP3 server and get no response inside 30 seconds, you'll give up and return an error.

mail.pop3.timeout is after you have connected to the mail server, how long you are willing to wait to get data back as you are reading mail messages.  So again if you set it 20 seconds, this means after you ask to read an email if you don't get a response inside of 20 seconds, you'll give up an report an error.

The practical choice is between responsiveness (how quickly do you report an error when there's a problem) against how forgiving you are of slow servers/networks.

If you were implementing an internal mail server for use in a corporate setting, it might be fine to have 15 sec timeouts - because that's really slow in a commercial environment and so if it takes that long you can give up and show an error because it's not likely just being slow.  But if you were connecting to a globally accessible server from potentially anywhere in the world, you might set the timeouts to 3 mins, because e.g. connecting to the US from India or China can often be very slow.

Does that help explain things?


Experts Exchange Solution brought to you by

Your issues matter to us.

Facing a tech roadblock? Get the help and guidance you need from experienced professionals who care. Ask your question anytime, anywhere, with no hassle.

Start your 7-day free trial
_agx_Author Commented:
Thanks, that's a clear explanation. I was thinking "mail.pop3.timeout" might be an overall timeout, similar to a session timeout in a web app.
Let's say you've got a new hosting provider and you want to test whether their mail server is working ok. You write a program that tries to connect to it every 5 minutes and check the number of mails in your inbox. So you used a scheduled task. There a two stages of connection

a. connecting to the mail server with a TCP/IP socket
b. implementing the protocol when you've connected to get the count of the messages in your inbox

So you do a. and you try to connect to the server. It doesn't connect and seems down. But how long are you going to wait until you've decided it IS down and mark that attempt as a fail? That time is actually set by mail.pop3.connectiontimeout. After that time, an exception will be thrown that you can catch and mark the attempt as a failed connection.
In the next scenario you DO connect but there seem to be problems waiting for the greeting from the server. Again - how long do you wait? That time is set by mail.pop3.timeout
An uncharacteristically long answer from me - result - it took far too long ;)
_agx_Author Commented:
CEHJ - Thanks for the response. I closed this one so fast, I didn't even see it until later :)
It's more than this solution.Get answers and train to solve all your tech problems - anytime, anywhere.Try it for free Edge Out The Competitionfor your dream job with proven skills and certifications.Get started today Stand Outas the employee with proven skills.Start learning today for free Move Your Career Forwardwith certification training in the latest technologies.Start your trial today

From novice to tech pro — start learning today.

Question has a verified solution.

Are you are experiencing a similar issue? Get a personalized answer when you ask a related question.

Have a better answer? Share it in a comment.