Knowledgebase: WHM > Email > Mail Queue Manager
Mail Queue Manager
Posted by Matthew Jeffels, Last modified by Matthew Jeffels on 24 December 2016 01:43 PM

Mail Queue Manager

This interface allows you to view, delete and attempt to deliver messages that the system has not yet delivered to their destinations. This could be as a result of the sender addressing the email to an invalid host or address.

View Qued Emails

In order to view the queued messages on the server you will need to perform the following;

Enter the search term conditions for your query.

Enter your search criteria into the Search... text box.

In the Select Query menu, select the portion of the message to query. If you do not wish to restrict your search to a specific filter, select No Filter.

In the Search Type menu, select how the search function matches your criteria. Partial matches will require more time to run than the "Begins With" and "Exact matches" criteria.

If you wish to specify a period of time to search within you will need to enter the "Start Date", "Start Time", "End Date", and "End Time" values to specify the date range for which you wish to view sent mail.

Finally click "Run Report".

The search feature does not search the body of the queued messages.
The results will remain filtered until you clear the search box.

The Results Table

By default, the system sorts the results for your query into columns these are as follows;

Time Received - The time at which the email message arrived at the destination server.
Sender - The email address that sent the message.
Message ID - The message's unique identifier.
Recipient(s) - The email address to which the user sent the message.
Size - The size of the message.
Status - The status of the message.
Action - Click the icon to view information about the selected message. When this report displays, you can also perform the following actions;

Delete Message
Deliver Message Now
Return to Mail Queue.

We go over the Delete and Deliver actions in more detail in the following sections. If an email has multiple invalid destination addresses (To, CC, and BCC addresses), the message will still only appears once in the table.

Customize Output Results

You can add additional columns to the results table to view more information. In order to add columns you will need to perform the following;

Click the icon in the top right corner of the results table, and select the checkbox for the information that you wish to view in the table.
To hide information from the table, deselect the checkbox.
To automatically select the default columns, click "Reset to Default".

Delete Messages

The system cannot send emails that users have sent to incorrect addresses. As a result you must delete these messages from the Mail Queue Manager list. To delete emails you will need to perform the following;

Select the checkbox for each email that you wish to delete.
Click "Delete Selected".
A new window will display. Click "OK".

To delete all of the emails in the list, perform the following;

Be aware that this function deletes all emails, from both the filtered list and mail queue. You should only use this if you wish to delete all emails from your mail queue.

Click "Delete All".
A new window will display. Click "OK" to confirm that you wish to delete all emails.
Another new window will display. Click "OK".

Deliver Messages

You may also attempt to deliver queued emails, to do this you will need to perform the following;

Select the checkbox for each email that you wish to send.
Click Deliver Selected.
A new window will display. Click OK .

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

To attempt to deliver all of the server's queued mail, perform the following steps: This function attempts to deliver all of the queued mail on the server, both from the filtered list and mail queue.

Click Deliver All. A new window will display.
Click OK.

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

Unfeeze an Email

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

The system will not attempt to deliver the message again until you manually unfreeze the message, or the system reaches a timeout.

In order to unfreeze a message, click the unfreeze icon () that corresponds to the desired message. A new window will open to confirm that the system has unfrozen your message. This icon will only appear when the status of the message is labeled as frozen. You will only be able to unfreeze one message at a time. If several frozen messages appear in your "Mail Queue Manager", it may be worth examining the log file (/var/log/exim_mainlog) to find the cause and troubleshoot Exim.

Thanks

Matt Jeffels
PAC Web Hosting

 

(0 vote(s))
Helpful
Not helpful

Comments (0)