Return utility

Return (bounce) a mail message to its originator.

Syntax
imsimta return message-file-spec

Restrictions
Must have superuser privileges or be logged in as the MTA user (see the  option in  )  in order to use this utility.

File specification of the message file to return. The specification may include wildcards, but if so, the specification must be quoted.

Description
The  utility returns a message to the  message&#x27;s originator, (unless the original message had NOTIFY=NEVER set, in which case the message is simply deleted without generation of a DSN). The returned message is in three parts. The first part explains the reason why the message is being returned; the text of  the reason is contained in the file     file located in the  MTA language-specific directory. The second part of the returned message is a machine-readable report. The third part contains either the original message itself, or the original message&#x27;s header (depending upon any RET=FULL vs. RET=HDRS setting on the original message, and on whether the original message size triggered application of MTA size limits such as  ).

As regards MTA transaction logging, when it is enabled via the  channel option,  such postmaster manual bounces will result in either a " " (bounce original message with a DSN) or " " (delete original message without a DSN since the original message requested NOTIFY=NEVER) MTA transaction log entry.

Examples
The above UNIX command will cause all of the messages currently in the   channel queue to be returned to their respective  originators (i.e., "bounced").
 * 1) imsimta return &#x27;IMTA_QUEUE:ims-ms/&#x2a;&#x27;

See also:
 * Notification message format
 * langdir MTA Option
 * The required full set of DSN type-specific return_...txt files
 * content_return_block_limit MTA Option
 * MTA transaction log entry format
 * ims-ms channels
 * MTA command line utilities