

   MailSend : A Shareware command-line Internet mailer for Window 95 and NT

   Version 5.01 ( Trial version )

   Copyright (c) 1997 by James K. Lawless
   Email: jimbo@radiks.net
   Web:   http://www.radiks.net/jimbo


   Table of Contents

      What is MailSend?
      Installing MailSend
      How does one use MailSend?
      Can MailSend be used to send mail to multiple people?
      Can one send attachments with MailSend?
      Is MailSend "crippleware"?
      Registering ( paying for use of ) MailSend
      Upgrading from a prior version of MailSend ( MailSend )
      Disclaimer
      Help!  What to do if you encounter problems.
      Technical Specifications
      Distribution
      Frequently Asked Questions


   *-- What is MailSend?

      MailSend is a utility that allows one to send Internet e-mail from
      the Win95 or NT command-line.  This includes the ability to send
      Internet e-mail from batch files.

      In addition to the transmission of text files, MailSend is capable
      of sending multiple binary attachments with any message.  This
      feature allows the user to send executable files or word-processor
      documents as attachments to any mail item.


   *-- Installing MailSend

      If you are reading this, you have already unzipped the archive
      containing MailSend ( MSEND501.ZIP ).

      There is no further installation necessary ( no registry changes
      or INI file entries ).


   *-- How does one use MailSend?

      The MailSend command-line is as follows:

         MailSend file smtp-server to from [ options ]
         
      Where:
         "file" is the text-file that you desire to send

         "smtp-server" is the name or IP address of the SMTP server
         that you need to use to send e-mail ( ask your Internet provider
         for this address or name ).

         "to" is the e-mail address for the recipient of the e-mail.

         "from" is the e-mail address for the sender ( that's usually you!)

      Options:
         -s subject  -  Sets the subject topic for a message.

         -a filename -  Attaches specified file to message using
                        MIME Base64 encoding ( compatible with most
                        Internet e-mail packages ).

         -f filename -  Reads a list of filenames from the file
                        specified in "filename".  Each filename must
                        be on a separate line with no extra spaces.
                        Each file will be attached using MIME Base64
                        encoding.

      Let's say, for instance, that you want to send file MAGAZINE.TXT to
      user snorky@wubble.kom and you are fred@gronk.kom and your SMTP
      address is simply named gronk.kom, the MailSend command-line would
      look like this:

         MailSend MAGAZINE.TXT gronk.kom snorky@wubble.kom fred@gronk.com

      MailSend will display a running status of it's session with your
      SMTP server.  For the above example, the messages would look something
      like the following:

         MailSend v1.03 attempting connection to radiks.net
         Connection successful.
         *** 250 gronk.kom Hello dial24.gronk.kom [0.0.0.0],
             pleased to meet you
         *** 250 <fred@gronk.kom>... Sender ok
         *** 250 <snorky@wubble.kom>... Recipient ok
         *** 354 Enter mail, end with "." on a line by itself
         Send complete!

      The messages are typical responses from an SMTP server.  If
      MailSend encounters response codes that differ from the above,
      it will abort the MailSend operation ( and will exit with a
      return code of 1 ).


   *-- Can MailSend be used to send mail to multiple people?

      While MailSend can only be used to send one e-mail at a time,
      it's fairly easy to concoct a batch file to send mail to
      multiple people.

      Suppose that you wanted to create a batch file that would
      always send a specified file to several members of a group
      or mailing list.  The batch file might look something like the
      following ( we'll call it SEND.BAT):

         MailSend %1 gronk.kom snorky@wubble.kom   fred@gronk.com
         if ERRORLEVEL 1 goto abort

         MailSend %1 gronk.kom wudzo@warble.kom    fred@gronk.com
         if ERRORLEVEL 1 goto abort

         MailSend %1 gronk.kom freen@aragones.kom  fred@gronk.com
         if ERRORLEVEL 1 goto abort

         echo Mail sent!
         goto end

         :abort
         echo Errors! Process aborted

         :end

      Then one would simply have to invoke SEND.BAT to send MAGAZINE.TXT
      to the above people via the following command-line:

         SEND MAGAZINE.TXT


   *-- Is MailSend "crippleware"?

      Nope.  MailSend is fully functional.  The trial version does cause
      a short message to be prefixed to every mail item sent with
      MailSend.  This message is as follows:

        This message was sent via an unregistered trial copy of
        MailSend v 5.01.  Visit http://www.radiks.net/jimbo to
        obtain your own trial copy of MailSend.

      Upon registration, a fully functional version of MailSend will
      be made available electronically ( either via e-mail or via
      the Web ).  The fully functional version does not contain the
      above message.


   *-- Registering ( paying for use of ) MailSend

      MailSend is shareware.

      It is not free.

      You may use it for a trial period of 30 days.  If you continue
      to use it after 30 days you are required to register the software.

      The registration fee for the software is $10.00 in U.S. funds for
      each copy that has a potential to be used ( i.e. if you have 5
      people in your company and 4 of them may need to use MailSend, you
      are required to pay 4 registration fees ).

      Perhaps MailSend will be installed on an autonomous server machine
      for use as an automatic mailer.  In this case, a registration
      is due for each machine upon which MailSend will be installed.

      Please remit payment by check ( drawn on a U.S. Bank ) to:

         James K. Lawless
         2414 4th Avenue
         Council Bluffs, IA 51501

      If you live outside of the U.S., please contact me via e-mail at
      jimbo@radiks.net to work out details.


   *-- Upgrading from a prior version of MailSend ( MailSend )

      If you had registered a version of MailSend your upgrade to 5.01
      is free.  I will have attempted to contact you via e-mail to
      arrange transmission of the full version of MailSend 5.01.

      Thank you very much for your support!


   *-- Disclaimer

      I claim no responsibility nor liability for damages incurred to
      hardware / software during usage of MailSend.  Nor am I responsible
      for any monetary losses related to use of MailSend.  Use MailSend
      at your own risk.


   *-- Help!  What to do if you encounter problems.

      If you encounter problems using MailSend, please report the
      problem to me via e-mail.  It would be most helpful if you could
      capture the output of MailSend into a file as follows ( the
      following is just an example, you'll need to supply your own
      e-mail addresses and such ).

         MailSend MAG.TXT gronk.kom s@w.kom fred@gronk.com > ERR.TXT

      The  "> ERR.TXT" at the end of the command will route the output
      into a file called ERR.TXT.  If you could e-mail me this file
      along with a description of your problem it would make it easier
      for me to try and fix the problem.


   *-- Technical Specifications

      MailSend was written in a variant of the AWK programming language
      called TAWK ( Thompson Automation AWK ) for Win95/NT.

      It addresses an SMTP server by issuing a connection to port 25
      of the specified SMTP server, first issuing a HELO, followed by
      a MAIL FROM:, RCPT TO:, DATA, ., and closes with a QUIT.

      Response 250 is anticipated from MAIL FROM: and RCPT TO:.  Response
      354 is expected from DATA.

      Standard MIME message-headers are used to shroud the message.

      No other responses are checked after the "." is issued.


   *-- Distribution

      You may not resell MailSend, but you may include it on media
      such as CD-ROM shareware collections.  You may also upload it
      to any BBS or place it on any FTP site or Web page.

      If you would like to bundle MailSend with a commercial application
      please contact me to negotiate a licensing agreement.


   *-- Frequently Asked Questions

      Q: How does one specify the "subject" line with MailSend.

      A: In versions 1.03 and 1.04 of MailSend, the subject line had
      to be specified by placing the line "Subject: your subject here"
      at the top of text file being sent.

      Changes to the way MailSend bundles the message in 5.01 have
      caused this technique to become obsolete.  The preferred method
      is to use the new "-s" command-line parameter.  The argument
      for "-s" may be enclosed in double-quotes so that spaces can
      be included in the subject line.


      Q: I clicked on MailSend from Explorer and a DOS-looking windows
      flashed on and off before I could read what it displayed.  What
      gives?

      A: MailSend is a console-mode application.  It runs using a
      DOS-like character-based interface.  It is not intended to be
      a GUI app.  If you don't understand what I'm describing, MailSend
      is likely not a utility for your arsenal.


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

      A: MailSend does not come prepackaged with a supplemental tool
      for automating control of dial-up networking.  




