imsimta qclean (Sun Java System Messaging Server 6.3 Administration Reference)

Sun Java System Messaging Server 6.3 Administration Reference

imsimta qclean

The imsimta qclean utility holds or deletes message files containing specific substrings in their envelope From:address, Subject: line, or content.

Syntax

imsimta qclean
  [-content=substring] [-from=substring][-subject=substring]
  [-to=substring] [-domain_to=substring] [-database] [-delete | -hold]
  [-directory_tree] [-ignore_zz] [-match=keyword] [-min_length=n]
  [-threads | -nothreads] [-verbose | -noverbose] [channel]

Options

The options for this command are:

Option	Description
`-content`=`substring` `-from`=`substring` `-subject`=`substring` `-to=substring` `-domain_to=substring`	Specifies the substrings for which to search. Any combination of `-content`, `-from`, `-subject`, `-to`, and `-domain_to` may be specified. However, only one of each may be used. When a combination of such options is used, the `-match` option controls whether the options are interpreted as further restrictions (`-match=AND`) or as alternatives (`-match=OR`). The -`domain_to` option scans for frequently occurring envelope To: addresses. Identical to the `-to` option, except `-domain_to` looks at only the `host.domain` portion of the envelope To: address.
`-database`	Specifies that only message files identified by the queue cache is searched.
`-delete`	Deletes matching message files.
`-hold`	Holds matching message files.
`-directory_tree`	Searches all message files that are actually present in the channel queue directory tree.
-`ignore_zz`	Ignores queued message files with file names beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt.
`-match=keyword`	Controls whether a message file must contain all (`-match=AND`) or only one of (`-match=OR`) the specified substrings in order to be held or deleted. The default is `-match=AND`.
`-min_length`=`n`	Specifies the minimum length of the substring for which to search. By default, each substring must be at least 24 bytes long. Use the `-min_length` option to override this limit.
`-threads`=`n` \| `-nothreads`	Accelerates the searching on multiprocessor systems by dividing the work amongst multiple, simultaneous running threads. To run `n` simultaneous searching threads, specify `-threads=n`. The value `n` must be an integer between 1 and 8. The default is `-nothreads`.
`-verbose` \| `-noverbose`	Requests that the utility displays operation information (`-verbose`). The default is `-noverbose`.
`channel`	Specifies an MTA channel area to be searched for matching messages. The * or ? wildcard characters may be used in the channel specification.