home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WILDCAT / WCTRAF11.ZIP / WCTRAF10.DOC < prev    next >
Text File  |  1994-03-14  |  18KB  |  415 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                         ******************************
  11.  
  12.                                wcTraffic v1.00
  13.  
  14.                                03/14/94 Release
  15.  
  16.                         ******************************
  17.  
  18.                              (c)1994 Jay Freeman
  19.                             Integrad Services, Inc.
  20.                               All rights reserved
  21.  
  22.  
  23.                         Support BBS:  NW E-Mail Express
  24.  
  25.                                 (503) 626-3551
  26.  
  27.                   3 Nodes, 14.4K USRobotics modems on all lines
  28.  
  29.  
  30.  
  31.  
  32.         LEGALITIES:
  33.         ===========
  34.         THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  35.         WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  36.         LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  37.         FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  38.         THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  39.         SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  40.         OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY DISTRIBUTION OF
  41.         THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE VERSIONS
  42.         OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  43.         A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  44.  
  45.         SHAREWARE NOTICE:
  46.         =================
  47.         This Program is Shareware. This means that if you find it useful you
  48.         MUST register it if you are going to continue using it.
  49.  
  50.         You may try it for 30 days to determine whether it is a program that
  51.         you consider helpful and worth paying for.  After 30 days you must
  52.         either send the registration fee or delete it from your hard drive.
  53.  
  54.         You may (in fact you are encouraged to) distribute this software by 
  55.         uploading it to any BBS that you call, or pass it along to a friend.
  56.  
  57.         You may NOT charge anything for this utility and you may not include
  58.         it as part of any software that you are selling.  
  59.  
  60.         If you like the Program and continue using it then you MUST send me
  61.         $15.00 to encourage me to continue writing Wildcat! Utilities, and to
  62.         help convince my boss that I am not wasting his time <grin>.  Also,
  63.         I am interested in any comments/suggestions/observations you may
  64.         have regarding wcTraffic.  
  65.  
  66.         Registered users receive free minor ('point') updates with all the
  67.         latest features, and all the nag screens turned off.  They also
  68.         will be able to sleep at night, and not worry about having
  69.         unregistered software on their systems!  Please see the file
  70.         REGISTER.FRM for more information, and the specifics on the free
  71.         updates.
  72.  
  73.  
  74.         What is wcTraffic?
  75.         --------------------------------------------------------------------
  76.         wcTraffic, or WCT from here on, is a log file utility / screen maker
  77.         for Wildcat Sysops who use the wcUUCP (TM) Internet e-mail gateway
  78.         from Mustang Software, Inc.
  79.  
  80.  
  81.         Features of WCT v1.00
  82.         --------------------------------------------------------------------
  83.         WCT scans your WCUUCP.LOG (created by WCUUCP).  From this log
  84.         file it will do the following:
  85.  
  86.         - Create a 'Last 12 Mail Runs' HELLO/BULL screen w/Wildcat @ codes.
  87.  
  88.         - Finds all ERRORS logged by wcUUCP and writes them to a separate 
  89.           text file.
  90.  
  91.         - Allow you to modify different colors of the Hello/Bull screen (R)
  92.  
  93.         - Allow you to enter a custom text line into the Hello/Bull screen (R)
  94.  
  95.         (R) = Registered Version
  96.  
  97.         Other notable features:
  98.  
  99.         - Keeps track of the last time / date in the WCUUCP.LOG file for 
  100.           error scan.  Only scans for new errors since it was last run.
  101.           
  102.         - You may setup a WCTERR.BAT file and call it from your UUCP.BAT to
  103.           automatically send yourself a message containing any new errors
  104.           since the last run.
  105.           
  106.         - Fast Operation!  It takes less than 5 seconds to run on a 500K log
  107.           file on my test machine (486DX/33).
  108.  
  109.         - Tested under Multi-Node conditions - DesqView & Novell Netware
  110.  
  111.         - Easy text file based configuration
  112.  
  113.         - Does not expire!  Uses a KEY file for registered versions.
  114.  
  115.         - Easy to register!  Just call our BBS and register On-line through
  116.           our registration door.
  117.  
  118.         - E-Mail based updates.  The latest versions will be sent to 
  119.           registered users via private Internet e-mail as an attachment, 
  120.           if you wish.
  121.  
  122.  
  123.         Do you need WCT?
  124.         --------------------------------------------------------------------
  125.         Well that depends.  First, you must have WCUUCP from Mustang Software,
  126.         or WCT will not do you one bit of good!  
  127.  
  128.         I originally wrote WCT for 2 reasons:
  129.  
  130.         1- My callers were always asking, 'What time do the messages go out
  131.            again?', and 'How many messages come in and out of this system'.
  132.            WCT answers these questions, and also shows them that our E-mail
  133.            gateway is REALLY working.  I made it a HELLO screen, and have
  134.            gotten numerous new subscriptions from callers who see what they
  135.            are 'missing out on'.  It also helps me see if I am having any
  136.            problems with my UUCP host by displaying the activity each time
  137.            I login.
  138.  
  139.         2- wcUUCP (TM) does a great job of tracking any errors that
  140.            may occur during the toss.  The problem is, I don't have the time
  141.            to read every line of the WCUUCP.LOG file to find these errors!
  142.            WCT pulls these errors out of the log, and puts them in a Sysop
  143.            configurable file.  It also keeps track of the last mail run
  144.            it processed, and will only look for 'new' errors since.  I
  145.            have setup (and include it as an example) a WCTERR.BAT file,
  146.            which will automatically send you a message (via POSTMASTER) if
  147.            a new error shows up.
  148.  
  149.  
  150.         If these features interest you, read on.
  151.  
  152.         Files included in the archive
  153.         --------------------------------------------------------------------
  154.         REGISTER.FRM            Registration form.
  155.         WCTRAF10.EXE            Main program executable
  156.         WCTRAF10.CFG            Sample configuration file.  You must edit
  157.                                 this and add your own values!
  158.         WCTRAF10.KEY            Dummy demo key, but required for operation.
  159.                                 Replace this with your registered key file
  160.                                 when you register!
  161.         WCTRAF10.DOC            This file!
  162.         README!.1ST             Late-breaking information
  163.         DESC.SDI                Desc For upload processors
  164.         FILE_ID.DIZ             Desc For upload processors
  165.         HELLO2.BBS              A sample registered output screen from WCT
  166.         WCTERR.BAT              A sample batch file to have POSTMASTER
  167.                                 send you the ERROR file created by WCT
  168.         UUCP.BAT                A sample of my UUCP.BAT file
  169.         
  170.  
  171.  
  172.         One more note before Installation
  173.         ---------------------------------------------------------------------
  174.         WCT ships with a 'DUMMY' KEY file called WCTRAF10.KEY.  DO NOT DELETE
  175.         THIS FILE! It is simply a 'placeholder' until you register and replace
  176.         it with your own WCTRAF10.KEY.
  177.  
  178.         WCT does not expire.  You are, however, expected to register it within
  179.         30 days if you find it usefull.  With registration, WCT behaves 
  180.         differently in the following ways:
  181.  
  182.           - Removal of 'UNREGISTERED' in BBS screen
  183.           - Removal of 'For info about wcTraffic....' in BBS screen
  184.           - Your Name & BBS Name in the BBS screen
  185.           - Custom @-Color codes to make the BBS screen fit your 'look' 
  186.           - Custom dedication or text line in the BBS screen
  187.           - Removal of 10 second startup delay
  188.  
  189.         See the REGISTER.FRM for more details on registration.
  190.  
  191.         See the file HELLO2.BBS included in this archive as an example of
  192.         a Registered screen created by WCT.
  193.  
  194.         Setup Instructions
  195.         ---------------------------------------------------------------------
  196.         Setup is very simple (Honest!)
  197.  
  198.         1. Unzip the WCTRAF10.ZIP file into your favorite directory.
  199.            It doesn't matter where they go, and you could put them
  200.            in your WC30 directory if you wish.  I have mine in:
  201.  
  202.                 F:\WC30\WCT10
  203.  
  204.         Replace the 'F' with your drive letter, of course.
  205.  
  206.         2. Edit the WCTRAF10.CFG file with an ASCII text editor.  The
  207.            following is an example of my WCTRAF10.CFG file:
  208.  
  209. + START WCTRAF10.CFG FILE------------------------------------
  210.  
  211. Become a member of our BBS and get on the Internet!
  212. F:\WC30\WCUUCP\WCUUCP.LOG
  213. F:\WC30\DISP\HELLO2.BBS
  214. F:\WC30\WCTRAF10.ERR
  215. 05
  216. 0E
  217. 8C
  218. 0B
  219. 0A
  220. 0F
  221.  
  222. *****************Legend for above***********************
  223. Line  1 = Custom Message (REG Version Only)
  224. Line  2 = Name/path for location of WCUUCP.LOG 
  225. Line  3 = Name/path for output of WildCat Screen/bulletin file  N = Don't Use
  226. Line  4 = Name/path for output of Error Text File               N = Don't Use
  227. Line  5 = Color of lines      Format = Background/Foreground    (REG Version)
  228. Line  6 = Color of BBS name                                     (REG Version)
  229. Line  7 = Color of Custom Message                               (REG Version)
  230. Line  8 = Color of Title line                                   (REG Version)
  231. Line  9 = Color of first line of wcTraffic BBS screen           (REG Version)
  232. Line 10 = Color of Alternate line of wcTraffic BBS screen       (REG Version)
  233.  
  234. +END WCTRAF10.CFG FILE----------------------------------
  235.  
  236.         Some notes on the above:
  237.  
  238.         Line 1 - [Registered Feature] - Message/Dedication line
  239.         -----------------------------
  240.         Enter a simple one line message that you wish to be included
  241.         on the BBS screen.  I use this to inform my 'non-subscribers'
  242.         of what they are missing out on.  You can also use this as a
  243.         dedication line if you wish.
  244.         Note: This line must be present, even if not registered. WCT
  245.         will ignore it in the non-registered mode, but it needs to
  246.         be there as a 'place holder'.
  247.  
  248.         Line 2 - Path to WCUUCP.LOG
  249.         -----------------------------
  250.         Enter your full path & name of your WCUUCP.LOG.  In 99% of
  251.         the cases, all you will need to change is the drive letter.
  252.  
  253.         Line 3 - HELLO / BULL Screen name
  254.         -----------------------------
  255.         This can be either a HELLOx.BBS or BULLx.BBS or whatever
  256.         else you may want it.  Whichever you use, make sure you
  257.         enter the proper path.  Normally, bulletins are in the:
  258.  
  259.                WC30\BULL
  260.  
  261.         and Hello screens are in the:
  262.  
  263.                WC30\DISP
  264.  
  265.         directories.
  266.  
  267.         *If you do not wish to make a BBS screen, enter an 'N'
  268.          (no quotes) on this line.
  269.  
  270.         Line 4 - Error file name
  271.         -----------------------------
  272.         Enter the full drive/path/file name that you want WCT to
  273.         use as your ERROR file.
  274.  
  275.         *If you do not wish to have WCT look for Errors, enter
  276.         an 'N' (no quotes) on this line.
  277.  
  278.         Lines 5 - 10 [Registered Feature]
  279.         -----------------------------
  280.         These are the Wildcat @ Color codes you wish to use.  See
  281.         the legend above or in the WCTRAF10.CFG file for the
  282.         specifics on which parts of the BBS screens they pertain
  283.         to.  Only put the 2-digit code - I supply the @'s <g>. See
  284.         your Sysop guide or the WCTRAF10.CFG file for an explanation
  285.         of the @ Color codes.
  286.  
  287.         Special note on lines 9 & 10: These are the 'detail' lines
  288.         for each mail run.  I prefer to alternate colors here to
  289.         make it more readable and give it a 'green bar' effect.  If
  290.         you do not want alternating colors, make both lines the same.
  291.  
  292.  
  293.         3. Finally, edit your UUCP.BAT file to include a call to
  294.            WCTRAF10.EXE on the last line.  This way everything is
  295.            updated each time you make a UUCP run.  My UUCP.BAT file
  296.            looks like this:
  297.  
  298.         +START UUCP.BAT FILE---------------------------------------
  299.  
  300.         CD\WC30
  301.         WCUUCP /E
  302.         CD\WC30\WCUUCP
  303.  
  304.         :REDIAL
  305.         UUCICO -SNETCOMSV -A -W
  306.         IF ERRORLEVEL 6 IF NOT ERRORLEVEL 9 GOTO REDIAL
  307.         CD\WC30
  308.         WCUUCP /I
  309.  
  310.         CD\WC30\WCT10             <========= Add
  311.         WCTRAF10                  <========= These
  312.         CD\WC30                   <========= Lines
  313.         CALL F:\WC30\WCTERR.BAT   <========= Add this one if you want
  314.                                              your ERROR file sent to you
  315.                                              via POSTMASTER.
  316.  
  317.         +END UUCP.BAT FILE------------------------------------------
  318.  
  319.         Important notes on the above
  320.         -----------------------------------------------------------
  321.         You should make sure WCT and WCUUCP are not both running at
  322.         the same time.  WCT needs to read the WCUUCP.LOG file, and
  323.         will get very confused if WCUUCP has it open and is updating
  324.         it.  Run WCT from your UUCP.BAT file, and this will never happen.
  325.  
  326.         If you wish to have WCT re-process your entire log file again,
  327.         simply delete the file WCTRAF10.LRD.  This file stores the
  328.         last run date & time.  Run WCT again and your entire log
  329.         will be processed.
  330.  
  331.         Multi-Node Systems (Technical Info)
  332.         ------------------------------------------------------------
  333.         WCT has been tested on several Multi-Node systems, including
  334.         on Novell Netware 3.11, & DesqView (DesqView node is also on a 
  335.         3.11 network).  WCT creates a file in your output screen directory
  336.         called WCTRAF10.TMP.  This is the work file where the screen is
  337.         built.  After it is built, WCT attempts to copy the temp file 
  338.         (using its own copy routine) to the BBS screen name.  If the BBS
  339.         file is in use (ie, someone is viewing it in Wildcat), WCT will
  340.         delay for 5 seconds, and then retry the copy procedure.  WCT will
  341.         continue this retry 'loop' until either the file is released, or
  342.         it's retry counter reaches 50.  
  343.  
  344.         How to reach us
  345.         ------------------------------------------------------------
  346.  
  347.         BBS:
  348.         You can get the latest copy of wcTraffic by calling our
  349.         support BBS, NW E-Mail Express.  The number is:
  350.  
  351.                              (503) 626-3551
  352.  
  353.         There are currently 3-lines, all using USR Sportster 14.4K
  354.         modems.  You have access to the wcTraffic areas on your first call.
  355.  
  356.         Internet - I can be reached at the following address:
  357.  
  358.                             jfreeman@hub.com
  359.  
  360.         I also frequent the UseNet newsgroup: alt.bbs.wildcat
  361.  
  362.         I can also be reached via Mustang Software's HQ BBS in the
  363.         Third Party Utilities conference.
  364.  
  365.         On all of the above, I will try to the best of my ability
  366.         to help you solve any problems you may encounter with WCT.
  367.  
  368.         Also, feel free to drop me a message to let me know how you
  369.         like WCT, and suggest any enhancements / new features.
  370.  
  371.         If you wish, I can e-mail registered users the latest copies of 
  372.         WCT as an attachment.
  373.  
  374.         If you have a LOG file that WCT will not seem to process, please
  375.         feel free to either upload it (along with your CFG file) to my
  376.         BBS, or send it as an attachment to a private Internet E-mail
  377.         message (addressed to jfreeman@hub.com).  
  378.  
  379.         Future Enhancements
  380.         ------------------------------------------------------------
  381.         We are looking into the adding the following features to future
  382.         versions of wcTraffic:
  383.         
  384.          - UUCICO Log file processing - Calculate estimated long distance
  385.            charges based on connect time. (For both UUPlus UUCICO, and
  386.            FX-UUCICO).
  387.          - WCUUCP.LOG/LOGFILE/UUCICO trimmer / archiver
  388.          - Pull Attachments & Bounced Message information and write to a
  389.            separate log file.
  390.          - Support for WildUUCP from Online Computer Resources.
  391.  
  392.         Registration
  393.         -------------------------------------------------------------
  394.         Registration is $15 U.S. Funds.  Please see REGISTER.FRM for more
  395.         information.  Visa / Mastercard are accepted, and you can register
  396.         by credit card by calling our BBS and entering [O]nline registration
  397.         from the Main Menu.  Personal checks are also accepted, but please
  398.         allow time for it to clear before your KEY file is made.
  399.  
  400.         Trademarks / Copyrights
  401.         -------------------------------------------------------------
  402.  
  403.         + wcTraffic is Copyright (c) 1994, Integrad Services, Inc.
  404.  
  405.         + Wildcat! & wcUUCP are registered trademarks & Copyrighted by
  406.           Mustang Software, Inc., makers of the best BBS software on the
  407.           Planet!
  408.  
  409.         + POSTMASTER is Copyright Dave Cody, BoardWalk Software.
  410.  
  411.         + WildUUCP is Copyright Online Computer Resources, Inc.
  412.  
  413.         All other trademarks & copyrights are registered to their respective
  414.         owners.
  415.