Domino & Notes error

Listener task for port [port] is suspending for 20 seconds due to listen errors

Usually follows an 'Error on Listen function' message in the console.

What it means

The Domino listener for that port keeps failing to listen, so it pauses and tries again every 20 seconds. Nobody can connect on that port meanwhile.

Common causes

  • The port is already in use by another process
  • The IP address in TCPIP_TCPIPAddress in notes.ini isn't on this machine
  • The network adapter or IP address changed after setup

Quick fixes

  1. Look for the earlier 'Error on Listen function' message and fix that first
  2. Check TCPIP_TCPIPAddress in notes.ini matches an address that exists on the host
  3. After fixing it, run restart port TCPIP or restart Domino

Need a hand with this?

Paste your exact message into What's That Error? for a plain-English explanation, or get in touch. I've been supporting Domino and Notes for 28 years.

Disclaimer

The errors, causes and fixes on this site are carefully researched, drawing on HCL documentation and 28 years of hands-on Domino and Notes experience. Every environment is different, though, and a solution that works in one may not be right for yours. Exact wording can also vary between Domino and Notes versions.

This information is general guidance only and is provided without warranty of any kind. Always back up your data and test changes on a non-production system first. To the extent permitted by law, Bruinsma Services Pty Ltd accepts no responsibility or liability for any loss, damage, downtime or other consequence arising from use of this information. For advice specific to your environment, please contact me.