This document explains how to install the BuckMaster's HAMCALL cd-rom
interface package for the DxNet dxcluster under linux.

You must have the dosemu package installed to run this interface. This is
because Buckmaster do not provide any linux lookup program to search his
callbook database. So, the only way to access the database is to use a DOS
program.

I do some try with BUCKTSR.EXE under dosemu, without success. So I decided
to use the ICALL programm (special version included in ICALL-S cd-rom
directory).

Buckmaster provides this special version of ICALL for comptibility with some
programs. As they said, they will continue to make this special version as
long as possible for those that need it. It does certainly mind that there
is no certitude to get this program with the new releases of HAMCALL. So, If
you decided to buy a new release, be sure that this special version is still
available !




The installation can be simple.

Move the file buck_interface-??????.tgz to the /tmp directory, where ??????
is the date of the package (YYMMDD).
Use tar xvfz buck_interface-??????.tgz to make a directory /tmp/buck.

Then you will have a directory tree like :

Directory /tmp/buck/doc
REAME.buck		This file

Directory /tmp/buck/dos :
BUCK4LIN.EXE            DOS interface program compiled
BUCK.BAT                Batch file to run BUCK4LIN

Directory /tmp/buck/dos/src
MAIN.C                  source file
MAIN.H                  header file
FILE.C                  source file
FILE.H                  header file
EMULIB.C		source file
EMULIB.H		header file

Directory /tmp/buck/linux
buck                    script file interface

First edit your dosemu config.sys and autoexec.bat file to access the
cd-rom :

* CONFIG.SYS
  add the line :
        device=c:\XXX\CDROM.SYS
  where XXX is the directory path for CDROM.SYS

* AUTOEXEC.BAT
  add the line :
        c:\YYY\MSCDEX.EXE /D:MSCD0001 /l:E
  where YYY is the directory path for MSCDEX.EXE
  and   E: is the drive letter you want to assign to the cd-rom

Quit the dosemu (exitemu) and run it again. You should access the cd-rom
on E:


Copy the file BUCK4LIN.EXE (assuming that D: is the linux file system) :

COPY D:\TMP\BUCK\DOS\BUCK4LIN.EXE C:\
COPY D:\TMP\BUCK\DOS\BUCK.BAT C:\

Next edit BUCK.BAT file. You should have a line like :

BUCK4LIN E: E:\ICALL-S\ICALL D:\USR\LOCAL\DXNET\CALLBOOK
         |          |                    |
         |          |                    +-- Path of the callbook directory
         |          |                        of DxNet
         |          |
         |          +----------------------- Path of the ICALL.EXE program
         |
         +---------------------------------- CD-ROM drive letter

Then run the batch file BUCK. If you want to quit BUCK4LIN, just press
ALT-Q. Note that this program MUST be running if you want to access the
database.

---

Now switch to a linux console. Copy the script file /tmp/buck/linux/buck to
the directory ~/dxnet/callbook

For example : cp /tmp/buck/linux/buck /usr/local/dxnet/callbook

Edit the file ~/callbook/buck, and check the line DXNETDIR=/usr/local/dxnet
Change this path if the path used by dxnet is different. You normally don't
need to change anything else in this file.

Edit the file ~/dxnet/system/local.dat and add the following line to declare the
database (like for the DOS version) :

buck	buck	callbook	#Hamcall's BuckMaster callbook database
  |      |          |
  |      |          +-------- Tells DxNet that a callbook interface is running
  |      |
  |      +------------------- This is the name of the batch file in
  |                           ~/dxnet/callbook directory
  |
  +-------------------------- This is the command name (SH/BUCK will search
  	                          the database)
					

Then, you can know test the interface. Connect you to DxNet, and type e.g.
SH/BUCK F5MZN. You will get in my address !

---

If you want to set up your system to run the interface at the boot, you
can add the following line to your /etc/rc.d/rc.ax25 file :

        dos -C </dev/tty7> /dev/tty7 &

This will open a dosemu session on the virtual console number 7.

Then edit your dosemu AUTOEXEC.BAT file, and add the line

        C:\BUCK

at its end to run BUCK4LIN.EXE when you run dosemu.

---

You can contact me for any bug report via E-mail : <f5mzn@imaginet.fr>

73,
Olivier,
f5mzn.
