home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
ra
/
ragthr12.zip
/
GATHER.DOC
< prev
next >
Wrap
Text File
|
1993-02-20
|
7KB
|
210 lines
GATHER v. 1.20
Copyright 1993
by
Pass - the - Buck Software
Independence, Mo.
Gather is a simple, single purpose utility designed for use with the
RemoteAccess (c) Bulletin Board System. It gathers the files on the
system into an ALLFILES listing for download by system users.
Gather does NOT attempt to manage files or alter your files.bbs in any
way. It is intended for, and well behaved in, unattended operation on
a 80286 or better system. Gather was not designed to operate on an XT
class machine. A version of Gather compiled with the 8088 instruction
set is available upon request.
While Gather has been exhaustively tested and performs reliably in DOS,
Windows and DesqView, it is impossible to guarantee it will work in all
system configurations. The usual FreeWare/ShareWare disclaimers apply.
Use this program at your own risk.
This program may be used and freely distributed for all non-commercial
uses in unmodified form and with all files included and intact.
For non-commercial usage of this program you are NOT required to
register or notify the author. I would appreciate a short FIDO NetMail
message if you care to send one. Please let me know if the program
is of value to you and behaves well on your system. Of course, also
let me know if you have any problems with it.
NETMAIL: Dave Perry FIDO 1:280/19
1:280/32
I will receive mail addressed to either node.
The author retains all intellectual property and distribution rights.
INSTALLATION:
Create a directory to contain the GATHER files. This directory would
normally contain:
GATHER.EXE The executable file
GATHER.CFG The configuration file
GATHER.DOC This documentation (for future reference)
GATHER.HDR User supplied ASCII text BBS Banner file
GATHER.FTR User supplied ASCII text file appended to end of listing.
NEW.HDR User supplied ASCII text BBS Banner file
NEW.FTR User supplied ASCII text file appended to end of listing.
All of the files listed may reside anywhere in the system as long as the
complete path and file names are included in the configuration file. If
the files are contained in the SAME directory as the .EXE file, only the
file name need be listed in the config file.
OPERATION:
Gather requires that the RA environment variable be set in your system.
It uses this information to locate the FILES.RA control file used by RA.
Gather reads this file to locate the FILES.BBS files in each of the system
directories. See your RA documentation if this environment variable is
not currently set. (It should be for proper operation of RA)
Gather expects to find the GATHER.CFG file in the current working directory.
If the configuration file lives elswhere in the system, the command line
MUST contain the complete path and file name for the file. This also makes
it possible to use separate configuration files for different purposes or
groups of users. If you wish to make different listings for different
security levels or for network MAGICNAME listings, just create the config
files and call Gather with the path file names of the separate configurations.
CONFIGURATION:
Following is a complete list of the configuration commands that can be
used in configuring Gather for your system. The commands may be used in
any order.
The command must be the first thing on the line and may be in either
upper or lower case. Following the command in the text is a sample
parameter. Use this as a guideline to make it suit your system.
GATHER supports .arc .arj .lzh .pak .zip file compression utilities.
It expects to find the compression program in a directory included in the
DOS path statement or in the current working directory.
ALLFILES d:\ra\files\bbsfiles.zip
Produce a file called BBSFILES compressed with PKZIP (c) in the indicated
directory. The file name of the uncompressed file is ALLFILES.TXT by default.
ALLTEXT 280-19.lst
Make the uncompressed allfile listing with the name 280-19.LST. This makes
the uncompressed file identifiable with your system when the user has
downloaded several.
NEWFILES d:\ra\files\bbsnew.zip
Produce a file called BBSNEW compressed with PKZIP (c) in the indicated
directory. The file name of the uncompressed file is NEWFILES and is a listing
of files that have arrived on the system in the last nn days. Use the NEWDAYS
command (below) to set the number of days.
NEWTEXT 280-19.new
Make the uncompressed NEW file listing with the name 280-19.NEW. This makes
the uncompressed file identifiable with your system when the user has
downloaded several.
DIR_ID on
Some systems use file management utilities which modify the FILES.BBS file
to include header information. This switch makes Gather compatable with
most of these utilities. If this switch is OFF, Gather will not include
a directory header or file summary in the each of the directories. The
header placed in the FILES.BBS file will be used instead.
NEWMARK *
Defines the character to use to indicate new files in the ALLFILE list.
If this command is deleted or commented out and a new file search is
indicated, the graphics character "■" is used by default.
NEWDAYS 30
Defines the number of days to include in a NEW file search. If this
command is deleted or commented out no NEW files will be indicated in
the ALLFILE list and NO NEW files output file will be created. Valid
NEWDAYS range from 1 to 255.
HEADER [d:\dir\]gather.hdr
Path and file name to be prepended to the ALLFILE list. If the ASCII
text file lives in the current directory, only the file name is needed.
If you wish to use a file used for archive commenting, you may use the
full DOS path and file name to indicate that file. This file may be
named anything you wish as long as it is a valid DOS file name.
FOOTER [d:\dir\]gather.ftr
Same as above but file is appended to the end of the file listing.
NEWHEADER [d:\dir\]new.hdr
Same as above but applies to NEW listing file.
NEWFOOTER [d:\dir\]gather.ftr
Same as above but applies to NEW listing file.
SECURITY 20
Sets the security level of user access to a specific directory for
both the NEW and ALLFILE listings. All directories with user download
access of 20 or less will be included in the list. Directories with
user access of 21 or greater will not be included in the listings.
LOGFILE d:\ra\ra.log
Complete DOS path and file name of logging file to use for Gather
output. The default is GATHER.LOG in the current directory. Naming
the path to the RA system log will result in the inclusion of Gather
results in that file.
I hope you find this utility of value.
Dave Perry
Pass - the - Buck SoftWare
Independence, Mo.
1:280/19
History:
01/17/93
v. 1.1
First release of GATHER remade to operate with RemoteAccess from
original designed for another BBS system.
02/20/93
v. 1.2
Changed date comparison routine that was causing GATHER to ignore
files uploaded in current month if month was not January. Had to
wait till February to find this one. Thanks to Mike Poston of the
Sounding Board BBS for calling this to my attention.