[ Return to server download index ] [ W1NPR's web page ] [ Freeman Crosby's web site ]

BBseries Real Time Yellow Page Server

==============================================================================
BBrtyp.exe                    (c) 1993-1999    by Freeman. M. Crosby     W1NPR
All rights reserved

Tested for Y2K compatibility to be used with:

The AA4RE REBBS V2.13+   Copyright (c) 1988 and 1994 by H. Roy Engehausen
Version 2.13T (y2k) Edited by Mike Fahmie WA6ZTY ==============================================================================

Requires BB2.13C or later running in protected mode and a FAST Harddrive 
Optional but preferred is the SAM CallSign database and BBlook.exe V2.12E or
later. Otherwise your database MUST be updated from some other source.

************************* NOTE Y2K Change ! **********************************
BBmakeyp.exe is no longer functional, to create your Yellow pages database
run BBhlypfx.exe ( included in this zip file )first with the SAM database and
TSR installed. BBlook.exe, if installed will maintain and update Hlookup.bb

==============================================================================

Description:

Yellow page server which will provide Users with lists of BBS stations by
searching their Hierarchical address in Hlookup.bb or in some cases if
available by State, City or Zipcode.
The S, C and Z searches require the SAM CallSign database and either BBlook or
BBmakeyp to maintain the data.
==============================================================================
Installation and Setup:

Place the BBrtyp.exe program and it's .REP and .TRL files anywhere you wish,
if you select any directory other than the "BB" default for BBrtyp.exe 
you must path to it when calling it up.

Edit the BBrtyp.trl and BBrtyp.rep files to suit

Edit BBrtyp.cfg as follows:

=========================== Sample BBrtyp.cfg ==============================
C:\bb\bbreqyp\
c:\bb\hlookup.bb


NOTE! This configuration file must be EXACT ! for proper operation of your
BBREQYP  ( Yellow page ) server.

Each parameter is on a single line.
Line #1 = Exact path to your BBreqyp files, you should have all related
          files in this directory including any trailers etc.
Line #2 = Exact path and fully qualified name for the file to be searched
         It may be your regular Hlookup.bb or  a modifed version Hlookup.yp
         which is optionaly produced by BBmakeyp.exe ( for Town/state/finds )
The server reads from top to bottom and picks up the configuration. 
Do NOT have any comments etc. Just facts in these lines left justified etc.
It will work if you have it right. This simple configuration saves code in
the main program.

======================= End of sample BBrtyp.cfg ===========================
Action.bb:

Place the following line exactly in Action.bb and then an "A" command to load it.

DEFINE_USER_COMMAND YP ES [aos] YP BBRTYP.EXE @$y *$1

If BBrtyp.exe is not in the "BB" defaut directory then path it as follows.

DEFINE_USER_COMMAND YP ES [aos] YP Path/BBRTYP.EXE @$y *$1

See AA4RE's Server.doc and Action.doc for explainations or other options. 
==============================================================================
The DATABASE:

BBrtyp will use any unmodified Hlookup.bb file from the AA4RE BBS program
or a modified one ( created with BBmakeyp.exe ).
You will specify what file and it's path in BBreqyp.cfg

NO State, City or Zipcode data will be available using unmodified Hlookup.bb
If this is the case edit BBrtyp.rep as needed.

The REBBS will use the modified Hlookup.bb and I suggest that you use only one
for practicality.

If you use BBlook.exe ( The update program ) you MUST use a version of
BBlook.exe V2.12E or later so that the files will be updated properly from
the SAM CallSign database.

BBmakeyp.exe will use the SAM callSign database to provide the State, City
and Zipcode information for your first conversion.

BBlook will keep the database current from messages passing through the BBS
after that.

Any Hlookup.bb file downloaded from the W1NPR BBS will have current CallSign
data already installed.

==============================================================================
Theory:
Users will enter requests while connected with the search criteria they
desire. See BBrtyp.rep for details.

NOTE !

If you are not running a modified version of Hlookup.bb ( with added data )
the edit BBreqyp.rep to only indicate the "I" ,"?" and "H" searches.
 
==============================================================================
ALSO read Disclaim.er  !
==============================================================================
User help file (BBrtyp.rep)
Edit this to reflect operation from your system as noted above:
------------------------------------------------------------------------------
REQYP ( Yellow page ) Real-time server instructions:

The Yellow page database is a list of BBS stations who have been parsed
from message R:headers on a daily basis by automated programs and have
been run through the SAM CallSign database for City, State and Zipcodes.
=============================================================================
    Command                              Operation from server
=============================================================================
NOTE ! Do not include {} brackets in your actual requests, spaces count.
YP I                          Information about the server
YP ?                          This information, help message will be sent.
YP R {CALL}                   Route to BBS if available
YP R {Call*}                  Wildcard list routes to BBSs starting with Call
YP S {Search}                 List all BBS in {State} two letter code
YP C {Search}                 List all BBS in {City} Will search from left

YP Z {Search}                 USA and Canadian Zipcodes ONLY are on file
Wildcards allowed after first two characters like YP Z 123## or YP Z 12*

YP H {Search}                 Worldwide search using Hierarchical address.
                              Will search database looking for a match to
                              your {Search} This will be a full portion of the
                              address, as an example #SRQFL would find all
                              BBS with a part of the address .#SRQFL.
                              #SRQ will only find .#SRQ. and miss .#SRQFL.
                              States and provinces may be searched this way
                              also as in MA FL NB etc. more details may be
                              included as in #SRQFL.FL.USA.NA to narrow search
                              GBR or USA or NA or NOAM will work but the full
                              response will take several return requests.

Response from the server will be limited. You will be prompted on how to place
another request if the information needed isn't in your reply.

A continuation of a request will be as follows Subject:
##### (S,C,Z,H) {Same search}
This will start at the record ##### that was last seen.

==============================================================================

Report bugs and comments to:

Freeman M Crosby
502 1/2 Estada St. 
Englewood FL 34223
(941)474-2690


E-mail is the best way to contact me:

servers@fcrosby.net

Packet address: ( poor path at present )

W1NPR@W1NPR.#SRQ.FL.USA.NOAM

Have fun !

73/Free
W1NPR


[ Return to server download index ] [ W1NPR's web page ] [ Freeman Crosby's web site ]