OK.  This is a description of a program that I wrote to use in
my installation.  The program allows users connected to a G8BPQ
node to directly access callbook type data from the SAM database.
This program uses the virtual TNC2 emulation feature of the
G8BPQ code.  I plan to change this to the BPQHOST interface
soon.  I will include below pieces of my configuration file
and the startup batch file that I use to set this up.  This program
must be run in its' own dos session (I use DesqView and give back
clock cycles while in a wait loop using a call to DesqView).
I have called this thing SAMALL just to differentiate it from
SAMCALL which is included on the SAM distribution diskettes.

From my BPQCFG.TXT file:
...
;
TNCPORT
        COM=7
        APPLMASK=16    ; application number 5 as you can see below
        APPLFLAGS=1    ; send any command line information to the appl.
ENDPORT
;
...

and then at the end of the file
...

;
APPLICATIONS=DX,,*SYSOP,BB,FIND
;

Note that I chose to call this application FIND and, therefore
the user connects to the node, then enters
   FIND
to get a menu that allows lookups by either callsign or name
and then allows the database to be browsed one record at a time
and in either direction or the user enters
   FIND xxxxx
where xxxxx is the callsign of a station of interest.  The
first invocation does not automatically return the user to the
node from the application (there is however a 3 minute timeout)
while the second form does return the user to the node right after
the requested information is transmitted.

My startup batch file is:

cd\sam
samapi c:\sam
samall 7 16

The call to SAMAPI is necessary to start up the API that is provided
with the database.  The last line:
  SAMALL 7 16
starts up the server.  The number 7 is the virtual com port number
and can be anything as long as it agrees with what is in BPQCFG.TXT
and the second number is the application number (16 here corresponds to
the 5th application on the application line in BPQCFG.TXT).

Some information is presented in the dos session where the server is
running.  That information tells the owner of the server who has
connected and whether they used the callsign only lookup
mode (on a whim I called that QUICKLOOK) and if the other mode was
used reports the total time of use for that station.  I chose at
this time not to record anything into a file.

If you have problems, suggestions, whatever, please send me
either packet mail:
  KK4L@KK4L.#WNY.NY.US.NA
over Internet to:
  KDRESSER@GDLVM2.IBM.VNET.COM
or to my home at:
  Ken Dresser
  765 Town Line Road
  Johnson City, NY  13790

73 de Ken
