AQADMCLI: Command-line SMTP queue management for Exchange Server

AQADMCLI is a command-line tool for Exchange Server that can quickly clear up a choked SMTP queue. It used to only be available to customers through Microsoft Product Support Services. Now it's freely available to anyone.

Every Exchange Server administrator will eventually have to deal with an SMTP queue that's choked with message

s.

Sometimes an SMTP queue can be flooded by thousands of non-delivery reports (NDRs) due to spam; and sometimes it can be caused by undeliverable email that has been mistakenly auto-generated.

Clearing the SMTP queue usually involves deleting the files in the queue directory through Windows Explorer or a del *.* command -- but these aren't the only ways to handle the problem.

One way that works directly with Exchange Server instead of through the file system is a command-line utility called AQADMCLI. It sounds like a Roman numeral, but it's actually a tool that Microsoft used to only make available for Exchange Server customers through calls to Product Support Services.

SearchExchange.com contributor Brien M. Posey mentioned AQADMCLI a couple of years ago in his tip, "Stay above the SMTP queue floods". But back then, it was only available as a PSS support-call utility. Now it is freely available for download from Microsoft's FTP site.

To empty out an SMTP queue using AQADMCLI, run it from the command line and type in the following commands:

setserver <servername>
delmsg flags=all
quit

<servername> is, of course, the name of the Exchange server containing the queue you want to manage.

If you want to delete messages by specific criteria instead of just dumping everything, the delmsg command can be given specific flags (as the above syntax implies).

For instance, if you type delmsg flags=SENDER,sender=user@site.org, all messages sent by user@site.org will be flagged for deletion.

Run AQADMCLI HELP and you'll get a complete dump of all the available commands and their syntax.

About the author: Serdar Yegulalp is editor of the Windows Power Users Newsletter.

Do you have comments on this tip? Let us know.

Related information from SearchExchange.com:

  • Tip: Deleting auto-generated spam from the outbound queue
  • Tip: Disk performance best practices for MTA and SMTP queues
  • Tip: SMTP service tuning
  • Tip: Excessive Exchange Server NDRs destroy DNS
  • Learning Guide: How to fight spam on Exchange Server
  • Reference Center: SMTP tips and resources

    Please let others know how useful this tip was via the rating scale below. Do you have a useful Exchange Server or Microsoft Outlook tip, timesaver or workaround to share? Submit it to SearchExchange.com. If we publish it, we'll send you a nifty thank-you gift.

  • This was first published in September 2006

    Dig deeper on Microsoft Exchange Server Administration Tools

    Pro+

    Features

    Enjoy the benefits of Pro+ membership, learn more and join.

    1 comment

    Oldest 

    Forgot Password?

    No problem! Submit your e-mail address below. We'll send you an email containing your password.

    Your password has been sent to:

    SearchWindowsServer

    SearchEnterpriseDesktop

    SearchCloudComputing

    SearchSQLServer

    Close