SAMCDPG.EXE Version 0.01

README
SAMCDPG   EXE
SAMCDPG   CFG
SAM_CD    ENG

This software accesses the SAM CD ROM directly, and does not use the API.
Loading the API, will not help or hurt the program, but will take a chunk
of memory.

This program interfaces the FBB BBS system, with the SAM CD ROM by RT
Systems for real-time lookups by name, call, ZIP code, or city and state.
SAMCDPG.EXE is the interface program, and needs to be installed in the PG
subdirectory, normally \FBB\PG\. SAMCDPG.CFG can be placed in the same
directory as SAMCDPG.EXE or in a directory in the DOS path, such as \FBB\BIN\.
Once FBB is started, the PG programs will be noticed, and the program name
becomes a valid command. So all a user need do to enter the server is type
SAMCDPG. What some have done, is re-name both to QTH.EXE and QTH.CFG. This way,
all auser needs to do, is type QTH at the BBS prompt, and he is into the
server. The rule to follow here is the program and configuration files MUST
have the same names, with extensions of EXE and CFG.

The SAMCDPG.CFG file needs to be edited with site specific data. The scripts
are in a file named in the CFG file. Sysops may create new files, which will
switch with the FBB OL command. For example, a user may create an ANSI script
file, and list it in the CFG file in the same order as in the LANGUE.SYS. If
a user chooses #2 ANSI for the FBB display, he will get the #2 ANSI display
for the server also. The user may also add foreign language scripts, if he
has the talent. A limited set of FBB $variables is supported. There is a list
at the end of the SAM_CD.ENG file for reference.

Most of the configuration file is self-explanatory.  The second path
requested is for a temporary files area. This is necessary for the program
to act as part of the FBB system. Each time a user enters the server, a
temporary file is created with a name made of the users call and SSID. Each
subsequent time the server is entered, this file information is used and
updated. Each file is only about 87 bytes, and they can be deleted with no
impact to the server, as long as the BBS is not running at the time, eg. NOT
in the DOS gateway. For best performance and self cleaning, consider using a
RAMDRIVE path. If you are already running SAMQTH or QRZQTH, use a different
subdirectory for the SAMCDPG program.

The WP information is indexed. Another program in QRZWP002.ZIP ( latest as
of this time ) is used to index a copy of the WP database file. The original
changes constantly, so insert the copy statement and program statement in
your APPEL.BAT, so it updates daily when housekeeping takes place. To seed
the system the first time, use F8 software reboot, and choose housekeeping.
The index file is 11 bytes per record, so it will not take up too large a
space. If the index is not created, the program will run without it. See the
included APPEL.BAT for an example way of running the index program during
cleanup. Renaming the WP.OLD instead of copying the WP.SYS saves a few meg of
drive space. If you are also running SAMQTH.EXE or QRZQTH, it is the same WP
index file and may be shared.





*************************  SOAPBOX  ***********************************
This software is copyrighted, and may be freely used and distributed by
licensed radio amateurs. Any commercial use is forbidden. This software
is released on an as is basis, with no guarantees of any type. 

I have a lot of fun programming, but always need feedback for ideas,
and bug fixes. Let me know what is on your mind, even if it is running
fine. Most folks are quiet when things are working right, and gives me
the feeling nobody is running this stuff. Drop me a QSL card and tell me 
which program you are running. 
***********************************************************************

NK3T @ NK3T.MD.USA.NOAM    Packet
dhess@umes.umd.edu         Internet
David Hess
3735 Algonquin Trail
Snow Hill, MD
21863
410 632-3967

