Failed incoming emails

Introduction to failed incoming emails in ConSol CM

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.

Concepts, terms and definitions

Concept	Other terms	Definition
failed incoming email		Email which was fetched from the mail server and saved to the database because it could not be processed.
mail server		Software to transfer email messages between clients, not part of ConSol CM.

Purpose and usage

Emails which could not be processed are listed on the Failed incoming emails page. This is usually caused by one of the following reasons:

• One of the email scripts (see Scripts of the type Email) 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.

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

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: Perform a free 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.