DXTEST.BAS
Original program by Clarke Greene K1JX
Amiga version by John Gager K7KB

[See bug report at end of this file.]

This ARC contains the Microsoft BASIC (tm) source code for the ARRL DX Test
log editing program listed in the "Contests" chapter of The ARRL Operating
Manual, Third Edition.  The program takes an ASCII log listing (as created by
you with your favorite word processor), and produces a log package suitable
for submission to the contest sponsor. Three separate files are produced:

    1. A LOG file - (identified by the filename extension ".LOG").  This file
       holds the actual log.  New multipliers (countries) are identified and
       counted, and duplicate contacts identified.

    2. A DUPE SHEET file - (identified by the filename extension ".DUP"). This
       file holds a dupe sheet as required by the contest sponsors.  This is a
       complete listing of all the  contacts made on a particular band, in
       alphabetical order.

    3. A SUMMARY file - (identified by the filename extension ".SUM"). This
       file holds a summary sheet for the band edited. Total valid QSOs,
       duplicate QSOs, total QSO points, and countries worked are listed as
       well as a complete breakdown of QSOs per country.
       
The file containing the log entries must be an ASCII file in the 
following format:

    TIME      CALLSIGN      RCV'D REPORT

At least one space must be between each field of each log entry, and each line
must be terminated by a carriage return. Only a changed digit in the time
field must be present; for example, if the contest begins at 1800Z and the
first contact is made at 1802Z and the second contact is made at 1805Z, then
only 5 need be entered in the time field. If the third contact is made at 
1812Z, then 12 should be entered in the time field. If the next contact is
made at 1812Z, then no number need be entered in the time field (however, be
sure to enter a space to indicate separation between fields). If no signal
report is entered as part of the received report, 59(9) (depending on the
mode) is assumed.

The three output files (.LOG, .DUP, and .SUM files) can be printed by using
the Amiga "TYPE" command.

Some reminders:

1. Be sure your log is in an ASCII format. Just about every word processor can
   operate in an ASCII or Non-Document mode - that should work fine.  As an
   alternative, you can use one of the many utilities available in the
   marketplace and in the public domain to convert your word processor output
   into an ASCII format.

2. If you enter the callsigns in your log in lowercase, they are automatically
   converted to uppercase for the final .LOG file. 

3. Since you probably will copy this program onto a working disc (rather than
   suffer the usual consequences of Mr. Murphy), remember that DXTEST needs
   access to DXPREFIX.LIB.  DXPREFIX.LIB must be on the same disc as this
   program, and in the root or main directory of your disk.

4. Each band requires a separate entry file. The output files will be named as
   the original filname plus the appropriate extension (for example DXCW15.LOG,
   DXCW15.DUP, and DXCW15.SUM would be produced from the log entry file
   DXCW15.) As a consequence of this, any file with the same name will be 
   overwritten when DXTEST is run.  To avoid any deletion of valid files, use
   unique names for the files used on each band, and don't use the extensions
   .LOG, .DUP, or .SUM.

Special notes for the Amiga version
-----------------------------------

This ARC contains 4 files:

DXTEST.BAS  -  AmigaBasic program

DXTEST.DOC  -  This documentation file

DXTEST.DAT  -  A small example log file used to show example log entrys and
               to test the DXTEST.BAS program.

DXPREFIX.LIB - A listing of DX prefixes and countries used by this program.
   
  To give credit where credit is due, this program is by Clarke Greene K1JX.
The only thing I've done is go through his program and make it more agreeable
with AmigaBasic, and add a few minor features along the way. I really haven't
had a chance to test this program throughly since I don't get into contesting
very much, but I believe it is free of any major bugs. If you find any bugs
that I have missed, or have suggestions and comments about these programs,
please let me know.

  One thing you will notice about these programs is that they are slow!! For
example, I wrote a program that created a log using random prefixes from the
DXPREFIX.LIB file. It created a log of 1439 entries, and the IARULOG.BAS
program took about 1 1/2 hours to process the log! So patience is certainly a
virtue when processing a large log. Although it would have been nice to
compile these programs since I have the Absoft basic compiler, after I ran
the compiled version of IARULOG on the same fake log, it took over 3 hours
to process it! In some defense of Absoft, the MiniMuf program I wrote runs
considerably faster compiled.

73,

John Gager K7KB
CompuServe ID 71336,624

Bug report:

1. Expanded DXPREFIX.LIB memory allocation for bigger library.

Amiga features include:

 * Automatic capitalizing of entries read from log source file.

 * Automatic capitalizing of keyboard entries from program prompts.

 * Expanded error checking for improper data read both from the log
   source file and the keyboard.