Qtop utility

Display the most frequently occurring envelope From, envelope To, Subject:, or message content fields found in message files in the channel queues.

Syntax
imsimta qtop &#x5b;channel&#x5d;

Restrictions
Privileges sufficient to read files in the MTA channel queue directory tree, as well as read the  MTA queue cache database, are  required.

Optional parameter which specifies a specific MTA channel area to be scanned for string frequencies. or   wildcard characters may be used in the channel specification.

Description
Display the most frequently occurring envelope From, envelope To, Subject: field, or  message content fields found in message files in the channel queues. (Note that  message files are not checked or  displayed by this utility.) By default, only Subject: fields are shown. Use  to display frequent  envelope From fields,   or   to display frequent  envelope To fields,  or   to display frequent  message contents. Any combination of,   ,  , and  may be specified. However, only one of each may be used.

The optional channel parameter restricts the scan to message files in  the specified channel. The channel parameter may use  and    wild cards.

By default, the top 20 most frequently occurring fields are shown  provided that they occur 2 or more times. Use the  and    switches to alter this behavior. Also by default, only message files identified by the  queue cache database are  scanned. Use the   switch to instead scan all message files actually present in the  channel queue directory tree.

The  switch may be used to accelerate scanning  on multiprocessor systems by dividing the work amongst multiple,  simultaneously running threads. To run   simultaneous scanning threads, specify. The value   must be in the range 1-8. The default is.

The,  ,  , and    switches accept the optional qualifiers     and    . These qualifiers indicate the starting offset and number of bytes in the  field to consider. The defaults are ,   ,   ,  and. Use of these qualifiers is useful when, for example, trying to identify occurrences  of a spam message which uses random text at the start of the Subject:  line.

&#x5b; &#x5d;, &#x5b;  &#x5d;,  &#x5b;  &#x5d;,  &#x5b;  &#x5d;,  &#x5b;  &#x5d;,  &#x5b;  &#x5d;,  &#x5b;  &#x5d;
The,  ,    (synonym  ),    (synonym  ), and    switches are used to specify which frequently  occurring fields should be displayed. By default, only Subject: fields are shown. Use  to  display frequent envelope From fields,   or   to display frequent envelope To fields,  or   to  display frequent message contents. Any combination of ,  ,    (synonym  ),   (synonym   ), and   may be specified. However, only one of each may be used. The,   ,   (synonym   ),   (synonym  ),  and   switches accept the optional qualifiers     and    . These qualifiers indicate the starting offset and number of bytes in the  field to consider. The defaults are ,   ,   ,  and. Use of these qualifiers is useful when, for example, trying to identify occurrences  of a spam message which uses random text at the start of the Subject:  line.

(default),
The  switch, the default, specifies that only  message files identified by the  queue cache database be searched. Use the   switch to instead search all  message files actually present in the channel queue directory tree.

,  (default)
is the default and means to scan all messages queued in a channel. means to scan only those files which are not   files; that is, only those files  which have already had at least one delivery attempt.

By default, a string must occur at least 2 times,  =2, in order to be displayed.

By default, output goes to. The   switch may be used to direct the utility&#x27;s  output to a file instead.

,  (default)
The  switch may be used to accelerate searching  on multiprocessor systems by dividing the work amongst multiple,  simultaneously running threads. To run   simultaneous searching threads, specify    . The value   must be an integer in the range  -. The default is.

By default, the top 20 most frequently occurring fields are shown,.

,  (default)
The  switch may be used to request that the  utility print out information about what it is doing as it operates.

Examples
%QM-I-QCLISTING, building a list of message files to scan from the queue cache %QM-I-SCANNING, scanning 73 message files %QM-I-SCANNED, scanned 73 message files in 0.5600 seconds (130.36 messages/secon d)  Top 20 Envelope From: addresses which occur 2 or more times Count Envelope From: address ====== ======================================================================      27      10  owner-ex-list@acme.com 2 owner-test-list@acme.com Top 20 Subject: header lines which occur 2 or more times Count Subject ====== ======================================================================       6  Re: your ex-list posting 2 Test posting to test-list The above UNIX example shows displaying the most frequently occurring Subject: field and envelope From addresses amongst messages in the MTA  queue area. %QM-I-QCLISTING, building a list of message files to scan from the queue cache %QM-I-SCANNING, scanning 73 message files %QM-I-SCANNED, scanned 73 message files in 0.5600 seconds (130.36 messages/secon d)  Top 20 Subject: header lines which occur 15 or more times Count Subject ====== ======================================================================      25  ake money fast $$$ The above UNIX example shows displaying the most frequently occuring Subject: lines that occur 20 times or more, starting from 12 characters  into the Subject: header value. This may be useful when trying to spot spam that inserts random characters at the beginning of the Subject:  header value.
 * 1) imsimta qtop -subject -env_from
 * 1) imsimta qtop -subject=START=12 -min_count=15