home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PBU_113.ZIP / PBBSUUCP.DOC < prev    next >
Text File  |  1995-02-04  |  20KB  |  398 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.13
  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.         Feb   4, 1995  (C) 1994, 95 by Bing Wu & International Meridian Co.
  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.           REGISTRA.REG The Registration for and info for Panda Soft
  148.           TABSREG .INF How-to Use TABS's 900 service to register program
  149.           WHATS   .NEW Info on the new addition to this program
  150.  
  151.                              ─────[ Auto Created ]─────
  152.           PBBSuucp.CFG configuration file required by PBBSuucp
  153.  
  154.           ┌──────────────────────────────────────────────────────────────────┐
  155.           │▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 3 ▓▓│
  156.           └──────────────────────────────────────────────────────────────────┘
  157.  
  158.           PBBSuucp refers to all executables and text files contained in the
  159.           PBBSuucp archives released by Bing Wu (author) of Panda BBS!
  160.  
  161.           1. PBBSuucp is the copyrighted material of Bing Wu. It may only be
  162.           used in accordance with the Licensing Conditions.
  163.  
  164.           2. The Products are provided AS IS. Neither the author nor any BBS
  165.           operator distributing this software is responsible for any damage
  166.           incurred during the operation of the program.
  167.  
  168.           3. The Author (Bing Wu) can discountinue support and development of
  169.           PBBSuucp without notice and at anytime after the initial license
  170.           agree period (ONE YEAR and TWO MONTHS after the FIRST release of
  171.           this program).
  172.  
  173.           4. You may not modify or otherwise reverse─engineer PBBSuucp.
  174.  
  175.           5. You may not use PBBSuucp in any unlawful and/or illegal manner.
  176.  
  177.           6. A Registered Version of PBBSuucp MAY/MUST not be distributed
  178.           with or without Author's Permission.
  179.  
  180.           7. This program must be registered after 21 days of trail period.
  181.           read REGISTRA.REG for more information! (commercial users MUST
  182.           register before using it!)
  183.  
  184.           ┌──────────────────────────────────────────────────────────────────┐
  185.           │▓▓ Installation ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 04 ▓▓│
  186.           └──────────────────────────────────────────────────────────────────┘
  187.           The Setup program for this program is easy to use and understand. It's
  188.           a full screen program, so no EXTERNAL text editor is required.
  189.  
  190.           This version of PBBSuucp takes advantage of the environment variable,
  191.           it will function much smoother with the SET environment but it's not
  192.           required. It is simply used to make PBBSuucp and its utilitis to be
  193.           able to locate the correct data files. In case neither the SET
  194.           environment is set nor a directory is specified with command
  195.           line parameter, current directory where the program is loaded will
  196.           be used.
  197.  
  198.           Make sure that you also have the directory where the programs are
  199.           located included in the PATH parameter. So the all programs can
  200.           be located.
  201.  
  202.           To use the PBBSuucp evironment variable, simply add following line
  203.           to your autoexec.bat or the batch file you call the RA or the
  204.           PBBSuucp
  205.  
  206.           SET PBBSU=[Directory]
  207.  
  208.           Run this program after every toss/scan of mails by your mailer or run
  209.           it once a day in the daily maintenance. All in All, it's upto you
  210.           to decide!
  211.  
  212.  
  213.           ┌──────────────────────────────────────────────────────────────────┐
  214.           │▓▓ ■■ CONFIGURATION - PUSetup.EXE ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 5 ▓▓│
  215.           └──────────────────────────────────────────────────────────────────┘
  216.           PUSETUP is the full screen setup utility for PBBSuucp. Since you have
  217.           already have a BBS or something like that running, I assume you have
  218.           basic knowledge on how the full screen, selectable menu works.
  219.           Therefore no explanation how to use it will be given in this
  220.           manual. ONLY description of each choice is listed below.
  221.  
  222.           -= The File Menu =-
  223.  
  224.           There is nothing needs to be modified in this menu. Here is some
  225.           information regarding about PBBSuucp.
  226.  
  227.           Info
  228.           ────────────────────────────────────────────────────────────────
  229.           Here is little information about PBBSuucp
  230.  
  231.           Credits
  232.           ────────────────────────────────────────────────────────────────
  233.           The Credits given by the author
  234.  
  235.           Exit
  236.           ────────────────────────────────────────────────────────────────
  237.           Choose this option when you wish to exit the setup program. press
  238.           [ESC] will also allow you to exit the program.
  239.  
  240.  
  241.           -=THE SYSTEM MENU =-
  242.           ┌──────────────────────────────────────────────────────────────────┐
  243.           │▓▓ Paths Define ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  244.           └──────────────────────────────────────────────────────────────────┘
  245.            The paths shown on your screen are those which you have specified
  246.            during the system configuration. Those paths specify where all
  247.            PBBSuucp and its related files are located. PUSetup will not check
  248.            for existence of a path, so make sure you have entered a valid path.
  249.  
  250.           Inbound Directory
  251.           ───────────────────────────────────────────────────────────────────
  252.           This Path defines where the incoming files are stored by your mailer.
  253.  
  254.           OutBound Directory
  255.           ───────────────────────────────────────────────────────────────────
  256.           This path defines where the outgoing mail packets are stored by your
  257.           tosser.
  258.  
  259.           Log File
  260.           ───────────────────────────────────────────────────────────────────
  261.           This field specifies the full path and name of the PBBSuucp log file.
  262.           The full path is optional. If no path was specified, PBBSuucp
  263.           directory will be used.
  264.  
  265.           ┌──────────────────────────────────────────────────────────────────┐
  266.           │▓▓ Site Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 6 ▓▓│
  267.           └──────────────────────────────────────────────────────────────────┘
  268.           This is where you define various information about your system such
  269.           as system name, sysop's name, and system's phone number.
  270.  
  271.  
  272.           System Name
  273.           ───────────────────────────────────────────────────────────────────
  274.           What is the name of your system (BBS). Used by PBBSuucp to determine
  275.           the registration info of the program.
  276.  
  277.  
  278.           System Operator's Name
  279.           ───────────────────────────────────────────────────────────────────
  280.           What is the name of the Sysop. The Name must match the one specified
  281.           in the key file inorder to have the program function as a registered
  282.           program.
  283.  
  284.           System Address
  285.           ───────────────────────────────────────────────────────────────────
  286.           Your FidoNet Style (4D supported, ZONE:NET/NODE.POINT) address which
  287.           you used to send mails to your UUCP (Fido(msg)<->InterNet) gatewat.
  288.  
  289.           UUCP Address
  290.           ───────────────────────────────────────────────────────────────────
  291.           The FidoNet Style (4D supported, ZONE:NET/NODE.POINT) address which
  292.           is the UUCP gateway (where the send Internet mails to be gated).
  293.  
  294.           FROM Field
  295.           ───────────────────────────────────────────────────────────────────
  296.           This is where you indicate how should PBBSuucp handle the FROM field
  297.           of the netmail(s) to be created. You can either have the PBBSuucp
  298.           use the FROM field from the original message or from the information
  299.           contained in the setup.
  300.  
  301.           Max Message Bytes (default 16000bytes)
  302.           ───────────────────────────────────────────────────────────────────
  303.           The Max Bytes limit for a message (round to thousand)
  304.  
  305.           Max Message Lines (default 10000)
  306.           ───────────────────────────────────────────────────────────────────
  307.           The Max number of lines a message can handle
  308.  
  309.           Max File size (default 15360 bytes)
  310.           ───────────────────────────────────────────────────────────────────
  311.           The Max file size of each segment of the encoded file which was
  312.           split up.
  313.  
  314.           ┌──────────────────────────────────────────────────────────────────┐
  315.           │▓▓ Command Line Paramters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 07 ▓▓│
  316.           └──────────────────────────────────────────────────────────────────┘
  317.  
  318.           INB [Option]        Process Incoming Netmails
  319.           OUT [Option/s]      scan for outbound E-Mails
  320.  
  321.           [Option]
  322.           -= OUT mode Only =-
  323.           /LOWER or -LOWER    Output the "TO" string in lower case letters
  324.  
  325.           -= OUT and INB mode =-
  326.           /DEBUG              Run the program in debug mode - log most of the
  327.                               program's run time info to file
  328.  
  329.           ┌──────────────────────────────────────────────────────────────────┐
  330.           │▓▓ Batch File Examples ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  331.           └──────────────────────────────────────────────────────────────────┘
  332.  
  333.           ;--- Tossing ---
  334.           SET PBBSU=[PathName]
  335.  
  336.           :OUTBOUND
  337.           FASTECHO SCAN
  338.           PBBSuucp OUT
  339.           goto exit
  340.  
  341.           :INBOUND
  342.           FASTECHO TOSS
  343.           PBBSuucp INB
  344.           goto exit
  345.  
  346.           ┌──────────────────────────────────────────────────────────────────┐          d:
  347.           │▓▓ ErrorLevels ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  348.           └──────────────────────────────────────────────────────────────────┘
  349.           PBBSuucp will exit with one of the following errorlevels:
  350.                   0 ─ No Error
  351.                   1 ─ Mail found and converted
  352.                   4 ─ No Configuration file found
  353.  
  354.           ┌──────────────────────────────────────────────────────────────────┐
  355.           │▓▓ Contact Author ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 08 ▓▓│
  356.           └──────────────────────────────────────────────────────────────────┘
  357.           Snail Mail:
  358.           International Merdian Co.
  359.           604 Ontario Street SE
  360.           Minneapolis, MN 55414─3118
  361.  
  362.           Voice: (612) 378-0885
  363.  
  364.           BBS:
  365.           Panda BBS! @ (612)378─7783 @ 28,800 V34
  366.  
  367.           NetMail:
  368.           wuxx0037@gold.tc.umn.edu of InterNet
  369.           bing wu@1:282/1027.1   of FidoNet
  370.  
  371.           ┌──────────────────────────────────────────────────────────────────┐
  372.           │▓▓ Other Programs ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  373.           └──────────────────────────────────────────────────────────────────┘
  374.           Online Programs
  375.           ────────────────
  376.           BBSTROOP ──Ver 1.30── Online Scouting Troop Listing     ($10 reg.)
  377.           BBSMBCON ──Ver 1.20── Online Scouting MB Counselor list ($10 reg.)
  378.           PBBSVOTE ──Ver 2.10── Online BBS Voting Door            ($10 reg.)
  379.           PBBSLIST ──Ver 2.00── Online BBS Listing Door           ($15 reg.)
  380.  
  381.           Utilities
  382.           ─────────
  383.    *THIS* PBBSUUCP ──Ver 1.13── Easy UUCP (Internet) E-Mail Handler ($09 reg.)
  384.           VIAINTER ──Ver 1.00── Fido mail pack<->Internet Router  ($15 reg.)
  385.           PBBSFreq ─Ver 1.00ß1─  FTSC file requester for Internet requests ($15)
  386.           CFDATE   ──Ver 1.00── Comp two files' date, find which one is newer
  387.           CDATE    ──Ver 1.00── Change the date/time of file(s)  (FREEWARE)
  388.           RA2FDUSR ──Ver 1.00── RA to FD Human caller counter updater (FREEWARE)
  389.  
  390.           ┌──────────────────────────────────────────────────────────────────┐
  391.           │▓▓ Beta Tester Needed ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  392.           └──────────────────────────────────────────────────────────────────┘
  393.           International Meridian Company is currently seeking beta testers to
  394.           test its programs, including all Door programs listed above and all
  395.           upcoming programs. If you are intereted in becoming a beta tester,
  396.           fill out the application BETATEST.APP.
  397.           (Pre-registration of the program MAY be required)
  398.