Page 102 - Mercury Manual.book

97 MSendTo, the commandline mailer
Mail mode

MSendTo, the commandline mailer

Mercury is supplied with a commandline mail program called MSendTo.exe, which can be
used to generate quite complex mail messages either from the commandline of a command
prompt, or under program control.

MSendTo can be invoked in one of two ways – in mail mode, or in configuration mode.

Mail mode

Running MSendTo in mail mode simply involves providing it with the basic information it
needs to send a mail message for you. To do this, simply run the program with commandline
options to specify message addresses, content and format. MSendTo recognizes the follow-
ing commandline options (options marked with a * are those that can used default values cre-
ated by running the program in Configuration mode). Note that any command’s parameter
that contains spaces (whether a string or a filename) must be enclosed in double-quote char-
acters on the commandline.

All MSendTo commandline options can be abbreviated to their first two characters: so, -TR
and -TRANSCRIPT are the same option as far as MSendTo is concerned.

Option Description
-TO <address> * Specify the primary recipient of the message
-CC <address> Specify the secondary recipient of the message
-BCC <address> Specify a BCC recipient for the message
-SUBJECT <“string”> Specify the message subject: the subject string must be en-
closed in double-quote characters.
-BODY <filename> Specify a text file containing the message body.
-FROM <address> * Specify the address to be placed in the “From” field of the
message (i.e, the sender address).
-FT <filename> Add a simple text file as an attachment. No encoding or ar-
mouring is applied to the message.
-FB <filename> Add a binary file as an attachment. The file will be ar-
moured using BAS64 encoding in the outgoing message.
-FM <filename> Add a file containing a fully-formed RFC2822-compliant
mail message as an attachment. If there is more than one at-
tachment and they are all of this type, then the message will
be sent in MIME digest format.
-URGENT Mark the message as “urgent”
-DELIVERY Add a header requesting confirmation of delivery.
-TRANSCRIPT <address> * Add a header asking MercuryE to generate a delivery tran-
script and send it to <address>.
-INPUT <filename> Read options from a file. The file should contain any valid
MSendTo commandline options, one per line.
-SIGNATURE <filename> Append the text contained in <filename> to the end of the
message as a signature.
-QUEUE <directory> * Specify the Mercury submission queue where the outgoing
message should be created.
-CONFIG Enter configuration mode (see below)

Specifying multiple addresses Any option that accepts an address, with the exception of the
-FROM option, can be given multiple addresses separated by commas. If the resulting list of