Skip to main content

Failed incoming emails

Incoming emails which could not be processed are stored as .eml files in the table cmas_nimh_archived_mail of the ConSol CM database. These emails are managed on the Failed incoming emails page.

Failed emails are usually caused by one of the following reasons:

  • One of the email scripts (see Email scripts) has a bug, so that emails can be fetched from the mail server, but not be processed further in ConSol CM.
  • An email attachment is too large. The size limit is defined by the system property cmas-nimh, mailbox.default.task.max.message.size.
  • The email is corrupted or does not conform to the RFC. The system property cmas-nimh, mailbox.default.session.mail.mime.address.strict determines how strict the parsing is.
info

If an email which could not be processed cannot be saved in the ConSol CM database either, e.g., because of its size, it is saved in the file system instead. The folder where these emails are stored is located in the ConSol CM data directory inside the mail folder. This is configured in the system property cmas-nimh, mailbox.polling.unstorable.backup.folder.

Emails which are saved to the file system are not shown on the Failed incoming emails page of the Web Admin Suite. Instead, a notification is sent to the administrator.

On the Failed incoming emails page, you can retry processing these emails, download them or delete them.

note

The Failed incoming emails page only shows the emails which are saved in the table cmas_nimh_archived_mail and have the value 0 in the processed_success column.

Available settings for failed incoming emails​

The following information is available for failed incoming emails:

  • Subject: The subject of the email.
  • From: The email address of the sender of the email.
  • Mailbox: The mailbox which received the email.
  • Error cause: The reason why the email could not be processed. For example, because the email is too large.
  • Size (MB): The size of the email in MB.
  • Date: The date when the email was saved to the database.

Basic tasks​

Finding an email​

The list of emails is displayed directly after accessing the Failed incoming emails page of the Web Admin Suite. You can filter the list to locate an email more easily:

  • Text search: Enter a text in the Search field to filter by subject, sender, mailbox or reason for the error.

Managing failed incoming emails​

You can perform the following actions on failed incoming emails:

  • Retry processing an email: Click the Process icon in the email's row to retry processing this email. If the processing succeeds, the email is removed from the Failed incoming emails page.
  • Download an email: Click the Download icon in the email's row to save a copy of the email to your local file system. The email is exported in .eml format. You can open it with an email client or a text editor to check if there are any problems with the email which prevent ConSol CM from processing it.
  • Delete an email: Click the Delete icon in the email's row to remove the email from the database. The email will be deleted and cannot be recovered.