Knowledge base

show topqueues

The busiest queues
The same list, sorted

Prints queues by number of recipients in descending order. The manual calls it equivalent to show queues with –sort=rcpt; the options are the same.

Like show queues, by default it prints twenty queues and the latest recipient events.

The main trap is event noise. Along with the top, the command prints the latest recipient events; for an overview they are removed with –no-rcpt-events.
What the Hub does. It does not call it: it takes the top queues for the “PMTA monitoring” screen with the /queues request.
Recommended values

When to use it:

Question This command or not
the largest queues yes
what the node held back yes — –mode=backoff
all queues no — show queues with –maxitems
The equivalence with show queues –sort=rcpt and the set of options come from the manual (§ 6.3.19, § 6.3.14). The split of questions is ours.
Example configuration
# the largest queues without recipient events
pmta show topqueues --no-rcpt-events
pmta show queues –sort=rcpt –no-rcpt-events gives the same.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
How to check on the node
Find out how many queues remain beyond the top:
pmta show topqueues --no-rcpt-events | tail -1
The last line says how many queues are shown out of how many match.
In the Hub
Cost of a mistake
safe: a wrong value breaks nothing