home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TXMAIL11.ZIP / TXMAILER.DOC < prev    next >
Text File  |  1996-07-18  |  15KB  |  316 lines
  1.  
  2.                                                         ▄▄     ▄▄
  3.            ▀▀▀▀█▀▀▀▀ █▀▀▀▀▀▀▄ ▄▀▀▀▀▀▀▄ █▄     █ █▀▀▀▀▀▀  ▀█▄ ▄█▀
  4.                █     █▀▀▀▀▀▀▄ █▀▀▀▀▀▀█ █ ▀▀▄▄ █ ▀▀▀▀▀▀█    ▐█▌
  5.                █     █      █ █      █ █     ▀█ ▄▄▄▄▄▄█  ▄█▀ ▀█▄
  6.                                                        ▄█▀     ▀▀
  7.                                                      ▄█▀  Mailer
  8.            Internet/Fidonet Transporter            ▄█▀
  9.            Copyrighted Multiboard Communications Centre, 1995-1996
  10.            All rights reserved                 ▄█▀
  11.                                              ▄█▀
  12.  
  13. ╓────────────────────────────────────────────────────────────────────────────╖
  14. ║  Introduction                                                              ║
  15. ╙────────────────────────────────────────────────────────────────────────────╜
  16.  
  17.    What is it?
  18.  
  19.      ■ TxMAILER is a package that will use SMTP and POP3 to send and
  20.        retrieve TransX mail bundles from your standard email account.
  21.  
  22.      ■ TxMAILER is only designed to be used with TransX v1.1 or higher
  23.        and does not function as a stand-alone package.
  24.  
  25.    How does it work?
  26.  
  27.      ■ What it does is dial your internet provider over a SLIP/PPP link
  28.        and once connected sends your outbound TransX bundles with SMTP
  29.        then scans your POP3 mailbox for any TransX mail.  If it finds
  30.        any, it will save them to disk for TransX to process and remove
  31.        them from your mailbox.
  32.  
  33.      ■ If you normally use this same mailbox for your personal mail and
  34.        download it with something like Eudora(r), Microsoft Exchange(r)
  35.        or Microsoft Mail/News(r) you will need to take precaution to make
  36.        sure that mail for TransX is not deleted from your mailbox when you
  37.        transfer mail from your host to your machine.  Some of the readers
  38.        mentioned above will allow you to specify whether mail should
  39.        automatically be deleted from your mailbox.  If not you must always
  40.        run TxMAILER before downloading your mail otherwise your regular
  41.        mail client will download all the mail and delete it from the
  42.        mailbox, including the TransX mail rendering TxMAILER useless.
  43.  
  44.      ■ An optimal solution would be to ask your internet provider if you
  45.        can have a secondary mailbox.  Most providers will do this for
  46.        free or for a very nominal charge.  Get your second mailbox named
  47.        something like "userid-tx", in my case "rocca-tx" this would
  48.        become your robot name in TransX, as well as your mailbox name.
  49.        Then all of the TransX mail could be sent and received from
  50.        "userid-tx@yourisp.com" leaving your personal mailbox untouched
  51.        by TransX or TxMAILER.
  52.  
  53.    How much work is it to run and maintain?
  54.  
  55.      ■ Once setup, this send and receive transfer process is fully
  56.        automated and runs from a batch file which is automatically
  57.        created each time you run TXBUILD.EXE
  58.  
  59.  
  60. ╓───────────────────────────────────────────────────────────────────────────╖
  61. ║ Installing                                                                ║
  62. ╙───────────────────────────────────────────────────────────────────────────╜
  63.  
  64.    Installing TxMAILER couldn't be simpler.
  65.  
  66.     1) Simply extract the archived package into the SAME directory
  67.        you have TransX installed into. (if you have not yet installed
  68.        TransX you will need to before installing TxMAILER)
  69.  
  70.     2) Run TXSETUP.EXE (from your original TransX installation)
  71.  
  72.        Configure TransX to use SMTP as the Advanced Spool Type.
  73.        Also specify the SMTP In and Out directories.
  74.  
  75.        ┌──┤ Advanced Options ├──────────────────────────┐
  76.        │                                                │
  77.        │  Advanced spool                                │
  78.        │   └ Type     : SMTP (In/Out)                   │
  79.        │                                                │
  80.        │  SMTP options                                  │
  81.        │   ├ SMTP In  : M:\TRANSX\SMTP\IN\              │
  82.        │   ├ SMTP Out : M:\TRANSX\SMTP\OUT\             │
  83.        │   └ Time zone: -0500                           │
  84.        │                                                │
  85.        └────────────────────────────────────────────────┘
  86.  
  87.        Please note that the In and Out directories MUST be different
  88.        from each other, otherwise you will lose mail packets.
  89.  
  90.        You'll also need to configure your General Information to
  91.        reflect your SLIP/PPP setup.
  92.  
  93.        ┌──┤ General Information ├─────────────────────────┐
  94.        │                                                  │
  95.        │  Sysop         : Joe User                   (a)  │
  96.        │  System name   : Joe's BBS System           (b)  │
  97.        │  Domain        : yourisp.com                (c)  │
  98.        │  Site address  : 1:999/9238                 (d)  │
  99.        │  Gate address  : 0:0/0                      (e)  │
  100.        │  Gate netflags : Kill/Direct                (f)  │
  101.        │  Robot name    : transx                     (g)  │
  102.        │                                                  │
  103.        └──────────────────────────────────────────────────┘
  104.  
  105.        (a) Your name
  106.        (b) Your BBS name
  107.        (c) Your providers domain name
  108.        (d) Your main Fidonet style address
  109.        (e) 0:0/0
  110.        (f) Kill/Direct
  111.        (g) Your mailbox name (usually)
  112.  
  113.     3) Edit the LOGIN.CMD and LOGOUT.CMD script files to log you on and
  114.        off your internet provider.  The commands that are available are
  115.        as follows:
  116.  
  117.        START                - The script begins with this line
  118.        DEBUG ON             - You can turn on display debugging
  119.        HANGUP               - Attempt to hangup
  120.        SEND <string>        - Sends the 'string' to the modem
  121.        SEND                 - Sends a CR/LF to the modem
  122.        WAIT <time> <string> - Waits up to 'time' seconds for 'string'
  123.        WAIT <time>          - Waits 'time' seconds
  124.        PRINT <string>       - Displays 'string' to the console
  125.        FINDIP               - Start searching for a dynamic IP number
  126.        END                  - Signal that the script was successful
  127.  
  128.        There are sample LOGIN.CMD and LOGOUT.CMD files included.
  129.  
  130.     4) Run TXBUILD.EXE, and fill in the required information.  There is
  131.        also online help available by pressing "F1".  Each time this program
  132.        exits, it will create/update the TXFULL.BAT file which is what you
  133.        will need to run in order to handle all of the processing.
  134.  
  135.  
  136. ╓───────────────────────────────────────────────────────────────────────────╖
  137. ║ Running                                                                   ║
  138. ╙───────────────────────────────────────────────────────────────────────────╜
  139.  
  140.    Now you just run TXFULL.BAT to transfer your mail whenever needed.
  141.    This batch file will:
  142.  
  143.      * Make sure that all the required files exist
  144.      * Make sure that all the drivers are loaded
  145.      * Export your TransX mail
  146.      * Dial your internet provider
  147.      * Transfer the mail
  148.      * Hang up
  149.      * Unload the installed drivers
  150.      * Import any TransX mail received
  151.  
  152.  
  153. ╓────────────────────────────────────────────────────────────────────────────╖
  154. ║  Common Questions and Answers                                              ║
  155. ╙────────────────────────────────────────────────────────────────────────────╜
  156.  
  157.    First of all, thanks for reading this section!
  158.  
  159.    Q) Which do you recommend SLIP/CSLIP/PPP?
  160.  
  161.    A) If you have the option, we would suggest using the SLIP or CSLIP
  162.       installation, as we have found those drivers to be the most reliable.
  163.       In addition the dialer PPP does not have as much functionality as
  164.       the TxDIALER package.
  165.  
  166.    Q) The mail gets downloaded from my provider ok, and I see it sitting
  167.       in the inbound SMTP directory I have defined, but TransX just
  168.       ignores it?
  169.  
  170.    A) This is often caused by having the incorrect domain address for
  171.       your provider.  Many providers have their 'root' domain, for
  172.       example "site.com", but email addresses are on another domain
  173.       for example "galaxy.site.com".  You can find out for sure by
  174.       turning on DEBUG logging in TXSETUP, then when you run TransX
  175.       you should see something like:
  176.  
  177.       = Opening at 15 Jun 96  09:50:38
  178.       & 0 routing entries
  179.       & Skip; to userid-tx@storm.site.com (SMTP), from ...
  180.       = Closing at 15 Jun 96  09:50:38
  181.  
  182.       In this case, the domain name is "storm.site.com", and the
  183.       robot name should be "userid-tx"
  184.  
  185.    Q) I can only get one mailbox from my provider, will TxMAILER
  186.       delete my non-TransX mail?
  187.  
  188.    A) TransX will only download mail that has "Receipt" or "Transport"
  189.       as the subject line.  There is a chance that other mail could
  190.       have these subject lines.  If this is a heavy concern, you should
  191.       seek out another provider who can offer you a second mailbox.
  192.  
  193.    Q) TxMAILER says it can't resolve <name>?
  194.  
  195.    A) Make sure that your Gateway, Netmask and Name Server entries
  196.       are correct in TxBUILD.  If you are unsure of what the values
  197.       should be, then please contact your internet provider for the
  198.       correct addresses.
  199.  
  200.    Q) I keep getting an error message saying <something> but can't
  201.       get past it?
  202.  
  203.    A) Please send us a copy of your log file and we will try to
  204.       get it solved as quickly as possible.
  205.  
  206.  
  207. ╓───────────────────────────────────────────────────────────────────────────╖
  208. ║ Support                                                                   ║
  209. ╙───────────────────────────────────────────────────────────────────────────╜
  210.  
  211.    If you have any questions or comments, you can netmail us at FidoNet
  212.    address 1:2401/305 (CM,V34,VFC).  Please poll back for your replies
  213.    as we get dozens of messages a day or optionally make a note that you
  214.    would like your message routed back to you.  You can also contact us
  215.    via the internet for faster responses, and directly sent out replies.
  216.    The address is "support@multiboard.com"
  217.  
  218.    You can also find us in the RA_UTIL echo conference, as well as the
  219.    MCC_SUPPORT echo of course.
  220.  
  221.    The newest MCC software is also available via the internet:
  222.  
  223.    http://www.multiboard.com/
  224.    ftp://niesc.k12.in.us/pub/multibrd/
  225.    ftp://pcmicro.com/multiboard/
  226.  
  227.    You can also "FREQ" the files from us via FidoNet at 1:2401/305
  228.    Our system is online and taking requests 24 hours/day
  229.    The magic name for the newest version of TransX is "TRANSX"
  230.    The magic name for the newest version of TxMAILER is "TXMAILER"
  231.    Freq "CATALOG" for the newest list of our other products.
  232.  
  233.    You can help us direct your messages by using the alternative email
  234.    addresses when posting us mail:
  235.  
  236.     (1)  support@multiboard.com      -  general inquiries
  237.     (2)  sales@multiboard.com        -  registrations/commercial info
  238.     (3)  suggestions@multiboard.com  -  suggestions
  239.     (4)  reports@multiboard.com      -  bug reports
  240.  
  241.    Thanks for your interest and support!
  242.  
  243.  
  244. ╓───────────────────────────────────────────────────────────────────────────╖
  245. ║ Changes                                                                   ║
  246. ╙───────────────────────────────────────────────────────────────────────────╜
  247.  
  248.   v1.0 - First release
  249.  
  250.   v1.1 - Made some small changes to the dialing package
  251.  
  252.        - Fixed a bug that would cause it to not be able to
  253.          detect the IP address in SLIP mode if your provider
  254.          used a particular type of IP notification message
  255.  
  256.        - Fixed a bug that could cause a lockup while trying to
  257.          send the encoded messages
  258.  
  259.  
  260. ╓───────────────────────────────────────────────────────────────────────────╖
  261. ║ License and Disclaimer                                                    ║
  262. ╙───────────────────────────────────────────────────────────────────────────╜
  263.  
  264.    TxMAILER is FREE, provided you have registered or bought a commercial
  265.    copy of "TransX".  If you are using the unregistered shareware version
  266.    of TransX, then you have fourteen (14) days to evaluate TxMAILER.
  267.  
  268.    TransX is being marketed under the "try before you buy" or the shareware
  269.    concept.  You are entitled to use TransX for a period up to thirty (30)
  270.    days, after which you MUST register or stop using the program.
  271.  
  272.    Registration will also you to use all of the available functions of
  273.    TransX, and help to continue the development of this program.  (not
  274.    to mention maintain the legality of this agreement)
  275.  
  276.    By running any of the executable programs included, you agree that
  277.    Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  278.    affiliates of the above mentioned are responsible for any damage or
  279.    loss experienced, however so created.  If you cannot agree to this,
  280.    then your privilege to use any of these programs is revoked and it
  281.    becomes illegal for you to execute any programs included with this
  282.    documentation.
  283.  
  284.    You may freely copy and distribute the shareware version of TransX as
  285.    long as its original archived contents are not modified in any way.
  286.    You may NOT distribute any registration keys without the expressed
  287.    written consent of Pete Rocca of Multiboard Communications Centre.
  288.    You may not use a registration key that is not licensed to you by
  289.    Pete Rocca, or any of the registration sites appointed by Pete Rocca.
  290.  
  291.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  292.    any components of TransX or its archive components in any manner.
  293.  
  294.    TransX and its encoding and security algorithms are the legal
  295.    property of Multiboard Communications Centre.  They may not be used
  296.    in any other program other than TransX without the express written
  297.    consent of Pete Rocca of Multiboard Communications Centre.
  298.  
  299.    This product, concept and design are protected by Canadian copyright
  300.    laws and international treaty provisions.  If dispute of any issues
  301.    on legal grounds said above, then governing law of Ontario, Canada
  302.    will rule.  If you agree to all of the above, then you may use
  303.    these programs.
  304.  
  305.    * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU SAVE *
  306.  
  307.    The TCP/IP stack of this product was developed with the WATTCP TCP/IP
  308.    library routines copyright (c) 1990-1993 Erick Engelke.  The TxMAILER
  309.    package is also bundled with the CSLIPPER packet driver courtesy of
  310.    and copyrighted by Peter R. Tattam.  The PPP packet driver is courtesy
  311.    and copyrighted by Merit Network Inc.
  312.  
  313.    Eudora(r), Microsoft Mail/News(r) and Microsoft Exchange(r) are owned,
  314.    copyrighted and/or trademarked by their respective companies.
  315.  
  316.