Page 103 - Mercury Manual.book
P. 103
MSendTo, the commandline mailer 98
Configuration mode
addresses contains a space character, the entire list must be enclosed between a pair of dou-
ble-quote characters.
Locating the queue If you do not specify -QUEUE on the commandline, and no default queue
directory has been defined in configuration mode, MSendTo will query the Windows registry
to see if a copy of Mercury is installed on this computer: if it is, it will retrieve the queue di-
rectory it should use from the registry and will write the outgoing message there. If no registry
entry exists and no queue location has been specified, MSendTo will issue an error.
Format of body file The file you pass as the parameter to the -BODY option should be a plain
text or HTML file containing only US-ASCII characters (future versions of MSendTo may
allow accented and international characters). MSendTo does not encode or otherwise alter the
file you pass: in particular, it does not wrap lines, so it is up to you to ensure that all the lines
in the message conform with the RFC2821 limit of 1000 characters maximum length. If the
body file has the extension .HTM or .HTML, MSendTo will assume that it contains HTML
data and will declare the message as the MIME text/html type, otherwise it will declare it
as the standard MIME text/plain type.
Configuration mode
Running MSendTo in configuration mode starts an interactive session where it will prompt
you for certain pieces of information that it will use to create a default configuration file. The
settings in the default configuration file are used when no matching setting is provided on the
commandline in future sessions.
To run MSendTo in configuration mode, enter the command –
MSendTo -CONFIG
The program will prompt you for the settings it needs, one at a time, providing a description
of each setting as it goes. For each setting, you can either type in a new value, enter a single
‘-’ (dash) character to clear the setting, or press <Enter> to leave the current value un-
changed. You do not have to provide values for every setting – only the ones that you need.
If you clear a setting or leave it blank, it will have no effect on future sessions.
At the time of writing, MSendTo supports five configurable options, although more may be
added over time. These options are:
Queue directory Specify the location of the Mercury submission queue directory where
MSendTo should create outgoing messages. Any default setting you enter is always overrid-
den by a -QUEUE commandline option.
Hostname The domain name MSendTo should use when auto-forming addresses. This op-
tion is not currently used, but may be in future.
Default sender Allows you to specify a default value for the -FROM commandline option. If
a default sender is defined and no -FROM option is present on the commandline, then the de-
fault sender will be used as the “From” field for the message.
Default recipient Allows you to specify a default value for the -TO commandline option. If
this option is defined and there is no -TO field present on the commandline, it will be used to
create the “To” field for the message.