home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / macorg31.zip / ORIGIN.DOC < prev    next >
Windows Setup INFormation  |  1993-01-04  |  17KB  |  407 lines
  1.  
  2.  
  3.                       ╔═══════════════════════════╗
  4.                       ║ A MÄC's Place BBS Release ║
  5.                       ╚═══════════════════════════╝
  6.  
  7.  
  8.  
  9.              FILE ORIGINS: File Download / Upload Searches
  10.              ~~~~ ~~~~~~~  ~~~~ ~~~~~~~~ ~ ~~~~~~ ~~~~~~~~
  11.  
  12.                             Version  3.1
  13.  
  14.  
  15.               Copyright (c) 1989-1993 John W. McNamara
  16.                           All rights Reserved
  17.  
  18.  
  19.                               Written By:        
  20.  
  21.                              John McNamara      
  22.                         
  23.                             MÄC's Place BBS    
  24.                                Dunn, NC           
  25.  
  26.                         (919) 891-1111 [16.8 DS] 
  27.         
  28.                         Release Date: 4 Jan 1993
  29.  
  30.     ORIGINS - Version 3.1                                           Page - 1
  31.  
  32.  
  33.     File Origins - A MÄC's Place BBS Release PCBoard File Search Door
  34.  
  35.  
  36. ┌────────────────────────────────┐
  37. │ Files included in this Zip:    │
  38. └────────────────────────────────┘
  39.  
  40.     ORIGIN.EXE       - Main File Origins Executable File, Version 3.1
  41.     ORIGIN.CNF       - File Origins Sample Configuration File
  42.     ORIGIN           - File Origins Sample PCBoard Door File
  43.     ORIGIN.DOC       - Information on File Origins Door
  44.     ORIGIN.HIS       - Programme Release History
  45.     README.NOW       - Information on Files Available with the
  46.                        File Origins PCBoard Door
  47.     HOT_ADS.TXT      - Information on File Origins support programmes:
  48.             Hot Companion and BudMan.
  49.     BUDMAN30.ZIP     - Download.txt File splitter for PCBoard
  50.     HCOMP40.ZIP      - Download.txt Parser for PCBoard
  51.                ┌───────────────────────────────────────────────────┐
  52.                │ F I L E   O R I G I N S  -  V e r s i o n  3 . 1  │
  53.                └───────────────────────────────────────────────────┘
  54.                           ╔═════════════════════════════╗
  55.                           ║  A MÄC's Place BBS Release  ║
  56.                           ╚═════════════════════════════╝
  57.  
  58.    The File Origins door has two support programmes that are also available
  59.  
  60.  
  61.    HotStuff Companion [Version 4.0]
  62.    ==================
  63.         The HotStuff Companion programme was written because of the need to 
  64.         strip the DOWNLOAD.TXT and CALLER files created  by PCBoard (tm) of 
  65.         old, outdated, or unwanted files. When HotStuff or File Origins are
  66.         run, they may reflect files that are  no longer  on  your  Bulletin 
  67.         Board System.
  68.  
  69.         The programme uses a parsing  routine  [similar  to  the UNIX Grep]
  70.         to search a file line by line for a string and eliminate that  text
  71.         from the file.  The programme is available as: HCOMP40.ZIP.  It  is
  72.         included in this archive. It will now process 3 different strings at
  73.         once.
  74.  
  75.  
  76.    BudMan Utility [Version 3.0]
  77.    ==============
  78.         The BudMan programme does what PCBoard (tm) should already do.  It 
  79.         splits the DOWNLOAD.TXT file into two files, one with the downloads 
  80.         and  the  other  with  uploads.   The  programme  is  available as: 
  81.         BUDMAN30.ZIP.  It is inlcuded with the archive.
  82.  
  83.  
  84.     ORIGINS - Version 3.1                                           Page - 2
  85. ╔══════════════╗
  86. ║ Introduction ║
  87. ╚══════════════╝
  88.  
  89.   Welcome to File  Origins !! File  Origins is a  PCBoard door programme  that
  90.   allows the user to  perform an extremely RAPID  search of file downloads  or
  91.   uploads  on   a BBS  for  a specific key search  string.  The programme  can
  92.   locate  any  key  string  that  is  contained within file download or upload
  93.   files.  The  search string can  be a user  name, file name,  or even a date.
  94.   Some examples would include:
  95.  
  96.        HOTDOG            - any accesses to this file
  97.        MCNAMARA          - any activity by this user
  98.        05-10-1993        - any activity on this date
  99.  
  100.  
  101.  
  102.   It is recommended  that you use  separate download and  upload file listings
  103.   for the programme.   We have included  the BudMan programme  which automates
  104.   the separation  of   the  standard  PCBoard   Download.txt  file  into   two
  105.   files:  a download and upload  file [something that PCBoard should be  doing
  106.   anyway !!].  The  File Origins programme reads  from two files for  the file
  107.   downloads  and uploads.  Of course you could  read from the same  file [eg -
  108.   Download.txt] for both downloads and uploads.
  109.  
  110.   One of the main  features of the File  Origins programme is its  SPEED !! It
  111.   is  written  in  Borland C++ 3.1    with an Assembler string parsing routine
  112.   [similar to the UNIX Grep] to maximize the search speed. It is approximately
  113.   33 percent faster than  Sam Smith's ProWho.   It has the added  feature that
  114.   it only  searches through  either an  Upload file  listing or  Download file
  115.   listing for the search string, which is not counted in the time trial.  
  116.  
  117.  
  118.     ORIGINS Version 3.1                                             Page - 2
  119.  
  120.   The main features of the File Origins programme include:
  121.  
  122.           o  It uses either an Upload file listing or Download file listing 
  123.                to locate the search string. 
  124.           o  It can also only use one file if you don't want to split it
  125.           o  Extreamly fast
  126.       o  Share and Network Compatible allowing it to be run on multiple 
  127.                nodes.
  128.           o  Full comm support up to 115,000 baud
  129.           o  Provides ALL PCBoard Funtion keys and features
  130.  
  131.  
  132.  
  133.     ORIGINS - Version 3.1                                           Page - 3
  134. ╔═══════════════════════════════╗
  135. ║ File Origins Door Operation:  ║
  136. ╚═══════════════════════════════╝
  137.  
  138.   The operation of the File Origins Door is straight forward. The programme  
  139.   presents the welcome screen and then displays the main menu. 
  140.  
  141.                        File ORIGIN/DESTINATION Door
  142. For a 2 file system:
  143.  
  144. [U] Search for files that have been Uploaded
  145. [D] Search for files that have been Downloaded
  146. [H] Help
  147. [Q] Quit to BBS
  148. [G] Log off BBS
  149.  
  150. The user then has two main choices: Upload Search or Download Search.
  151.  
  152. For a 1 file system:
  153.  
  154. [D] Search for files that have been Downloaded/Uploaded
  155. [H] Help
  156. [Q] Quit to BBS
  157. [G] Log off BBS
  158.  
  159. The user then has One main choice: Upload Search and Download Search.
  160.  
  161. ┌───────────────┐
  162. │ UPLOAD SEARCH │
  163. └───────────────┘
  164.   The user can search for any key string that is located within the Upload 
  165.   File listing.  
  166.  
  167.  
  168.     ORIGINS Version 3.1                                             Page - 3
  169.  
  170. ┌─────────────────┐
  171. │ DOWNLOAD SEARCH │
  172. └─────────────────┘
  173.  
  174.   The user  can also  search for  any key  string that  is located  within the
  175.   Download File listing.  
  176.  
  177. ┌──────┐
  178. │ QUIT │
  179. └──────┘
  180.   Finally, the user can return to PCBoard after they have finished using the 
  181.   File Origins Door. 
  182.  
  183. ┌─────────┐
  184. │ GOODBYE │
  185. └─────────┘
  186.   Finally, the user can exit the BBS from the DOOR.
  187.  
  188.     ORIGINS Version 3.1                                             Page - 4
  189. ╔══════════════╗
  190. ║ INSTALLATION ║
  191. ╚══════════════╝
  192.  
  193. 1. Configure PCBoard for Origin door:
  194.      Using PCBoard's PCBsetup program, add the door to your list of doors.
  195.      Fields:
  196.         Filename        -        SYSOPs Choice   (must match startup file)
  197.         Password        -        SYSOPs Choice
  198.         Sec             -        SYSOPs Choice
  199.         Login           -        SYSOPs Choice (Not recommended)
  200.         User Sys        -        Yes
  201.         Door Sys        -        No
  202.         Shell           -        No
  203.         Path to Files   -        Not Needed
  204.  
  205. 2.  Make directory for Origin door
  206.      - Make a directory to hold the Origin door files.
  207.      - i.e.  mkdir \doors\Origin
  208.  
  209. 3.  Create the start up file i.e. ORIGIN
  210.      - a sample is listed below
  211.  
  212.       @echo off
  213.       c:
  214.       cd \doors\origin
  215.       origin origin.cnf
  216.       cd \pcb
  217.       board
  218.  
  219. 4.  Copy files to appropriate places
  220.      - copy Origin door.exe and Origin door.cfg to the Origin door directory.
  221.      - copy the startup file into the default PCBoard directory i.e. \pcb
  222.        or place it in your dos path
  223.  
  224. 5.  Create the configuration file  i.e. ORIGIN.CNF
  225.    If the first line is a "1" then the board will process the file in the
  226.    next line only.  If the first line is a "2" then it will process both
  227.    following lines.  A "2" is the perfered method as this will increase
  228.    the speed in which the search is done, because its only looking through
  229.    uploads OR downloads and not both.  However a "1" is extreamly fast also.
  230.    
  231.    Example xxxxxxxx.CNF file:
  232.    2                          <== Number of files to support 1 or 2
  233.    F:\pcb\main\DOWNLOAD.TXT   <== Location of Download File Listings 
  234.    F:\pcb\main\UPLOAD.TXT     <== Location of UpLoad File Listings 
  235.  
  236.   The following sysop functions are available while awaiting keyboard input :
  237.  
  238.   One of   the  nicer   features about   using the TWIT  key,  is  the user is
  239.   not told that "the  sysop wants them  to return to  the BBS".   Instead,   a
  240.   Whatever you have set in your PCBTEXT file will show under the door.
  241.  
  242.   When using  the F5 shell to  DOS key, to return to the door  program, simply
  243.   type  EXIT  at  the  DOS  command  prompt.  It  is  not  necessary to change
  244.   directories  back  to  the  door  directory.  ORIGIN is smart enough to know
  245.   which drive  and directory  the door  program is   in and   will reset   the
  246.   defaults upon return  from DOS.   In addition, the  status line will  remain
  247.   "glued" to the screen.
  248.  
  249.   You have full PCBoard funtions keys.
  250.  
  251.     ORIGINS Version 3.1                                             Page - 5
  252.  
  253.  ╔═════════════════════════════╗
  254.  ║  A MÄC's Place BBS Release  ║
  255.  ╚═════════════════════════════╝
  256.  
  257. History of the File Origins Door Changes  [in reverse order]
  258. ═════════════════════════════════════════
  259.        ORIGIN 3.1:  4 January 1993
  260.          o Added Support for single file operation
  261.          o Added Full screen help for users
  262.          o improved Speed by 4% 
  263.          o 115,000 baud rate now supported
  264.          o Now report number of lines processed
  265.          o Added ^S and ^K support (suspend and Kill)
  266.  
  267.        ORIGIN 3.0:  23 December  1992
  268.          o Re-wrote the entire package WITHOUT the GAPCDR library.
  269.            Completly different, a re-release !
  270.  
  271.        ORIGIN 2.2:  4 February  1990
  272.          o Re-Wrote Searching Function is MicroSoft Assembler, link
  273.            it in at compile time.  Increase in search speed.
  274.          o Took out the hardcoded command line: origin origin.cnf
  275.            now the "origin.cnf" can be anything you want i.e. 
  276.            origin1.cnf - origin2.cnf - origin3.cnf  etc....
  277.          o Added support for opening the door at 38,400 baud.  Up from
  278.            19,200 baud.
  279.          o Error messages are now displayed if a file isn't found.
  280.          o Added virtual buffer on both files that are read, its less
  281.            disk intensive and faster.
  282.          o Slowed down the closing of the door so the entire message is
  283.            displayed.
  284.          o Added version number to opening screen as per SYSOP request
  285.        
  286.        ORIGIN 2.1:  15 December 1989
  287.          o Fixed bug in the EXIT of the program, it used to turn 
  288.            the screen Blue after exiting the door, whether you
  289.            had graphics mode selected or not.  Basically, the
  290.            door closed too fast to allow a reset of colors
  291.  
  292.        ORIGIN 2.0:  13 December 1989
  293.          o Re-Wrote Searching fucntion.   Version 1.1 processed
  294.            15,000 lines in 56.0 secs and Version 2.0 processes
  295.            15,000 lines in 26.0 secs on a 10 mHz AT Clone.
  296.          o Changed the OutPut to the screen so its a little easier
  297.            to read.  Used Tokens to do this, did NOT use a structure
  298.            because users would rather have it fast instead of pretty
  299.          o Due to SYSOP request I took the (P)age SYSOP function out
  300.          o Changed Enviorment Variable MACDOOR=PCB
  301.  
  302.        ORIGIN 1.1:  10 October 1989
  303.  
  304.          o Changed Opening screen Phone number to reflect the
  305.            move of MÄC's Place.  SYSOPs Please replace .EXE file
  306.            with the new one.  Thankyou.
  307.  
  308.     ORIGINS Version 3.1                                             Page - 6           
  309.        ORIGIN 1.0:  18 May 1989
  310.  
  311.          o Initial Public Release of File Origins by NAPSWare Productions.
  312.          o Help Screens are in Full ANSI Color.
  313.          o Fully network compatible, can be run in a multi-node environment.
  314.          o Displays the number of sucessful matches found and the total 
  315.            number of lines read for each search.
  316.  
  317.        ORIGIN 0.8ß: 16 May 1989
  318.  
  319.          o Fixed problem with the scrolling of multiple screens of text
  320.            information.
  321.          o Improved ANSI color graphics Help screen output.
  322.  
  323.        ORIGIN 0.5ß: 11 May 1989
  324.  
  325.          o Initial Beta Release of File Origins by NAPSWare Productions.
  326.          o Supports PCBoard Version 14.x Only !! 
  327.          o Uses modified version of GAPCDR Support LIBrary for PCBoard
  328.            communications and system functions.
  329.          o Reads separate input files for upload / download text searches,
  330.            or optionally can read the same input file.           
  331.  
  332.  
  333.  These  files  are  distributed  under  the  FreeWare concept - freely 
  334.  available  to PCBoard  SysOps. Please  Do Not   distribute  modified  
  335.  versions without permission of the author.
  336.  
  337.  Do Not remove this notice or any other copyright notice.
  338.  
  339.                          ╔══════════════════╗
  340.                          ║══════════════════║
  341.                          ║    DISCLAIMER    ║
  342.                          ║══════════════════║
  343.                          ╚══════════════════╝
  344.  
  345.  
  346.    THIS PRODUCT IS LICENSED  "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY
  347.    OR FITNESS  FOR  A  PARTICULAR  PURPOSE,  PERFORMANCE,  OR OTHERWISE. ALL
  348.    WARRANTIES ARE EXPRESSLY DISCLAIMED.  BY  USING  THE  FILE  ORIGINS  DOOR 
  349.    PROGRAM    YOU AGREE THAT JOHN MCNAMARA WILL NOT BE  LIABLE TO YOU OR ANY 
  350.    THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE)  OR  PERFORMANCE OF THIS 
  351.    PROGRAMME, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT,  TORT 
  352.    OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE.
  353.  
  354.    You may not reverse-engineer, disassemble, modify,  decompile or  create
  355.    derivative works of this programme.  Piracy has been investigated by the
  356.    FBI and prosecuted under federal statutes.   Applicable law provides for
  357.    damages  and recovery of attorney's fees.   Distribution  of  any  MAC's 
  358.    Place BBS  Release program's  in  any  medium  without  its accompanying 
  359.    documentation is  an  unauthorized  modification.  That  is  a  theft of 
  360.    intellectual property.  
  361.  
  362.    ----------------
  363.      PCBoard  (C) is a registered trademark of Clark Development Company.
  364.  
  365.     ORIGINS Version 3.1                                             Page - 7
  366.                                  LICENSE
  367.                                  =======
  368.  The  File  Origins  PCBoard  Door  programme  can be  freely distributed  so
  369.  long  as  it  is  not  modified  or  sold  for  profit.  If you find that the
  370.  programme is  valuable, you  can send  a donation  for what  you think  it is
  371.  worth.  A donnation of $5 is suggested.
  372.  
  373.  Please Send your contributions to:
  374.  
  375.  
  376.     MAC's Place BBS
  377.     ATTN:John McNamara
  378.     P.O. Box 911
  379.     Dunn, NC 28335
  380.  
  381.  If you have any questions, bugs, or suggestions, please contact:
  382.  
  383.                                    
  384.      John McNamara - SysOp         
  385.      Mäc's Place BBS               
  386.      (919) 891-1111 16.8K Dual Std
  387.  
  388.    The latest version is always available for downloading.
  389.  
  390. ╔══════════════════════════╗
  391. ║ File Origins Background: ║
  392. ╚══════════════════════════╝
  393.   John McNamara wrote all the code for File Origins in approximately 4  hours.
  394.  
  395.   The File Origins door programme is written in C++ and Assembler routines and
  396.   was compiled with Borland C++ 3.1  The ORIGIN C LIBrary    The ORIGIN source
  397.   code LIBrary  was modified  and recompiled  with our  specific improvements.
  398.   The C++ language  was choosen for  writing several of  the  MÄC's Place BBS  
  399.   PCBoard utilities   such as   File Origins Door  because  of  its  speed and
  400.   flexibility.  The C++  source is available upon request and for small fee.  
  401.  
  402.      Author:
  403.                                      
  404.      John McNamara - SysOp           
  405.      MÄC's Place BBS                 
  406.      (919) 891-1111 [16.8 DS]      
  407.