Mail Queue Manager

For WHM version 11.40

(Home >> Email >> Mail Queue Manager)

Overview

The Mail Queue Manager allows you to view, delete, and attempt to deliver queued messages.

Messages in the Mail Queue Manager have not been delivered to their destinations. For example, messages are placed in your mail queue if they are sent to invalid hosts or addresses that do not exist.

View queued emails

To view messages queued on your server:

  1. Enter your search criteria into the Search... field.
    • note Note: This step is optional.
  2. From the Select Query menu, choose Search Sender, Search Recipient, or Search Message ID.
    • If you do not want to restrict your search to a specific filter, choose No Filter.
  3. Below the Search Type heading, choose how the search function will match your criteria: Begins With, Exact, or Partial.
    • note Note: If you wish to search for a Partial match, there will be a delay in your query.
  4. Use the Start Date and End Date fields to specify the date range for which you'd like to view sent mail.
    • Enter dates as: month, day of month, year. For example, write "April 1, 2007" as 4/1/2007.
    • You can also click calender icon to select the dates you wish to enter.
  5. Use the Start Time and End Time fields to specify the times for which you'd like to view sent mail.
  6. Click Run Report. A list of associated email messages will appear below the search function.

The results table

By default, results for your query are sorted into seven columns.

Column Description
Time Received The time at which the destination server received the email message.
Sender The email address that sent the message.
Message ID The unique identifier for the message.
Recipient(s) The email address to which the message was sent.
Size The size of the message.
Status The status of the message.
Action When you click magnifying glass, a new window will display the message's delivery details.
Above and below the report are three options: Delete Message, Deliver Message Now, and Return to Mail Queue.

A new window will display delivery details.

note Note: If an email was sent to several invalid addresses (includes addresses listed in the CC and BCC fields), only one entry will be listed. You can click magnifying glass for more information.

Customize output results

You can add or remove output columns to customize the results table. By default, all columns should be listed in the table.

To remove columns, click customize icon in the top right-hand corner of the results table and deselect the information you wish to hide. To add information, select the checkbox.

Manage queued emails

After you click Run Report, the emails will appear in a table below the search function where you can:

  • Further narrow the list of messages,
  • View more detailed information about the delivery,
  • Unfreeze queued messages,
  • Delete messages from the queue, and
  • Attempt to deliver queued messages.

Narrow the list of queued emails

To further narrow the list of emails:

  • Enter your search criteria in the Search... field.
    • You can only narrow your search based on the columns shown in the table: Time Received, Sender, Message ID, Recipient(s), Size, and Status.
      note Note: This search feature will not search through the body of the queued messages.
  • The results will stay filtered until you clear the search box.

View and print the delivery report

To see more detailed information for the queued messages, click magnifying glass for the associated message.

A new window will display the message's delivery details. Above and below the report are three options: Delete Message, Deliver Message Now, and Return to Mail Queue.

Use the browser's Print function to print this report.

Deliver queued emails

To attempt to deliver certain emails:

  1. Click the checkboxes next to the emails you wish to send.
  2. Click Deliver Selected.
    • A new window will open. Once the delivery attempt finishes, click OK.

WHM will confirm that it attempted to deliver the message. Under Delivering Messages in Queue, a delivery report will indicate whether this attempt succeeded or failed.

To attempt to deliver all listed emails:
ALERT! Warning: This attempts to deliver all emails, both from the filtered list and mail queue. Only use this if you wish to deliver all emails in your mail queue.

  1. Click Deliver All.
  2. Click OK in the new window to confirm that you wish to deliver all emails.
    • A new window will open. Once the delivery attempt finishes, click OK.

WHM will confirm that it attempted to deliver the message. Under Delivering Messages in Queue, a delivery report will indicate whether this attempt succeeded or failed.

Delete queued emails

Emails that have been sent to incorrect addresses will not be delivered. At some point, you will need to delete these messages from the Mail Queue Manager.

To delete certain emails:

  1. Click the checkboxes next to the emails you wish to delete.
  2. Click Delete Selected from the table.
    • A new window will open. Click OK.

To delete all emails:
ALERT! Warning: This deletes all emails, both from the filtered list and mail queue. Only use this if you wish to delete all emails from your mail queue.

  1. Click Delete All from the table.
  2. Click OK in the new window to confirm that you wish to delete all emails.
    • A new window will open. Click OK.

Unfreeze an email

After several attempts, if a message fails to deliver, the system will "freeze" that message. This practice helps to save system resources, increase queue runs, and reduce chances that the target mail transfer agent will treat your message as spam.

The system will not attempt delivery again until a timeout has been reached or you have manually unfrozen the message.

To unfreeze a message, click frozen . A new window will open to confirm your message was unfrozen.

  • This icon only appears when the status of the message is labeled frozen. You can unfreeze only one message at a time.

If several frozen messages appear in your Mail Queue Manager, examine the log file (/var/log/exim_mainlog) to find the cause and troubleshoot Exim.

Topic revision: r8 - 13 Sep 2013 - 16:15:54 - Main.MeaganBird