

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

   Version 5.11 ( Registered version )

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


   Table of Contents
 
      What is MailSend?
      What's new in version 5.11?
      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.


   *-- What's new in version 5.11?

      1)  A bug in the attachment encoding logic was fixed.  If you
      experienced a problem with certain attachments in v 5.01, please
      try the same files with this version.

      2)  Four "blind carbon-copy" command-line options were added.
      Blind carbon-copy functionality allows you to send one e-mail
      ( and attachments ) to multiple recipients.  Please refer to
      the section titled "Can MailSend be used to send mail to multiple
      people?" for detailed information.  You can optionally omit the
      attachments for anyone except the original recipient.

      3) SMTP "To:", "From:", and "Date:" header fields are now
      filled.

      4) MailSend can now be registered by using a credit-card.
      Please see the "Registering ( paying for use of ) MailSend"
      section for detailed information.


   *-- Installing MailSend

      If you are reading this, you have already unzipped the archive
      containing MailSend ( MSEND511.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.

         -bcc address   Sends a copy of the e-mail item ( and any
                        attachments ) to the user specified in "address".
                        The original recipient and does not receive an
                        indication that a copy has been sent to a third-
                        party.

         -bccna address Sends a copy of the e-mail item ( with no
                        attachments ) to the user specified in "address".
                        The original recipient and does not receive an
                        indication that a copy has been sent to a third-
                        party.

         -bccf filename Sends copies of the original e-mail text ( and
                        attachments ) to every e-mail address specified
                        in the text-file "filename".  Each recipient
                        recieves their own copy. 

         -bccfna fname  Sends copies of the original e-mail text ( with no
                        attachments ) to every e-mail address specified
                        in the text-file "fname".  Each recipient
                        recieves their own copy. 

      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 v5.11 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?

      Yes.  Let's examine two possible scenarios.

      Scenario 1: Suppose that you want to send an e-mail (M.TXT) 
      to snorky@w.kom.  Suppose you also want to send the same e-mail
      to snorky's supervisor joe@w.kom.  Suppose that you are
      fred@gronk.kom.  The MailSend command-line to perform
      this action would be as follows.

 MailSend M.TXT gronk.kom snorky@w.kom fred@gronk.com -bcc joe@w.kom

      If you end up sending attachments, you can use -bccna to eliminate
      the attachments from joe@w.kom ... joe would then only receive the
      message text.

      Scenario 2: Suppose that you want to send an e-mail (M.TXT)
      to snorky@w.com and an additional list of users.  Suppose that
      you had the e-mail addresses of your list of users in a file
      called LIST.TXT.  The file LIST.TXT might look something
      like the following:

joe@w.kom
User1@somenet.kom
BigGuy@microblotch.kom

      The following MailSend command would send M.TXT to every user
      in the list.

 MailSend M.TXT gronk.kom snorky@w.kom fred@gronk.com -bccf LIST.TXT

      If you end up sending attachments, you can use -bccfna rather than
      -bccf to omit the attachments for all but the original recipient
      ( in this case, snorky@w.kom ).


   *-- 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.11.  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.

      Please keep in mind that if you register via credit-card through
      RegSoft, I must wait until RegSoft notifies me before I will contact
      you.  If you have not heard from me within 48 hours of registering
      through RegSoft, please contact me via e-mail at:

         jimbo@radiks.net


   *-- 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.

      If you choose to register MailSend via credit-card, you may do
      so via the RegSoft services:

          Via the Web, visit my shareware page
          ( http://www.radiks.net/jimbo/share.html ) and click the
          Register graphic.


          You may register by voice phone toll-free by calling
          888-REG-IT-80 ( in the U.S. ).  International registration
          may be made by calling 770-497-9126.  The product number is
          5508.

          You may register by FAX by faxing your order to the
          770-497-9234.  The product number is 5508.


      Otherwise, 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.11
      is free.  I will have attempted to contact you via e-mail to
      arrange transmission of the full version of MailSend 5.11.

      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.  ( If you
      are interested in the TAWK compiler, please visit the Thompson
      Automation web site at http://www.tasoft.com. )

      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 codes from the SMTP server that are less than 400 are
      accepted as valid.

      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 is not prepackaged with a supplemental tool
      for automating control of dial-up networking.  




