-h                   Display the help screen
  -s subject           Specify subject
  -a filename          Attach filename with MIME
                       base64
  -f filename          Attach files in list
  -smtp smtp_addr      Specify SMTP server address
  -port number         Specify port ( default is 25 ) 
  -to to_address       Specify 'To:' e-mail address
  -from from_address   Specify 'From: address
  -file text_file      Name of text file to send
  -msg string          Specify immediate message to
                       send via the command-line
  -filter              Take text file input from
                       the console stdin device
  -out                 Redirect output to specified
                       filename
  -suppress            Suppress output ( except for
                       error messages )
  -ccf filename        Carbon-copy all recipients 
                       listed in filename
  -bccf filename       Blind-carbon-copy to all
                       recipients listed in
                       filename
  -bccfna filename     -bccf with no attachments to
                       copied recipients
  -bcc cc_address      Send one blind-cc to address
                       specified
  -bccna cc_address    -bcc with no attachments to
                       copied recipient
  -date                Force date header
  -mh                  Allow user-defined message headers
  -tz timezone         Specify time zone string
  -ct  type            Specify content-type ( omitted by default )
  -cte enctype         Specify encoding type( omitted by default)
  -nomime              Omit MIME headers
  -pager               Send in condensed pager format
  -html                Send file as HTML
  -showcc              Show CC: recipients
  -receipt             Request return receipt
  -disp                Request disposition notification
  -ch                  Add custom header(s)
  -timeout             Maximum timeout (in seconds)
  -hide                Hide MailSend command-window (experimental )
  -priority code       Set priority. { highest,high,low,lowest }

If you are a shareware CD vendor, you may include the trial version of MailSend on a CD collection

If you'd like to distribute the trial version of MailSend on a CD packaged in a magazine you may do so.

MailSend -msg -to fred@isp.kom

The -msg option requires a string of characters as an argument. In the sample above MailSend will process the option "-to" as an argument for -msg. The next option MailSend tries to use is "fred@isp.kom". This will display the message

Error! Option fred@isp.kom is not a valid MailSend option.

Error! Missing destination 'To:' e-mail address.

You must either specify a "To:" address ( either by filling in the argument three using the classic syntax or by using the -to option ). Alternately, you may only specify a blind-carbon-copy address.

Error! Missing SMTP server address.

You must specify your SMTP server address. This can be specified as argument two using the classic syntax or by using the -smtp option.

If you don't know what your SMTP address is, you might either look in your normal e-mail client's configuration section, or you could ask your Internet service provider.

Error! Missing 'From:' address.

You must specify YOUR e-mail address, not an alias. This argument may be specified in argument four using the classic syntax or by using the -from option.

Error! Missing -msg, -filter, or input text-file.

This error message occurs if MailSend cannot find a text message to send. You may not send attachments alone in MailSend. A text message must be present.

A message file can be specified as the first argument using the classic syntax or by using the -file option.

The -filter option may be used to filter text from the standard console input device.

The -msg option allows you to specify a brief message on the MailSend command-line.

Error! Carbon-copy and -filter options are mutually exclusive.

When processing carbon-copied items, MailSend re-opens each file for each mail item sent.When using the -filter option, the standard console input device (stdin) is used for input. MailSend is unable to reopen this device for subsequent mail transmissions.

This version of MailSend does not allow the mixed use of the -filter and carbon-copy options for this reason.

Error! The -nomime option may not be specified if attachments are sent with the mail item.

In order to send binary attachments, MailSend utilizes special codes in the e-mail document to indicate where the attachments occur. Attachments can not be sent without MIME encoding.

The -nomime option turns MIME encoding off, which prevents MailSend from being able to send any attachments.

If you are attaching files to an e-mail item, you may not specify the -nomime option.

*** Timeout

The timeout message indicates that some portion of the conversation withthe SMTP mail server has timed out. Please note the 4-character code atthe right of the timeout message when reporting a problem.

Cannot open input file :

This message indicates that the file you specified with the -file option is not available.

Cannot open attachment file :

This message indicates that the file you have specified for alist of attachments is not available.

Cannot open attachment :

This message indicates that the file you have specified for aan attachment is not available.

Cannot open blind CC file :

This message indicates that the file you have specified for alist of blind carbon-copies is not available.

Cannot open CC file :

This message indicates that the file you have specified for alist of carbon-copies is not available.

Cannot open output file :

This message indicates that the file you've specified using the -out option is not availble.

MailSend -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

This message "Hi there" is sent immediately to whoever@whatever.kom from fred@isp.kom.

Sending an e-mail message with a subject

MailSend -s "This is a subject" -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

Specifying options in an external file

The most useful new feature of MailSend is the ability to specify ANY new format option in an external text file. This can shorten MailSend command-lines by specifying frequently used options in this file.

Create a text file called M.CFG in the same directory where MailSend.EXE resides. This file should contain YOUR EQUIVALENT of the following:

     -smtp mail.isp.kom
     -from fred@.isp.kom

Then, on the command-line specify the following:

     Mailsend @m.cfg -to user@wherever.kom

All options in the M.CFG file will act as though you've entered them on the command-line.

Sending an e-mail text file

MailSend  -file SOMEFILE.TXT -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com 

The above example sends the contents of the text file SOMEFILE.TXT to the recipient. Prior examples have depended on the -msg option.

Sending an e-mail from a stdin pipe

If you don't know what this is, don't worry. It's likely that you won't need it.

To send the output of one program via e-mail, the -filter option can be used. Suppose we want to send the output of a DIR command to someone via e-mail. This can be achieved using a command-line similar to the following:

DIR | MailSend  -filter -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com 

Sending an attachment

A single attachment can be sent using the -a option. Suppose we want to attach a file named SOMEFILE.ZIP as an attachment. The command-line would be similar to the following:

MailSend  -a SOMEFILE.ZIP -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachment"

Sending a block of attachments

To send a block of attachments, you must specify a text file which contains the names of all files you wish to attach using the -f option.

Suppose you have a list of files you want to attach in a file called ATTACH.TXT. The command-line for attaching each file to the mail message would be similar to the following:

MailSend  -f ATTACH.TXT -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

Please note that this does not send the file ATTACH.TXT itself.

Sending a blind-carbon-copy

To send a blind-carbon-copy ( a duplicate of the e-mail item where the original recipient does not see the copied user's e-mail address ), use a command-line similar to the following:

MailSend  -bcc hidden@somewhere.kom -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

The above will send one e-mail item to whoever@whatever.kom and will also send a copy to hidden@somewhere.kom. The recipient at hidden@somewhere.kom will see the original recipient's ID in the 'To:' field.

If the original message contains an attachment and you do not intend to send the attachment to the copied user, use the -bccna option.

Sending multiple blind-carbon-copies

To send blind-carbon-copies to multiple recipients, you must create a text file containing the e-mail addresses of each recipient. Suppose this file is called MAILLIST.TXT. The command-line to send blind copies of an e-mail to the list of recipients would look similar to the following:

MailSend  -bccf MAILLIST.TXT -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

Each copied recipient will see the original recipient's ID in the 'To:' field.

To avoid sending attachments to copied recipients, use the -bccfna option.

To send each recipient's e-mail ID in the 'To:' field, omit the -to option and its argument.

Sending normal carbon-copies

To send carbon-copies to multiple recipients, you must create a text file containing the e-mail addresses of each recipient. Suppose this file is called MAILLIST.TXT. The command-line to send blind of an e-mail to the list of recipients would look similar to the following:

MailSend  -ccf MAILLIST.TXT -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

Each copied recipient will see the original recipient's ID in the 'To:' field.

To avoid sending attachments to copied recipients, use the -ccfna option.

Displaying carbon-copy recipients

By default, the recipients of a normal carbon-copy aren't shown in an e-mail generated by MailSend. You must add the -showcc option:

MailSend  -to whoever@wha.kom -ccf MAILLIST.TXT  -showcc  -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

Multiple entries in the To address

To show multiple entries in the to address, use the -ccf or -ccfna options coupled with -showcc, but omit the -to option .

The list that would normally be supplied in the CC: header will appear in the To: header if the -to argument is omitted.

MailSend   -ccf MAILLIST.TXT  -showcc  -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com  -msg "Here's your attachments"

Formatting e-mail addresses

Normally, e-mail addresses are allowed to be paired with an alias for the person's name or the group's name. However, since the formatting of these names requires use of the angle-brackets ( <> ), sending command-line oriented mail is difficult.

Under most Win32 command-processors, the angle-brackets are used to redirect output.

Let us assume you wanted to send an e-mail to Barney Jones whose e-mail address is barjo@zoo.kom. You would need to format the recipient's address as follows:

"Barney Jones {barjo@zoo.kom}"

The curly-braces are used in place of the angle-brackets.

This format of e-mail address can be used on the command-line, the "@" files, and all forms of carbon-copy files.Suppressing output

MailSend output can be suppressed by using the -suppress option.

MailSend -suppress -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

Routing output to an external file

To route the output normally displayed on the screen to an external file, use the -out option. Suppose we want to route the output to a file called OUTPUT.TXT. The MailSend command-line would look similar to the following:

MailSend -out OUTPUT.TXT -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

Forcing 'Date:' header generation

MailSend -date -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

This will cause a 'Date:' header to be generated. MailSend does not currently send a date header that conforms to appropriate e-mail standards. Please use this option only if your SMTP server requires it.

Removing MIME headers

MailSend -nomime -from fred@isp.kom -smtp mail.isp.kom -to whoever@whatever.com -msg "Hi there!"

Some of the people who receive items sent by MailSend have indicated that the body of the message appeared as an attachment. NOTE: Please try to avoid using this as of version 7.00. I've hopefully fixed the attachment difficulties!

If you are not sending attachments, please use the -nomime option to completely omit the MIME headers altogether. It can be less troublesome for certain recipients.

Hide window

MailSend @m.cfg -hide -to usr@x.kom -msg test

This experimental option should completely hide the MailSend window.

Return receipts

MailSend -receipt @m.cfg -to usr@x.kom -msg tmp
MailSend -disp @m.cfg -to usr@x.kom -msg tmp
MailSend -disp -receipt @m.cfg -to usr@x.kom -msg tmp

The above options ask the recipients mail client or mail server to send you a receipt when certain actions have been taken on the mail item.

Voluntary cooperation is often involved in mailers such as Eudora ( which will ask you before sending a return receipt ) but can be automatic for other products.

Controlling the timeout interval

MailSend -timeout 120 @m.cfg -to user@x.kom -msg tmp

The -timeout option allows you to change the default timeout value of sixty seconds to any other value you desire ( in seconds. )

Custom SMTP headers

MailSend  -ch "Errors-To: err@x.kom" -ch "Organzation: AXY Inc."  @m.cfg -to user@x.kom -msg tmp

The custom header option is to allow you to add any headers that MailSend does not already accommodate. It is the single command-line parameter that can be specified multiple times.

If you utilize this option, it's likely that you'll include it in an "@" file.

Sending to a text pager

MailSend  -pager  @m.cfg -to user@x.kom -msg tmp

This will send the message "tmp" to user@k.kom with a minimum of e-mail headers. ( Headers should include "From: *@*" and "Date: * ".

Mailing an HTML file

MailSend  -html  -file what.htm @m.cfg -to user@x.kom -msg tmp

This will send the HTML file what.htm to user@x.kom.



Standard session output

MailSend displays response messages from the SMTP server unless the -suppress option is used. Standard output from a MailSend session might look something like the following:

MailSend v7.22 attempting connection to mail.isp.kom


Connection successful.


*** 250 mail.isp.kom Hello dial24.isp.kom [0.0.0.0],


 pleased to meet you


*** 250 ... Sender ok


*** 250 ... Recipient ok


*** 354 Enter mail, end with "." on a line by itself


Send complete!

     -smtp mail.isp.kom


     -from fred@.isp.kom

Then, on the command-line specify the following:

     Mailsend @m.cfg -to user@wherever.kom

All options in the M.CFG file will act as though you've entered them on the command-line.Please refer to the tutorial section for more information.

Q: Can MailSend be used to send mail to multiple people?

Yes. The -bcc, -bccna, -bccf, and -bccfna options allow one to send "blind" carbon-copies of the given e-mail item to multiple people. The -bccf and -bccfna options process a file that contains a list of e-mail addresses.

The e-mail address specified in the -to parameter will be displayed to each recipient unless this parameter is omitted. If the -to parameter is omitted, each recipient will receive their own e-mail address in the 'To:' field.

Alternately, the -cc and -ccf options may be used for more expedient delivery of each e-mail.

Q: Can one send attachments with MailSend?

Yes. Please refer to the -a and the -f options in the tutorial section.

Q: Is MailSend 'crippleware'?

The trial version of mailsend has limitations which will not hinder testing, but will likely render MailSend unusable for a full production environment. Please refer to the limitations section for more information.

Q: How do I upgrade from a prior version of MailSend?

Currently, all upgrades have been free. If you have registered any previous version of MailSend, please contact me at jimbo@radiks.net to receive the newest registered version.

Q: Help! What if I encounter problems?

Please contact me immediately at:

     jimbo@radiks.net

Q: Do you have a MS-DOS, OS/2, Linux, or Mac version of MailSend?

At this time, no.

Q: How do I use MailSend to automatically log-on / log-off of my Internet Provider Service?

You can't. MailSend is not prepackaged with a supplemental tool for automating control of dial-up networking.

You can, however, use a supplemental tool such as HangUp which can be found at:     http://www.mailsend-online.com/

HangUp can be used to hang up your dialup Internet session.

Priority Code

You can now set your e-mails priority to one of four different levels; lowest, low, high, and highest.

If you'd like to send an e-mail with the highest priority, you'd add -priority highest to your command-line.

From version 7.15

HTML support

If you specify an HTML file ( using the -file option ) and add the new -html option, your message will be tagged as an HTML document.

If the receiver is using an HTML-capable e-mail system, the message should render all of the HTML markup in a manner similar to a web browser.

Text pager support

By specifying the -pager option, the From: and Date: headers are filled with small sequences of characters so that you can send e-mail to a pager via a pager email gateway. The From: address will show as *@*. The Date: header will show as *.

Carbon-copy recipients can now be seen

If you add the -showcc option to your message that uses -ccf, the list of recipients will show in a CC: entry.

If you do not specify a destination with the -to option, the CC list will actually appear in the -to list.

From version 7.00

Attachment bug fix

While not really a bug, I've found that a number of e-mailers don't like either the content-type or content-disposition headers when referring to the main body of the e-mail document.

I found that these headers are optional for plain text, so I removed them. This should alleviate one of several headaches:

1) The appearance of ATT*.* files as extra attachments that don't seem to contain anything.

2) The appearance of your main message as an attachment.

3) The mail server rejects your e-mail due to misunderstood content-type.

Please note that this changes the prior default behavior of MailSend

If you need to add these options, you may do so with the -ct and -cte options.

Timeout control

By specifying -timeout and a parameter indicating the maximum number of seconds you'd like MailSend to wait for responses from your mail server. The default value is 60 seconds.

Receipt and Disposition

You may now specify either -receipt or -disp ( or both ) to coerce your recipient's mail system to send you a return e-mail when they have received and/or read the e-mail sent to them. The success of these options depends on the recipient's mail server and mail client software.

Hide MailSend window

By specifying the option -hide, MailSend will attempt to locate its console window and hide it. I'd be interested in feedback on how well this experimental option works for you.

Custom SMTP header

The new -ch option allows one to add new SMTP headers to the list generated by MailSend. Simply provide a header string as an argument to -ch. ( Such as -ch "Organization: wubba.kom".

Other options you might want to specify could include Reply-To: and Errors-To:.

Comments in carbon-copy files

Comments may now be placed in the text files for carbon-copy or blind carbon-copy lists. Place the "#" character as the first character of a line to comment the line out.

General I/O improvements

MailSend now actively checks for incoming responses from the mail server before assuming that they've been sent. This makes the stability and performance of MailSend much more reliable.

New error messages

New error messages have been added to distinctly alert the client to files specified on the command-line that aren't accessible.

Pause in console help list

There are so many MailSend optionst that they would scroll off of the screen if you type MailSend -h on a command-line. The client is now prompted with a Press ENTER to continue prompt before scrolling the screen.

"Hit it!" bug removed

I removed the debug message "Hit it!" Sorry to everyone who reported this bug for dismissing it as a server-side problem!!!