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 >
Wrap
Windows Setup INFormation
|
1993-01-04
|
17KB
|
407 lines
╔═══════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═══════════════════════════╝
FILE ORIGINS: File Download / Upload Searches
~~~~ ~~~~~~~ ~~~~ ~~~~~~~~ ~ ~~~~~~ ~~~~~~~~
Version 3.1
Copyright (c) 1989-1993 John W. McNamara
All rights Reserved
Written By:
John McNamara
MÄC's Place BBS
Dunn, NC
(919) 891-1111 [16.8 DS]
Release Date: 4 Jan 1993
ORIGINS - Version 3.1 Page - 1
File Origins - A MÄC's Place BBS Release PCBoard File Search Door
┌────────────────────────────────┐
│ Files included in this Zip: │
└────────────────────────────────┘
ORIGIN.EXE - Main File Origins Executable File, Version 3.1
ORIGIN.CNF - File Origins Sample Configuration File
ORIGIN - File Origins Sample PCBoard Door File
ORIGIN.DOC - Information on File Origins Door
ORIGIN.HIS - Programme Release History
README.NOW - Information on Files Available with the
File Origins PCBoard Door
HOT_ADS.TXT - Information on File Origins support programmes:
Hot Companion and BudMan.
BUDMAN30.ZIP - Download.txt File splitter for PCBoard
HCOMP40.ZIP - Download.txt Parser for PCBoard
┌───────────────────────────────────────────────────┐
│ F I L E O R I G I N S - V e r s i o n 3 . 1 │
└───────────────────────────────────────────────────┘
╔═════════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═════════════════════════════╝
The File Origins door has two support programmes that are also available
HotStuff Companion [Version 4.0]
==================
The HotStuff Companion programme was written because of the need to
strip the DOWNLOAD.TXT and CALLER files created by PCBoard (tm) of
old, outdated, or unwanted files. When HotStuff or File Origins are
run, they may reflect files that are no longer on your Bulletin
Board System.
The programme uses a parsing routine [similar to the UNIX Grep]
to search a file line by line for a string and eliminate that text
from the file. The programme is available as: HCOMP40.ZIP. It is
included in this archive. It will now process 3 different strings at
once.
BudMan Utility [Version 3.0]
==============
The BudMan programme does what PCBoard (tm) should already do. It
splits the DOWNLOAD.TXT file into two files, one with the downloads
and the other with uploads. The programme is available as:
BUDMAN30.ZIP. It is inlcuded with the archive.
ORIGINS - Version 3.1 Page - 2
╔══════════════╗
║ Introduction ║
╚══════════════╝
Welcome to File Origins !! File Origins is a PCBoard door programme that
allows the user to perform an extremely RAPID search of file downloads or
uploads on a BBS for a specific key search string. The programme can
locate any key string that is contained within file download or upload
files. The search string can be a user name, file name, or even a date.
Some examples would include:
HOTDOG - any accesses to this file
MCNAMARA - any activity by this user
05-10-1993 - any activity on this date
It is recommended that you use separate download and upload file listings
for the programme. We have included the BudMan programme which automates
the separation of the standard PCBoard Download.txt file into two
files: a download and upload file [something that PCBoard should be doing
anyway !!]. The File Origins programme reads from two files for the file
downloads and uploads. Of course you could read from the same file [eg -
Download.txt] for both downloads and uploads.
One of the main features of the File Origins programme is its SPEED !! It
is written in Borland C++ 3.1 with an Assembler string parsing routine
[similar to the UNIX Grep] to maximize the search speed. It is approximately
33 percent faster than Sam Smith's ProWho. It has the added feature that
it only searches through either an Upload file listing or Download file
listing for the search string, which is not counted in the time trial.
ORIGINS Version 3.1 Page - 2
The main features of the File Origins programme include:
o It uses either an Upload file listing or Download file listing
to locate the search string.
o It can also only use one file if you don't want to split it
o Extreamly fast
o Share and Network Compatible allowing it to be run on multiple
nodes.
o Full comm support up to 115,000 baud
o Provides ALL PCBoard Funtion keys and features
ORIGINS - Version 3.1 Page - 3
╔═══════════════════════════════╗
║ File Origins Door Operation: ║
╚═══════════════════════════════╝
The operation of the File Origins Door is straight forward. The programme
presents the welcome screen and then displays the main menu.
File ORIGIN/DESTINATION Door
For a 2 file system:
[U] Search for files that have been Uploaded
[D] Search for files that have been Downloaded
[H] Help
[Q] Quit to BBS
[G] Log off BBS
The user then has two main choices: Upload Search or Download Search.
For a 1 file system:
[D] Search for files that have been Downloaded/Uploaded
[H] Help
[Q] Quit to BBS
[G] Log off BBS
The user then has One main choice: Upload Search and Download Search.
┌───────────────┐
│ UPLOAD SEARCH │
└───────────────┘
The user can search for any key string that is located within the Upload
File listing.
ORIGINS Version 3.1 Page - 3
┌─────────────────┐
│ DOWNLOAD SEARCH │
└─────────────────┘
The user can also search for any key string that is located within the
Download File listing.
┌──────┐
│ QUIT │
└──────┘
Finally, the user can return to PCBoard after they have finished using the
File Origins Door.
┌─────────┐
│ GOODBYE │
└─────────┘
Finally, the user can exit the BBS from the DOOR.
ORIGINS Version 3.1 Page - 4
╔══════════════╗
║ INSTALLATION ║
╚══════════════╝
1. Configure PCBoard for Origin door:
Using PCBoard's PCBsetup program, add the door to your list of doors.
Fields:
Filename - SYSOPs Choice (must match startup file)
Password - SYSOPs Choice
Sec - SYSOPs Choice
Login - SYSOPs Choice (Not recommended)
User Sys - Yes
Door Sys - No
Shell - No
Path to Files - Not Needed
2. Make directory for Origin door
- Make a directory to hold the Origin door files.
- i.e. mkdir \doors\Origin
3. Create the start up file i.e. ORIGIN
- a sample is listed below
@echo off
c:
cd \doors\origin
origin origin.cnf
cd \pcb
board
4. Copy files to appropriate places
- copy Origin door.exe and Origin door.cfg to the Origin door directory.
- copy the startup file into the default PCBoard directory i.e. \pcb
or place it in your dos path
5. Create the configuration file i.e. ORIGIN.CNF
If the first line is a "1" then the board will process the file in the
next line only. If the first line is a "2" then it will process both
following lines. A "2" is the perfered method as this will increase
the speed in which the search is done, because its only looking through
uploads OR downloads and not both. However a "1" is extreamly fast also.
Example xxxxxxxx.CNF file:
2 <== Number of files to support 1 or 2
F:\pcb\main\DOWNLOAD.TXT <== Location of Download File Listings
F:\pcb\main\UPLOAD.TXT <== Location of UpLoad File Listings
The following sysop functions are available while awaiting keyboard input :
One of the nicer features about using the TWIT key, is the user is
not told that "the sysop wants them to return to the BBS". Instead, a
Whatever you have set in your PCBTEXT file will show under the door.
When using the F5 shell to DOS key, to return to the door program, simply
type EXIT at the DOS command prompt. It is not necessary to change
directories back to the door directory. ORIGIN is smart enough to know
which drive and directory the door program is in and will reset the
defaults upon return from DOS. In addition, the status line will remain
"glued" to the screen.
You have full PCBoard funtions keys.
ORIGINS Version 3.1 Page - 5
╔═════════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═════════════════════════════╝
History of the File Origins Door Changes [in reverse order]
═════════════════════════════════════════
ORIGIN 3.1: 4 January 1993
o Added Support for single file operation
o Added Full screen help for users
o improved Speed by 4%
o 115,000 baud rate now supported
o Now report number of lines processed
o Added ^S and ^K support (suspend and Kill)
ORIGIN 3.0: 23 December 1992
o Re-wrote the entire package WITHOUT the GAPCDR library.
Completly different, a re-release !
ORIGIN 2.2: 4 February 1990
o Re-Wrote Searching Function is MicroSoft Assembler, link
it in at compile time. Increase in search speed.
o Took out the hardcoded command line: origin origin.cnf
now the "origin.cnf" can be anything you want i.e.
origin1.cnf - origin2.cnf - origin3.cnf etc....
o Added support for opening the door at 38,400 baud. Up from
19,200 baud.
o Error messages are now displayed if a file isn't found.
o Added virtual buffer on both files that are read, its less
disk intensive and faster.
o Slowed down the closing of the door so the entire message is
displayed.
o Added version number to opening screen as per SYSOP request
ORIGIN 2.1: 15 December 1989
o Fixed bug in the EXIT of the program, it used to turn
the screen Blue after exiting the door, whether you
had graphics mode selected or not. Basically, the
door closed too fast to allow a reset of colors
ORIGIN 2.0: 13 December 1989
o Re-Wrote Searching fucntion. Version 1.1 processed
15,000 lines in 56.0 secs and Version 2.0 processes
15,000 lines in 26.0 secs on a 10 mHz AT Clone.
o Changed the OutPut to the screen so its a little easier
to read. Used Tokens to do this, did NOT use a structure
because users would rather have it fast instead of pretty
o Due to SYSOP request I took the (P)age SYSOP function out
o Changed Enviorment Variable MACDOOR=PCB
ORIGIN 1.1: 10 October 1989
o Changed Opening screen Phone number to reflect the
move of MÄC's Place. SYSOPs Please replace .EXE file
with the new one. Thankyou.
ORIGINS Version 3.1 Page - 6
ORIGIN 1.0: 18 May 1989
o Initial Public Release of File Origins by NAPSWare Productions.
o Help Screens are in Full ANSI Color.
o Fully network compatible, can be run in a multi-node environment.
o Displays the number of sucessful matches found and the total
number of lines read for each search.
ORIGIN 0.8ß: 16 May 1989
o Fixed problem with the scrolling of multiple screens of text
information.
o Improved ANSI color graphics Help screen output.
ORIGIN 0.5ß: 11 May 1989
o Initial Beta Release of File Origins by NAPSWare Productions.
o Supports PCBoard Version 14.x Only !!
o Uses modified version of GAPCDR Support LIBrary for PCBoard
communications and system functions.
o Reads separate input files for upload / download text searches,
or optionally can read the same input file.
These files are distributed under the FreeWare concept - freely
available to PCBoard SysOps. Please Do Not distribute modified
versions without permission of the author.
Do Not remove this notice or any other copyright notice.
╔══════════════════╗
║══════════════════║
║ DISCLAIMER ║
║══════════════════║
╚══════════════════╝
THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE. ALL
WARRANTIES ARE EXPRESSLY DISCLAIMED. BY USING THE FILE ORIGINS DOOR
PROGRAM YOU AGREE THAT JOHN MCNAMARA WILL NOT BE LIABLE TO YOU OR ANY
THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) OR PERFORMANCE OF THIS
PROGRAMME, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT, TORT
OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE.
You may not reverse-engineer, disassemble, modify, decompile or create
derivative works of this programme. Piracy has been investigated by the
FBI and prosecuted under federal statutes. Applicable law provides for
damages and recovery of attorney's fees. Distribution of any MAC's
Place BBS Release program's in any medium without its accompanying
documentation is an unauthorized modification. That is a theft of
intellectual property.
----------------
PCBoard (C) is a registered trademark of Clark Development Company.
ORIGINS Version 3.1 Page - 7
LICENSE
=======
The File Origins PCBoard Door programme can be freely distributed so
long as it is not modified or sold for profit. If you find that the
programme is valuable, you can send a donation for what you think it is
worth. A donnation of $5 is suggested.
Please Send your contributions to:
MAC's Place BBS
ATTN:John McNamara
P.O. Box 911
Dunn, NC 28335
If you have any questions, bugs, or suggestions, please contact:
John McNamara - SysOp
Mäc's Place BBS
(919) 891-1111 16.8K Dual Std
The latest version is always available for downloading.
╔══════════════════════════╗
║ File Origins Background: ║
╚══════════════════════════╝
John McNamara wrote all the code for File Origins in approximately 4 hours.
The File Origins door programme is written in C++ and Assembler routines and
was compiled with Borland C++ 3.1 The ORIGIN C LIBrary The ORIGIN source
code LIBrary was modified and recompiled with our specific improvements.
The C++ language was choosen for writing several of the MÄC's Place BBS
PCBoard utilities such as File Origins Door because of its speed and
flexibility. The C++ source is available upon request and for small fee.
Author:
John McNamara - SysOp
MÄC's Place BBS
(919) 891-1111 [16.8 DS]