Welcome to the CallBook Server (CBS) Release 1.00!

This archive contains source and a.out executables. To get up and running,
you should not need to compile, just edit the makefile, and 'make install'


----------------------------------------------------------------------------

There is a mailing list for CBS support and questions, cbs-topics@lantz.com.
To join this mailing list, send a mail message to 'listserv@lantz.com' and in
the data of the message include a single line

	SUBSCRIBE emailaddress cbs-topics

where "emailaddress" is an optional name of a complete email address that
you wish the subscription sent. The "emailaddress" is only necessary if you
wish the subscription to go to an address other than the one you are sending
the email subscription request from. Example:

	SUBSCRIBE cbs-stuff@ko4ks.ampr.org cbs-topics


----------------------------------------------------------------------------


REQUIREMENTS:

	To use:
		bash

		LOTS of disk space! About 92 Meg, currently...... More
		initially, while building the database.

		'expect' required for automated retrieval of FTP files.

		'unzip' for unzipping FCC files, stored with pkzip.


	To compile:

		gcc and gdbm



BUILDING THE DATABASE:

	0) Plan your installation time wisely. The master files are updated
	   on Mondays at around noon. Then there is a daily file for each
	   day of the week (except Sunday). You will be retrieving about
	   35 Meg of data, and depending on your Internet connection speed
	   this COULD take a while.

	   Also, once you GET the data, it will take QUITE A WHILE for the
	   initial database to be built. On a FAST 486/DX2/80 it took
	   about 23 hours.

	1) Anonymous FTP to ftp.fcc.gov and cd to '/pub/XFS_AlphaTest/amateur'

	2) You'll see a directory resembling this:

	-rw-r--r--  1 root     1005          161 Jun 16 12:36 .cache
	-rw-r--r--  1 1005     1005          665 Jun 12 01:31 admin.zip
	-rw-r--r--  1 1005     1005        55872 Jun 12 01:31 alien.zip
	-rw-r--r--  1 1005     1005     30685409 Jun 12 01:31 appl.zip
	-rw-r--r--  1 1005     1005         8975 Jun 12 01:31 codes.zip
	-rw-r--r--  1 1005     1005        51521 Jun 12 01:31 crm.zip
	-rw-r--r--  1 1005     1005        10050 Jun  9 23:47 fri.zip
	-rw-r--r--  1 root     1005          426 Jun 16 15:41 index.html
	-rw-r--r--  1 1005     1005      2444768 Jun 12 01:31 indiv.zip
	-rw-r--r--  1 root     1005          127 Jun 16 15:41 menu
	-rw-r--r--  1 1005     1005        18607 Jun 12 23:47 mon.zip
	-rw-r--r--  1 1005     1005         7151 May 22 07:17 readme.txt
	-rw-r--r--  1 1005     1005         1549 Jun 10 23:47 sat.zip
	-rw-r--r--  1 1005     1005         1949 Jun 11 23:47 sun.zip
	-rw-r--r--  1 1005     1005        29996 Jun 15 23:47 thu.zip
	-rw-r--r--  1 1005     1005        16957 Jun 13 23:47 tue.zip
	-rw-r--r--  1 1005     1005        23250 Jun 14 23:47 wed.zip
	-rw-r--r--  1 root     1005         1382 Jun 16 15:41 wp.html

	3) Get the current master database files of 'appl.zip' and 'indiv.zip'

	4) Copy the files to /usr/callbook, 'cd' to that directory, and
	   unzip these two files.

	5) Now comes the LONGEST portion, execute 'convert_appl'. This will
	   convert the 'appl.dat' file, and build the database.

	6) A New day ;-) Now for another long one (though not QUITE as bad),
	   execute 'convert_indiv'. This will process the 'indiv.dat' file,
	   and add that information (callsign class, previous call, etc.)
	   to the database.

	7) You now have a complete database, current as of the last Monday.
	   You can save or delete the 'appl.dat' and 'indiv.dat' files.

	8) Now you need to catch up on the daily updates since Monday noon.
	   FTP the needed files into /usr/callbook, and run:

		catchup xxxx

	   where 'xxxx' is the day name (i.e. Mon) of the zips, in order.
	   This will unzip the needed files, delete the zip file, and
	   run 'convert_appl' and 'convert_indiv' on the files.

	   The 'catchup' script MAY need editing for pathlists.



SETTING UP FOR DAILY UPDATES:

You can automate this, or do it manually until you are sure it will work.
To automate it, add an entry into root's crontab, at some time AFTER midnight
to make sure that the FCC updates have completed.

The script 'update' MAY need editing for pathlists.

This calls an 'expect' script named, 'ftp-fcc-data' which retrieves the
daily zip file. YOU MUST FIRST set-up the 'nextday' file, so the script
will know which zip file it is retrieving. To do this, do:

	echo -n xxx >/usr/callbook/nextday

where 'xxx' is the day of the file you want NEXT retrieved. For instance,
if you get this all setup over the weekend, and want to start with Monday,
the make 'xxx' "mon". USE LOWER CASE, three character names. If you have
any doubt what MIGHT be valid, see the end of the 'daily-update' script.

Then, just do a '/usr/callbook/daily-update' and off it will go......


OTHER CBS PROGRAMS:

Also included are:

	cbsmail:  a mail filter program to allow callsign retrieval via email

	cbsd:     a daemon program, for use with 'inetd', to allow remote
		  retrieval interactively or from a xNOS callserver client.

	callbook: the actual program that does interactive and non-interactive
		  callsign lookup.

	analysis: allows analysis of current day's appl.dat file.


IS THAT ALL:

	YEP! The docs are still very scant, so subscribe to the mailing
	list, and ask your questions there.........


------------------------------------------------------------------------


The Federal Communications Commission is now offering the complete
amateur service database on the Internet, via the FCC's file
transfer protocol (ftp) site, and TPP allows you to use this data to
maintain an up-to-date callsign server.

The FCC's master database will be updated every Monday by noon (Eastern Time),
with daily updates at about 23:50 (Eastern Time) Monday through Saturday.

  
TPP currently ONLY supports lookup by callsign.

TPP squeezes the data, to minimum the space needed. Here is comparison to the
non-squeezed data:

	Original non-squeezed data:

		692,101 records		152,205,312 file size

	Squeezed data:

		692,101 records		 90,562,241 file size
					 61,643,071 saved
					         85 bytes saved per entry


----------------------------------------------------------------------
  

Information may be retrieved using the following procedure:
 
Access:  anonymous ftp.fcc.gov 
Directory:  /pub/XFS_AlphaTest/amateur
Documentation:  readme.txt
 
The FCC's Consumer Staff in Gettysburg, Pennsylvania, can answer
questions at 800-322-1117 or 717-337-1212.

-----------------------------------------------------------------------


The Amateur data base as found on the Internet consists of two portions,
The entire Amateur data base (currently delivered as one file for each
table in the data base) that is refreshed each week 
by noon Monday and daily transaction files.  The transaction files are 
named for the day of the week that the transactions take place (mon.zip, 
tue.zip, wed.zip. etc.) and are put on the internet nightly.  Saturday
has been included to fully automate the data transference, although it the
sat.zip file will be mostly empty.
 
The transaction files will remain for a week, at which time they will be
overlayed.

ALL ZIPPED FILES MAINTAIN THIER ORIGINAL NAME, and today's files will
overlay yesterday's  files!

Approximate file sizes are:

                                 Zipped           Unzipped

           Full data base       32 Mbytes         144 Mbytes
           Transactions         4-10 Kbytes       6-50 Kbytes


All files are zipped and each line of data ends in a carriage return/line 
feed.  It has been reported that downloading the full data base took 7 hours
using a 14.4 Mbyte modem and cost under $20 using Prodigy. 



