| FDTGFILE v3.00 Documentation
|
| Telegard/FrontDoor download counter updater
|
| Copyright 1991,1995 by Tim Strike and Forbidden Knights Systems.
| Released on September 13th, 1995.
____________
INTRODUCTION
____________
For use with Telegard 3.0. If used with any other versions of
Telegard, FDTGFILE could cause unpredictable and unrepairable
results. FDTGFILE supports FrontDoor v2.02+ log file formats only.
FDTGFILE was designed to search the FrontDoor logs and find
transferred files, and then update the database in Telegard to
properly reflect the number of downloads (in this case file
requests and FREQ's) and last transfer dates. These records would
normally never be updated, but your system has possibly transferred
these files to many boards, and they aren't as 'inactive' as files
as their statistics would appear.
FDTGFILE also has the ability to update the system HISTORY
logs to reflect the proper number of download counters for that
day (both # files/K).
FDTGFILE uses the file indexing system of Telegard to quickly
locate these files. As long as this index is properly maintained,
you will experience no problems with FDTGFILE. When diagnosing
problems with FDTGFILE, please ensure that all your other utilities
are properly maintaining the FILES.IDX file.
_________________
PROGRAM OPERATION
_________________
FDTGFILE <filepath-of-CONFIG> <logfile> <output> <options>
<filename-of-CONFIG> is the full path and filename to the Telegard
configuration file that you want to use. This will for most normal
setups be in the main BBS directory as the /CONFIG.TG file.
<logfile> is the FrontDoor logfile to check. This log file will
me renamed or deleted after use (so it can not be rechecked again
to cause duplicate processing). The full path and filename should
be included.
<output> is the filename to output. This will contain a listing
of all files processed by FDTGFILE and the file directory that they
were processed in.
<options> are used to control how FDTGFILE handles the various
checks, updates and logfiles. The options should all be run
together with one command line switch -- stray options will not be
seen. The options list can contain any of the following characters
to cause certain actions to be taken.
D Delete FrontDoor log after processing. DEFAULT: Rename
the log to <filename>.nnn where nnn is the next number
in sequence.
E Look for file to see if it exists before going any
further. If it does not exist, consider "missing"
and do not even look in file indexes. DEFAULT: Do
not look for files.
H Do not update HISTORY.DAT downloads/K. DEFAULT: Update
L Delete FDTGFILE log after processing. DEFAULT: Keep
Note: Even if you specify L in the options, you
must provide a valid, non-existing <output> file.
P Path match file areas; check to see if outbound path
matches found file area. If they do not match,
the files are considered "found" but not "updated".
DEFAULT: No path matching
Sample command lines might be:
FDTGFILE C:\BBS\CONFIG.TG C:\FD\MAIL.LOG C:\BBS\SYSOP\FREQ.LOG -DP
FDTGFILE C:\BBS\CONFIG.TG C:\FD\MAIL1.LOG C:\BBS\SYSOP\FDFILE.LOG
________
VERSIONS
________
This section will always contain the history/update information
on this program. It will list a general summary of bug fixes and new
features. Please read this section on every upgrade, even if you
don't plan on reading any other section.
+:New Feature *:Updated (Fixed) Feature
Prior to v3.00
+ Written in Turbo Pascal 6.0 for TELEGARD 2.7
v3.00
+ Written in Turbo Pascal 7.0 for TELEGARD 3.0
__________
LEGALITIES
__________
WARRANTY
FDTGFILE is provided as-is without a warranty of any kind,
either express or implied. This program is guaranteed to occupy
disk space and nothing more. Under no circumstances shall the
author or anyone related to the production of this utility be
liable to you or anyone else for any damages, including (but not
limited to) any lost profits, lost savings or other incidental
or consequential damages arising out of the use or misuse of
this program. Usage of this program is an understanding of said
statement.
In other words -- RUN THIS PROGRAM AT YOUR OWN RISK. By
choosing to use this program you are taking all responsibility
for anything that occurs with its usage.
COPYRIGHT
The program, and all documents and files included in the
original FDTGFILE release package are copyrighted to Tim Strike
and Forbidden Knights Systems. The included files may not be
modified in any manner.
The original archive may be freely distributed WITHOUT
charge. The format of the original archive can be changed to
another archiving product. At no point in the archives
distribution may files be added or removed.
FDTGFILE may be packaged on a distribution diskette or in a
compilation archive, but under no circumstances may any charge
be incurred beyond the physical cost of the hardware (disks,
CD...) or transfer medium (phone, mail...).
CREDITS
All brand and product names referenced in this document are
trademarks, registered trademarks, or copyrighted works of
their respective holders.
_____________________
CONTACTING THE AUTHOR
_____________________
I can be contacted in a number of different methods. When
sending netmail or posting in one of the conferences, direct mail
to "Tim Strike". Replies will be forthcoming as soon as I can get
to them.
NETMAIL:
Telenet Canada Fidonet Xnet ITCnet
20:22/101 1:259/423 40:41/108 85:896/908
INTERNET:
ts@gryn.org
ECHOMAIL CONFERENCES:
TELEGARD Telegard Support (ITCNET)
TNC_FKNIGHTS Forbidden Knights Support (TNC)
TNC_TG Telegard Support (TNC)
TG_SUPPORT Telegard Support (FIDONET)
XNET_TG Telegard Support (XNET)
POSTAL MAIL:
Forbidden Knights Systems
Attn: Tim Strike
3360 Council Rind Rd, Unit 11
Mississauga, ON
L5L 2E4
BULLETIN BOARD:
Forbidden Knights Systems
(905)820-7273
2400-16,800 HST/v.32bis
Access denied between 4:00am and 5:00am
Restricted access between 10:00pm and 11:00pm
Any changes or upgrades that need to be made to FDTGFILE v3.00
will be made as time permits. Further suggestions, comments and/or
bug reports can be directed through one of the above methods.
Enjoy fully.