home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / pbu_111.zip / PBBSUUCP.DOC < prev    next >
Text File  |  1994-06-07  |  19KB  |  394 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                ┌─────╖ ┌──────╖ ┌───╖  ┌─╖ ┌──────╖ ┌──────╖(TM)
  11.                │ ╓─┐ ║ │ ╓──┐ ║ │   ╙╖ │ ║ └┐ ╓─┐ ║ │ ╓──┐ ║
  12.                │ ╙─┘ ║ │ ╙──┘ ║ │ ╟┐ ╙╖│ ║  │ ║ │ ║ │ ╙──┘ ║
  13.                │ ╓───╜ │ ╓──┐ ║ │ ║└┐ ╙┤ ║  │ ║ │ ║ │ ╓──┐ ║
  14.                │ ║     │ ║  │ ║ │ ║ └┐   ║ ┌┘ ╙─┘ ║ │ ║  │ ║
  15.                └─╜     └─╜  └─╜ └─╜  └───╜ └──────╜ └─╜  └─╜
  16.  
  17.               ╥────┐ ╥───┐  ╥───┐  ╓────┐    Easy Internet
  18.               ║    │ ║   │  ║   │  ║    Electronic Mail Handler
  19.               ╟────┘ ╟───┴┐ ╟───┴┐ ╙────┐ ╥  ┬ ╥  ┬ ╓──┐ ╥──┐TM
  20.               ║      ║    │ ║    │      │ ║  │ ║  │ ║    ╟──┘
  21.               ╨      ╨────┘ ╨────┘ ╙────┘ ╙──┘ ╙──┘ ╙──┘ ╨ V1.11
  22.  
  23.       PBBSuucp.exe Compiled with BC++ V3.1 & MsgApi by Scott J. Dudley
  24.         PUExport.exe Compiled with TP 6.0 and Mark May's MSG ToolKit
  25.                   Other Utils compiled with Turbo C 2.00
  26.  
  27.  
  28.  
  29.                            March 19, 1994
  30.           ┌──────────────────────────────────────────────────────────────────┐
  31.           │▓▓ Table Of Contents ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page II ▓▓│
  32.           └──────────────────────────────────────────────────────────────────┘
  33.  
  34.           Chapter 1 - Introduction............................................
  35.               Features......................................................01
  36.               OverView & System Requirements................................01
  37.               Credits.......................................................02
  38.               Files In Distribution Pack....................................02
  39.               Licensing Information.........................................03
  40.               Installation..................................................04
  41.           Chapter 2 - Configuration...─[ PUSETUP.EXE ]─.......................
  42.               THE FILE MENU...................................................
  43.                   Info......................................................05
  44.                   Credits...................................................05
  45.                   Exit......................................................05
  46.               THE SYSTEM MENU...............................................
  47.                   Paths.....................................................05
  48.                   Site Info.................................................06
  49.               Examples........................................................
  50.                   Command Line Paramters....................................07
  51.                   Batch Examples............................................07
  52.                   ErrorLevels...............................................07
  53.           Chapter 3 - Additional Information..................................
  54.                   Contact Author............................................08
  55.  
  56.           ┌──────────────────────────────────────────────────────────────────┐
  57.           │▓▓ Features ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 1 ▓▓ │
  58.           └──────────────────────────────────────────────────────────────────┘
  59.  
  60.           - Auto Scan the Fido(*.MSG) base for out going mails matches the
  61.             the Internet style address
  62.           - UUCP Site address override
  63.           - Convert the message(s) to correct UUCP message format
  64.           - Replaces "UUCP" in the FROM field to the Internet address where the
  65.             message was sent from
  66.           - Supports the 36 characters limit of both TO and FROM fields
  67.           - 4D Net address format supported
  68.           - Most functions handled internally
  69.           - Full screen Setup
  70.  
  71.           ┌──────────────────────────────────────────────────────────────────┐
  72.           │▓▓ OverView & System Requirements ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  73.           └──────────────────────────────────────────────────────────────────┘
  74.           This program is designed to help those sysops offering UUCP access
  75.           to their users, such as Internet E-MAIL. To write a message to an
  76.           Internet address is a pain, that's where this program comes to play,
  77.           *ease the pain*!
  78.  
  79.           What this program does is allow your users to enter an Internet
  80.           message just like a FidoNet message, with the person's address
  81.           at where it suppose to be, rather a line at beginning of the body
  82.           of the message, where most users are likely to make mistakes. And
  83.           this way reply to an Internet message is easier than ever, no need
  84.           to strip the Internet address, change the destination name etc. All
  85.           they need to do when reply is hit the reply key, type in reply, and
  86.           let PBBSuucp handle the address stripping etc...
  87.  
  88.           Once your user entered such a message, and logged off your BBS, you
  89.           call up the mail tosser/scanner to scan your message for any output
  90.           messages, and moves the entered netmail to the Fidonet Netmail
  91.           directory for delivery. After run the scanner, you call up *THIS
  92.           PROGRAM*, it will scan through your netmail directory and find
  93.           those messages with Internet style address (with "@") at the
  94.           destination field, once a message is found, it redirects the message
  95.           to "UUCP" and add a new line at the beginning of the body of the
  96.           message like "TO: NAME@SOMEWHERE".
  97.  
  98.           Now, the message is all set for transfer through UUCP gateway without
  99.           any error. *IT IS THAT EASY*
  100.  
  101.           Example:
  102.  
  103.           FR: Bing Wu
  104.           TO: someone@somewhere, Panda BBS! (1:282/1016)
  105.           RE: Testing
  106.           --------
  107.           [Message Body]
  108.  
  109.               |
  110.           Converts to
  111.               |
  112.               V
  113.  
  114.           FR: Bing Wu
  115.           TO; UUCP, Panda BBS! UUCP Gate (1:282/1016)      *OR* <<Default
  116.           TO: UUCP, HostMaster (1:1/31)                         <<Override
  117.           RE: Testing
  118.           -----
  119.           TO: someone@somewhere
  120.  
  121.           [Message Body]
  122.  
  123.  
  124.           This program is also able to replace the word "UUCP" from the
  125.           FROM field of the incoming mail to the Internet address specified
  126.           in the message body. If none found, UUCP will be still used.
  127.  
  128.           This program should be able to run on any computer with any kind of
  129.           setup. The Author, however, CANNOT gurantee it will work on your
  130.           computer or/and your system setup.
  131.  
  132.           ┌──────────────────────────────────────────────────────────────────┐
  133.           │▓▓ Credits ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 2 ▓▓│
  134.           └──────────────────────────────────────────────────────────────────┘
  135.           * All Mentioned products in this manual are copyrighted/registered by
  136.             its respective owner(s).
  137.           * PBBSuucp.EXE incorporated MsgApi by Scott J. Dudley
  138.           * PUExport.EXE incorporated MKMSG API by Mark May.
  139.  
  140.           ┌──────────────────────────────────────────────────────────────────┐
  141.           │▓▓ Files In The Package ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  142.           └──────────────────────────────────────────────────────────────────┘
  143.           PBBSuucp.EXE The main executing program
  144.           PUSETUP .EXE The full screen setup program
  145.           PUEXPORT.EXE The Fido(*.MSG) exporter for PBBSuucp ONLY
  146.           PBBSuucp.DOC The documentation file
  147.           LICENSE .REG The license file of this program
  148.           WHATS   .NEW Info on the new addition to this program
  149.  
  150.                              ─────[ Auto Created ]─────
  151.           PBBSuucp.CFG configuration file required by PBBSuucp
  152.  
  153.           ┌──────────────────────────────────────────────────────────────────┐
  154.           │▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 3 ▓▓│
  155.           └──────────────────────────────────────────────────────────────────┘
  156.  
  157.           PBBSuucp refers to all executables and text files contained in the
  158.           PBBSuucp archives released by Bing Wu (author) of Panda BBS!
  159.  
  160.           1. PBBSuucp is the copyrighted material of Bing Wu. It may only be
  161.           used in accordance with the Licensing Conditions.
  162.  
  163.           2. The Products are provided AS IS. Neither the author nor any BBS
  164.           operator distributing this software is responsible for any damage
  165.           incurred during the operation of the program.
  166.  
  167.           3. The Author (Bing Wu) can discountinue support and development of
  168.           PBBSuucp without notice and at anytime after the initial license
  169.           agree period (ONE YEAR and TWO MONTHS after the FIRST release of
  170.           this program).
  171.  
  172.           4. You may not modify or otherwise reverse─engineer PBBSuucp.
  173.  
  174.           5. You may not use PBBSuucp in any unlawful and/or illegal manner.
  175.  
  176.           6. A Registered Version of PBBSuucp MAY/MUST not be distributed
  177.           with or without Author's Permission.
  178.  
  179.           7. This program must be registered after 21 days of trail period.
  180.           read REGISTRA.REG for more information! (commercial users MUST
  181.           register before using it!)
  182.  
  183.           ┌──────────────────────────────────────────────────────────────────┐
  184.           │▓▓ Installation ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 04 ▓▓│
  185.           └──────────────────────────────────────────────────────────────────┘
  186.           The Setup program for this program is easy to use and understand. It's
  187.           a full screen program, so no EXTERNAL text editor is required.
  188.  
  189.           This version of PBBSuucp takes advantage of the environment variable,
  190.           it will function much smoother with the SET environment but it's not
  191.           required. It is simply used to make PBBSuucp and its utilitis to be
  192.           able to locate the correct data files. In case neither the SET
  193.           environment is set nor a directory is specified with command
  194.           line parameter, current directory where the program is loaded will
  195.           be used.
  196.  
  197.           Make sure that you also have the directory where the programs are
  198.           located included in the PATH parameter. So the all programs can
  199.           be located.
  200.  
  201.           To use the PBBSuucp evironment variable, simply add following line
  202.           to your autoexec.bat or the batch file you call the RA or the
  203.           PBBSuucp
  204.  
  205.           SET PBBSU=[Directory]
  206.  
  207.           Run this program after every toss/scan of mails by your mailer or run
  208.           it once a day in the daily maintenance. All in All, it's upto you
  209.           to decide!
  210.  
  211.  
  212.           ┌──────────────────────────────────────────────────────────────────┐
  213.           │▓▓ ■■ CONFIGURATION - PUSetup.EXE ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 5 ▓▓│
  214.           └──────────────────────────────────────────────────────────────────┘
  215.           PUSETUP is the full screen setup utility for PBBSuucp. Since you have
  216.           already have a BBS or something like that running, I assume you have
  217.           basic knowledge on how the full screen, selectable menu works.
  218.           Therefore no explanation how to use it will be given in this
  219.           manual. ONLY description of each choice is listed below.
  220.  
  221.           -= The File Menu =-
  222.  
  223.           There is nothing needs to be modified in this menu. Here is some
  224.           information regarding about PBBSuucp.
  225.  
  226.           Info
  227.           ────────────────────────────────────────────────────────────────
  228.           Here is little information about PBBSuucp
  229.  
  230.           Credits
  231.           ────────────────────────────────────────────────────────────────
  232.           The Credits given by the author
  233.  
  234.           Exit
  235.           ────────────────────────────────────────────────────────────────
  236.           Choose this option when you wish to exit the setup program. press
  237.           [ESC] will also allow you to exit the program.
  238.  
  239.  
  240.           -=THE SYSTEM MENU =-
  241.           ┌──────────────────────────────────────────────────────────────────┐
  242.           │▓▓ Paths Define ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  243.           └──────────────────────────────────────────────────────────────────┘
  244.            The paths shown on your screen are those which you have specified
  245.            during the system configuration. Those paths specify where all
  246.            PBBSuucp and its related files are located. PUSetup will not check
  247.            for existence of a path, so make sure you have entered a valid path.
  248.  
  249.           Inbound Directory
  250.           ───────────────────────────────────────────────────────────────────
  251.           This Path defines where the incoming files are stored by your mailer.
  252.  
  253.           OutBound Directory
  254.           ───────────────────────────────────────────────────────────────────
  255.           This path defines where the outgoing mail packets are stored by your
  256.           tosser.
  257.  
  258.           Log File
  259.           ───────────────────────────────────────────────────────────────────
  260.           This field specifies the full path and name of the PBBSuucp log file.
  261.           The full path is optional. If no path was specified, PBBSuucp
  262.           directory will be used.
  263.  
  264.           ┌──────────────────────────────────────────────────────────────────┐
  265.           │▓▓ Site Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 6 ▓▓│
  266.           └──────────────────────────────────────────────────────────────────┘
  267.           This is where you define various information about your system such
  268.           as system name, sysop's name, and system's phone number.
  269.  
  270.  
  271.           System Name
  272.           ───────────────────────────────────────────────────────────────────
  273.           What is the name of your system (BBS). Used by PBBSuucp to determine
  274.           the registration info of the program.
  275.  
  276.  
  277.           System Operator's Name
  278.           ───────────────────────────────────────────────────────────────────
  279.           What is the name of the Sysop. The Name must match the one specified
  280.           in the key file inorder to have the program function as a registered
  281.           program.
  282.  
  283.           System Address
  284.           ───────────────────────────────────────────────────────────────────
  285.           Your FidoNet Style (4D supported, ZONE:NET/NODE.POINT) address which
  286.           you used to send mails to your UUCP (Fido(msg)<->InterNet) gatewat.
  287.  
  288.           UUCP Address
  289.           ───────────────────────────────────────────────────────────────────
  290.           The FidoNet Style (4D supported, ZONE:NET/NODE.POINT) address which
  291.           is the UUCP gateway (where the send Internet mails to be gated).
  292.  
  293.           FROM Field
  294.           ───────────────────────────────────────────────────────────────────
  295.           This is where you indicate how should PBBSuucp handle the FROM field
  296.           of the netmail(s) to be created. You can either have the PBBSuucp
  297.           use the FROM field from the original message or from the information
  298.           contained in the setup.
  299.  
  300.           Max Message Bytes (default 16000bytes)
  301.           ───────────────────────────────────────────────────────────────────
  302.           The Max Bytes limit for a message (round to thousand)
  303.  
  304.           Max Message Lines (default 10000)
  305.           ───────────────────────────────────────────────────────────────────
  306.           The Max number of lines a message can handle
  307.  
  308.           Max File size (default 15360 bytes)
  309.           ───────────────────────────────────────────────────────────────────
  310.           The Max file size of each segment of the encoded file which was
  311.           split up.
  312.  
  313.           ┌──────────────────────────────────────────────────────────────────┐
  314.           │▓▓ Command Line Paramters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 07 ▓▓│
  315.           └──────────────────────────────────────────────────────────────────┘
  316.  
  317.           -INB or /INB             Process Incoming Netmails
  318.           -OUT or /OUT             scan for outbound E-Mails
  319.  
  320.           ┌──────────────────────────────────────────────────────────────────┐
  321.           │▓▓ Batch File Examples ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  322.           └──────────────────────────────────────────────────────────────────┘
  323.  
  324.           ;--- Tossing ---
  325.           SET PBBSU=[PathName]
  326.  
  327.           :OUTBOUND
  328.           FASTECHO SCAN
  329.           PBBSuucp /OUT
  330.           goto exit
  331.  
  332.           :INBOUND
  333.           FASTECHO TOSS
  334.           PBBSuucp /INB
  335.           goto exit
  336.  
  337.           ┌──────────────────────────────────────────────────────────────────┐          d:
  338.           │▓▓ ErrorLevels ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  339.           └──────────────────────────────────────────────────────────────────┘
  340.           PBBSuucp will exit with one of the following errorlevels:
  341.                   0 ─ No Error
  342.                   1 ─ Mail found and converted
  343.                   4 ─ No Configuration file found
  344.  
  345.           ┌──────────────────────────────────────────────────────────────────┐
  346.           │▓▓ Contact Author ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 08 ▓▓│
  347.           └──────────────────────────────────────────────────────────────────┘
  348.           Bing Wu (author) can be reached via:
  349.           Snail Mail:
  350.           Bing Wu
  351.           604 Ontario Street SE
  352.           Minneapolis, MN 55414─3118
  353.  
  354.           Telephone/Fax:
  355.           (612)378─0885
  356.  
  357.           BBS:
  358.           Panda BBS! @ (612)378─7783 @ 28,800 VFC
  359.  
  360.           NetMail:
  361.           wuxx0037@gold.tc.umn.edu of InterNet
  362.           bing wu@1:282/1016       of FidoNet
  363.           bing wu@74:74/0          of SISNet
  364.           bing wu@16:612/28        of SIMNet
  365.  
  366.           ┌──────────────────────────────────────────────────────────────────┐
  367.           │▓▓ Other Programs ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  368.           └──────────────────────────────────────────────────────────────────┘
  369.           Online Programs
  370.           ────────────────
  371.           BBSTROOP ──Ver 1.30── Online Scouting Troop Listing     ($15 reg.)
  372.           BBSMBCON ──Ver 1.20── Online Scouting MB Counselor list ($15 reg.)
  373.           PBBSVOTE ──Ver 1.10── Online BBS Voting Door            ($10 reg.)
  374.           PBBSLIST ──Ver 1.60── Online BBS Listing Door           ($15 reg.)
  375.  
  376.           Utilities
  377.           ─────────
  378.    *THIS* PBBSUUCP ──Ver 1.00── Easy UUCP (Internet) E-Mail Handler ($09 reg.)
  379.           VIAINTER ──Ver 1.00── Fido mail pack<->Internet Router  ($15 reg.)
  380.           PBBSFreq ─Ver 1.00ß1─  FTSC file requester for Internet requests ($15)
  381.           CFDATE   ──Ver 1.00── Comp two files' date, find which one is newer
  382.           CDATE    ──Ver 1.00── Change the date/time of file(s)  (FREEWARE)
  383.           RA2FDUSR ──Ver 1.00── RA to FD Human caller counter updater (FREEWARE)
  384.  
  385.           ┌──────────────────────────────────────────────────────────────────┐
  386.           │▓▓ Beta Tester Needed ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  387.           └──────────────────────────────────────────────────────────────────┘
  388.           The author is currently seeking beta testers to test his programs,
  389.           including all Door programs listed above and all upcoming programs.
  390.           If you are intereted in becoming a beta tester, fill out the
  391.           application BETATEST.APP and specify the name of the program you wish
  392.           to test or indicate you wish to test all programs.
  393.           (Pre-registration of the program MAY be required)
  394.