home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
HAM Radio 1
/
HamRadio.cdr
/
misc
/
pc-hamd3
/
pc-ham.doc
< prev
next >
Wrap
Text File
|
1986-04-04
|
61KB
|
1,465 lines
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 1
PC-HAM
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5
(C) Copyright 1985, 1986 - All Rights Reserved
By Joe Kasser G3ZCZ
POB 3419,
Silver Spring,
Md., 20901.
PC-HAM is a set of DATA BASE Amateur Radio programs for the use of
a microcomputer in Amateur Radio. The BASIC language programs are
either described in or based on programs described in the book,
SOFTWARE FOR AMATEUR RADIO written by Joe Kasser, G3ZCZ, published
by TAB Books (Number 1560), Blue Ridge Summit, Pa., 17214. The
DBASE 2 programs perform database operations on logbook
information.
PC-HAM is written and supported by Joe Kasser, G3ZCZ.
The program is distributed as a Shareware product.
You may freely copy and share the product with your
friends, associates and other radio hams. If you
decide to use the product, you are asked to become
a registered user by sending a QSL card and a
contribution to the author (suggested amount of
$36.50 (ie. half of 73) or equivalent in foreign
currency (See registration form below).
The contribution covers the cost of distribution of
the updated disk, and supports the continual
development of "Software for Amateur Radio". Upon
receipt of your contribution, you will receive one
free update disk ), mail (electronic and regular)
support, and notice of further releases. The
update disk will contain any new versions of the
software on this disk (converted programs from
Northstar BASIC to IBM) plus new software,
accompanying the series of articles currently being
written on the applications of data processing
concepts of microcomputers to amateur radio.
Under no circumstances may this product be sold or
distributed with another product without the
express written permission of Joe Kasser, G3ZCZ.
Joe Kasser, G3ZCZ will only support unmodifed
copies of this software. You comments and
sugestions for changes are however welcome. If you
are the first to suggest a change that is
implemented, you will be sent a complimentary copy
of the disk with the change incorporated.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 2
TABLE OF CONTENTS
1.0 INTRODUCTION
2.0 COMPUTER AIDED DESIGN
2MFUND.BAS
FREQPLOT.BAS
OSCFREQ.BAS
OSCPLOT.BAS
OSCUPLK.BAS
UPLINK.BAS
RESISTOR.BAS
3.0 LOGGING
FILES.2
HELP.2
LOG.2
LOGARNGE.2
LOGDEL.2
LOGEDIT.2
LOGENTER.2
LOGLIB.2
LOGMERGE.2
LOGPRINT. 2
LOGRENAM.2
LOGRESTR.2
LOGSEND.2
NEWLOG.2
QSLPRINT.2
STNINFO.2
SYSTEM.2
4.0 AWARDS
4.1 WAS Package
WASENTER.BAS
WASGEN.BAS
WASPRINT.BAS
4.2 DXCC Pack
DXCCDEL.BAS
DXCCEDIT.BAS
DXCCGEN.BAS
DXCCREAD.BAS
DXCCSORT.BAS
W3.DX
5.0 CONTESTS
CKLSTGEN.2
CKLSTRD.2
CONTST16.2
LOGFUDGE.2
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 3
MBCKLSTG.2
SWPSTAKS.2
6.0 SIMULATIONS AND MODELLING
CQSS.BAS
7.0 ANTENNA POSITION AND POINTING
QTHANY.2
QTHDATA.TXT
QTHFUDGE.2
QTHGEN.2
QTHLIB.2
QTHPOINT.2
QTHSORT.2
8.0 SATELLITES
PHASE1.2
PHASE2.2
9.0 CONTEST LOGGING PACKAGE
CONTEST.BAS
LOGCONV.BAS
FIELD85.RUN
FIELD85.LOG
FIELD85.CHK
FIELD85.DBF
FIELD85.NDX
10.0 DBASE2 DATA BASE LOGBOOK PACKAGE
Installation
DXCC
Customisation
Calls of Reciprocal Operators
LOGBOOK.PRG
DXCCCLR.PRG
DXCCPRIN.PRG
LOG2DBF.PRG
LOGADD.PRG
LOGCALL.PRG
LOGDXCC.PRG
LOGPRINT.PRG
LOGQSL.PRG
LOGSRCH.PRG
LOGSTAT.PRG
UPDATE.PRG
DATABASE SRUCTURES
BLANKLOG.DBF
DXCC.DBF
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 4
1.0 INTRODUCTION
This disk contains a number of sets of programs for using your
microcomputer in your hobby of Amateur Radio. Each family is
described in detail in the relevant sections below.
The programs have grown up around the applications discussed in
the books and magazine articles. Some of the programs are
released at this time to provide copies in source code of the
package written for the Northstar Horizon. This dialect of
BASIC is somewhat different to the dialect spoken on the PC. It
is expected that by the next release of this software, the
programs will have been converted. On the other hand, if you
use the DBASE2 logging package, you will never use the BASIC
version again, and in my opinion, when a logging package can be
written in DBASE2 there is no need to ever write one in BASIC.
The modules of the DBASE2 logging package provide one of the few
examples of software written in DBASE2 readily available in the
PC field.
2.0 COMPUTER AIDED DESIGN
These are a set of programs showing examples of the use of a
computer for design. Descriptions of what each program is
supposed to do are contained in my book, SOFTWARE FOR AMATEUR
RADIO published by TAB Books (Number 1560), Blue Ridge Summit,
Pa., 17214.
2MFUND.BAS Calculates the fundamental frequencies for crystals
at 8Mhz, 12MHz and 18MHz for the USA 144MHz FM
channel transmit frequencies, and the corresponding
45MHZ receive frequency. Book, listing, Figure
1.10.
FREQPLOT.BAS Calculates the oscillator injection frequencies for
an HF amateur band transceiver having a 9MHZ IF.
Book, listing, Figure 1.5.
OSCFREQ.BAS Calculates the resonant frequency of a tuned
circuit for a range of capacitance values, given a
constant value of inductance (input by the user).
Book, listing, Figure 1.3.
OSCPLOT.BAS Calculates resonant frequencies of an oscillator.
Book, listing, Figure 1.8.
OSCUPLK.BAS Calculates crystal fundamental frequencies (at 8,
12 and 18MHZ) that produce signals in the OSCAR
Mode A uplink range of 145.85 to 146MHz. Book,
listing, Figure 1.13.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 5
UPLINK.BAS Calculates crystal fundamental frequencies (at 8,
12 and 18MHZ) that produce signals in the OSCAR
Mode B uplink range of 145.85 to 146MHz. Book,
listing, Figure 1.14.
RESISTOR.BAS Calculates the currents through a range of resis-
tances at various circuit input voltages. Book,
listing, Figure 1.2.
3.0 LOGGING
This is a set of programs written in Northstar BASIC for logging
contacts into a floppy disk data file. Northstar BASIC uses a
type '2' for programs by convention. Each program is described
in detail in chapter 2 of my book SOFTWARE FOR AMATEUR RADIO
published by TAB Books (Number 1560), Blue Ridge Summit, Pa.,
17214. The programs are given here on this version of the disk
for the sake of completeness. The package will be converted to
PC-BASIC in the next release of this disk. In the meantime,
feel free to do your own conversions, or purchase a used
NORTHSTAR system and run the package of programs on it.
FILES.2 Lists log or data files on the selected floppy
disk. Book, listing, Figure 2.4.
HELP.2 Lists programs or commands on the selected floppy
disk. Book, listing, Figure 2.5.
LOG.2 Main program that starts the package. Book,
listing, Figure 2.6.
LOGARNGE.2 This program is not in the book. It rearranges a
contest log, numbers the entries and readies the
log for transmission to a second computer running
soft sectored CP/M or PC-DOS (by the LOGSEND
program). This program is the first stage in
converting the logs to a DBASE2 format on a more
modern machine.
LOGDEL.2 Deletes a log file from the disk. Book, listing,
Figure 2.10.
LOGEDIT.2 Allows the user to edit the contents of a log data
file (For example, add QSL information as cards are
received). Book, listing, Figure 2.11.
LOGENTER.2 Allows new entries to be made into the log. Book,
listing, Figure 2.12.
LOGLIB.2 Library of subroutines used in most of the other
programs in the package. Book, listing, Figure
2.7.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 6
LOGMERGE.2 Joins a second log file to the end of the first.
Book, listing, Figure 2.13.
LOGPRINT.2 Prints the contents of a log file according to the
criteria supplied by the user. Book, listing,
Figure 2.14.
LOGRENAM.2 Renames a log file. Book, listing, Figure 2.15.
LOGRESTR.2 Restores a crashed log file. Book, listing, Figure
2.16.
LOGSEND.2 This program is not in the book. It transmits a
contest log that has been arranged by the LOGARNGE
program from the serial port of the Northstar
computer. This program was written to transfer
logs between the Northstar system and an OSBORNE 1
microcomputer. After 400 lines, it stops so that
the files on the OSBORNE can closed out and a new
one opened for the ballance of the original file.
This program is the second stage in converting the
logs to a DBASE2 format on a more modern machine.
In this instance the logs were further converted to
PC format diskettes for use by the remainder of the
package.
NEWLOG.2 Creates a new formatted log data file. Book,
listing, Figure 2.9.
QSLPRINT.2 Prints labels containing the QSO information to be
stuck on QSL cards. Book, listing, Figure 2.18.
STNINFO.2 File which contains the custom station data. Book,
listing, Figure 2.8.
SYSTEM.2 Command processing program to load desired program
and run it. Book, listing, Figure 2.3.
4.0 AWARDS
This section contains two stes of programs written for storing
Award data on disk files. Others will be added in future
releases.
4.1 WAS Package
This is a set of programs converted from the versions
written in Northstar BASIC described in detail in
chapter 3 of the book.
WASENTER.BAS Enters WAS data into a WAS database.
Converted from book listing, Figure 3.2.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 7
WASGEN.BAS Generates a WAS database. Converted from
book listing, Figure 3.1. RUN THIS ONE
FIRST.
WASPRINT.BAS Prints/displays a WAS database acoording to
criteria set by the operator. Converted
from book listing, 3.3.
4.2 DXCC Package
DXCCDEL.BAS This program is not in the book. It
deletes a prefix from a DXCC database.
DXCCEDIT.BAS This program is also not in the book. It
allows the user to edit the contents of a
prefix entry in a DXCC database.
DXCCGEN.BAS Puts new entries into a DXCC database.
Book, listing, Figure 3.5.
DXCCREAD.BAS Prints/displays the DXCC database as
selected by the user. Book, listing,
Figure 3.7.
DXCCSORT.BAS Sorts the DXCC database into prefix order.
Book, listing, Figure 3.9.
W3.DX This is a sample DXCC data file as used by
the DXCC package. Book, listing, Figure
3.6.
All programs in this section in this release contain
minimal error checking.
5.0 CONTESTS
This is a set of programs written in Northstar BASIC for contest
operation in which the check list is stored in RAM and the log
data is written out to disk files. Each program is described in
detail in chapter 4 of the book. The programs are given here on
this version of the disk for the sake of completeness. The
package will be converted to PC-BASIC in the next release of
this disk (CONTEST16.2 is alrady converted and is on the disk,
[see CONTEST.BAS]).
CKLSTGEN.2 Generates a check list file in alphanumeric order
from a log file. This prorogram is to be used after
a contest. Book, listing, Figure 4.8.
CKLSTRD.2 Prints/displays a checklist file. Book, listing,
Figure 4.9.
CONTST16.2 General purpose contest operating program. Updated
version of Book, listing, Figure 4.1/4.11.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 8
LOGFUDGE.2 Cleans up a contest log file. Book, listing,
Figure 4.7.
MBCKLSTG.2 Multiband check list generator program. Book,
listing, Figure 4.12.
SWPSTAKS.2 Contest program optimised for the ARRL Sweepstakes
Contest. It shows which sections still remain to
be worked on screen in real time time. Book,
listing, Figure 4.4 (Sweepstakes contest program).
6.0 SIMULATIONS AND MODELLING
CQSS.BAS This is a game (simulation). It is a simulation of
the ARRL Sweepstakes contest for a station located
in Maryland (G3ZCZ/W3). It incorporates a
propagation model so that the contacts on any band
at any time of the day will be relatively
realistic. The premise behind the simulation and
the program itself are described in chapter 5 of
the book. This version is a later version of the
listing given in Book, listing, Figure 5-28. If
you don't have a copy of the book, load the
program, set the CAPS LOCK key to CAPS, and follow
the instructions to initialise the game.
The initialisation part of the program computes the
details for 1000 other simulated calls before
starting the game. It is done in this manner for
two reasons, the first is that this way all the
calls are different each time the game is played,
and secondly the program was first written in a non
floppy disk enviroment in which the calls of the
simulated stations could not be computed once and
then downloaded each time the game was to be
played.
Once the game starts, your choice of things to do
is as follows
BAND CHANGE BANDS
BREAK TAKE A BREAK (TIMEOUT)
CALL CALL OTHER STATION
CHECK CHECK TO SEE IF WORKED
CQ CALL CQ
DATA DETERMINE WHICH DATA ARE MISSING FROM
REPORT
DUPLICATE TELL OTHER STATION THAT YOU HAVE WORKED
BEFORE
HELP RECEIVE SUMMARY OF INSTRUCTIONS
LOG ENTER CONTACT IN LOG
QRT GIVE UP AND SWITCH OFF EQUIPMENT
QSL CONFIRM RECEPTION OF CONTEST DATA
REPEAT REQUEST REPEAT OF OTHER STATION'S DATA
SECTION LIST SECTIONS STILL NEEDED
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 9
SEND SEND YOUR DATA TO OTHER STATION
STATUS SEE HOW WELL YOU ARE DOING
TIME LOOK AT TIME OF DAY
TUNE TUNE ACROSS BAND
WORKED LIST OF STATIONS WORKED (UNSORTED)
You may type the first two letters for
any choice except for SECTION (which
needs 3). 'SE' is assumed to be "SEND".
7.0 ANTENNA POSITION AND POINTING
This is a set of programs written in Northstar BASIC for
calculating the position to point the antenna for various DX
locations. Each program is described in detail in chapter 6 of
the book. The programs are given here on this version of the
disk for the sake of completeness. The package will be
converted to PC-BASIC in the next release of this disk.
QTHANY.2 Prints pointing information for any QTH. The
program prompts for lattitude and logtitude
information first. Book, listing, Figure 6.6.
QTHDATA.TXT Sample listing of lattitude and logitude for
various cities world wide. Book, listing, Figure
6.7.
QTHFUDGE.2 Cleans up any errors in a QTHDATA file after the
QTHGEN program has been run. Book, listing,
Figure 6.12.
QTHGEN.2 Used for entering data into a table of latitudes
and longitudes. Book, listing, Figure 6.8.
QTHLIB.2 Computing subroutines used by other programs.
Book, listing, Figure 6.2.
QTHPOINT.2 Positions antenna in calculated direction. Book,
listing, Figure 6.10.
QTHSORT.2 Sorts a QTHDATA file. Book, listing, Figure 6.9.
8.0 SATELLITES
This is a set of programs written in Northstar BASIC for
calculating the position of, and tracking the OSCAR
communications satellites. Each program is described in detail
in chapter 7 of the book. The programs are given here on this
version of the disk for the sake of completeness. The package
will be replaced by a version written in PC-BASIC in the next
release of this disk.
PHASE1.2 Computes equatorial crossing information (Reference
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 10
orbits) for OSCAR Phase 2 satellites. Book,
listing, Figure 7.3.
PHASE2.2 Computes antenna pointing information for working
through OSCAR Phase 2 satellites. Book, listing,
Figure 7.9.
9.0 CONTEST LOGGING PACKAGE
Contests are a natural application of computers to amateur
radio. After all the purpose of a contest can be stated as
gathering data (the calls and reports of stations worked) in
such a way as to avoid duplicates. When working contests in a
manual (non computer) mode, if you desire to avoid duplicates,
you usually have to keep two sets of records for each contact.
The log entry has to be made, and a duplicate sheet of some kind
has to be kept to give real time notice of potential duplicate
contacts.
The use of a good contest logging program simplifies the paper
work during and after a contest and allows the operator to
concentrate on working stations. During the contest, the
operator has only to perform the following tasks.
* Enter the call sign of the station worked.
* Enter the report received.
* Tell the computer to log the contact.
The computer takes care of the rest of the data handling. The
computer thus performs the following tasks.
* Keeps a check list in memory to notify the operator if a
contact has been made on the same (duplicate) or an other
band.
* Updates date and time information automatically.
* Stores the contact data in a floppy disk file.
CONTEST.BAS The contest logging program gives the operator the
following choices.
C Enter the Call of the station to be or being
worked. When the call is entered, the
computer will perform a check to see if the
call has already been worked and if so on
what band. If the call has been worked on
the band in use at that time it will also
display the word DUPLICATE and BEEP an
audible alarm. The beep is a must at 0330
hrs.
R Enter the Report received into the log.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 11
L Enter the QSO information into the Log
book/check list. The data is written into
the log file in ASCII format delimited with
commas. This makes it easy to modify with a
word processor and read into the program used
by the second computer. You may also list
the contents of the log file to the screen
under DOS using the "TYPE" command.
F This command is used to flag an erroneous log
entry. Since the log on disk is a sequential
file, and the log data is not double buffered
by the program, once an entry is written to
the log, it is gone. This command deletes
the call from the check list and puts a "/*"
entry into the logbook. You may use your
favourite word processor (in the non document
mode) to delete that entry and the previous
one from the logbook when the contest is
over.
Q Check the log entry data on the screen before
saving it in the log file. This command may
be used for example to verify that the
correct band data is set after changing
bands.
X Enter the signal report Xmitted to the other
station into the log.
/ This command is used to scan the contents of
the check list for prefixes. You use this
when you are sure that you have worked a
station but the computer tell you that you
haven't. You may also use it to check if a
prefix has been worked as a help in deciding
if you want to get into a pile up or pass it
by. NOTE however that the response is not
instantaneous. It takes a good few seconds
to scan the 4000 slots in the check list.
The computer will prompt you to enter a
prefix. If you want to look at all the calls
in the check list, enter an asterisk (*) as
the desired prefix and you will get a list of
every call in the check list in the order in
which they are hashed in the check list.
W Enter the Transmitter Power used in Watts
into the logbook.
M Enter the Mode used in the contest in the
log. You may enter anything, but the most
commonly used ones are SSB and CW.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 12
* This command terminates the program. It
saves the data associated with the last 12
contacts in a file with the ".CHK" extension
so that when the program is restarted, the
operator will not even notice that a break
occurred. The disk files are closed and any
previous log file present from the start of
the session is named as a backup file
? This command clears the screen dialog lines.
It is normally used rarely, only in the event
that the BASIC interpreter generates an error
message in response to a user input. The
typical one normally seen is "REDO FROM
START" which results from an alphabetical
response to the BAND interrogation, where
BASIC is looking for a number, not a string.
Once the contest is over, the log file must be
corrected using a word processor to delete any
fudged entries.
LOGCONV.BAS Serial numbers can be added to the comment space in
the log FILE AS GENERATED BY THE CONTEST.BAS
PROGRAM, and the report area adjusted accordingly.
This program reads each line of log information,
strips the report part from the comments and puts
it into the report space and adds the serial number
of the contact into the comments space. When the
program has done its job, the original log has been
renamed with a ".RUN" file extension while the
converted log data file has the extension ".LOG".
The CONTEST log file is now ready to be converted
to a DBASE format file for further processing.
First invoke the LOGBOOK package of DBASE2, then
create a blank log database.
The contest log is then appended to this database
log file using the LOG2DBF module.
The following sample files for the 1985 Field Day
contest are presented on the disk as an aid to
understanding the operation of the CONTEST package.
FIELD85.RUN As run log of contest.
FIELD85.LOG Log, ready for conversion to .DBF format.
FIELD85.CHK Last few entries in log.
FIELD85.DBF Log, in DBASE2 data base format.
FIELD85.NDX Index file for DBASE2 log database.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 13
10.0 DBASE2 DATA BASE LOGBOOK PACKAGE
This is a complete logging package written in DBASE2. It
presents a new concept in accessing the contents of a logbook in
real time to give you all sorts of information abount previous
contacts. This version of the package gives you the following
operational capability on your logbook data.
CAPABILITY MENU CHOICE
-----------------------------------**--------------
APPEND ENTRIES A
PRINT LOG INDEXED BY CALL SIGN C
UPDATE DXCC RECORDS D
HUNT FOR PREFIX/CALL IN LOG H
CHANGE LOG FILE L
CREATE NEW LOGBOOK DATABASE C
PRINT LOG PAGES P
UPDATE QSL STATUS Q
PRINT DXCC RECORDS R
SUMMARISE LOG S
TRANSFER DATA FROM CONTEST LOGS INTO LOG U
(Manual speedy data entry)
Append Contest log (.LOG) to LOG V
Change default drive X
Change operator callsign Z
QUIT LOGGING PACKAGE *
Installation
To bring up the package copy all the files on this disk
EXCEPT those with filetypes .2, .DX and .BAS to a disk
which has a copy of DBASE2 on it. Place that disk in the
default drive and invoke the package by entering the
command 'DBASE LOGBOOK '
Before you use it, some notes are in order.
DXCC
The package contains a module to scan the log and generate
a DXCC record file of countries worked and QSLed. In this
version of the software it requires that the DXCC database
be on drive B and be called DXCC.DBF.
Customisation
The logbook requires two things to be customised for
optimal use. In the LOGBOOK.PRG module, change the default
drive to the one you commonly use, and change the callsign
to your call. You do have the option to change them each
time you run the package, but it would be easier if you
didn't have to. This is a one time task and calls for the
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 14
use of your favourite word processor in its non-document
mode. The next release of the software will allow you to
change the default on line.
IF YOU HAVE ONE, PUT DBASE AND THE PRG MODULES ON A
RAMDISK, the program will run ever so much faster.
Calls of Reciprocal Operators
It is strongly recommended that you store the calls of
reciprocal operators with the area that they are operating
in as the prefix in front of the call rather than as the
suffix as is commonly done. Thus if you work G3ZCZ
operating in W3, store the call as W3/G3ZCZ not G3ZCZ/W3
which is what he calls it. In fact France and Germany
amongst others ask reciprocal operators to sign their calls
that way on the air. If you don't do this, you will find
that for example if you worked G3ZCZ/4X and he was the only
4X contact you have made, the DXCC module will assign him
to G rather than to 4X. In fact he might end up as your G
card for the DXCC.
The package contains a number of modules to allow you to
perform these operations. Each module is invoked by the
appropriate letter shown in the menu of the main module
LOGBOOK.PRG.
LOGBOOK.PRG The following tasks are performed by the main
module.
You may create a new logbook database file.
You may change the logbook database file.
You may change the default disk drive which
contains the prograsm modules. It is strongly
recommended that the program modules be placed on a
RAMDISK.
You may change the default call sign that is
printed at the top of each listing.
DXCCCLR.PRG This is a utility program that is not part of the
package in this version of the program. It creates
a blank DXCC database file. In DBASE2 this module
is invoked by first terminating the LOGBOOK program
with the * character, then in the interactive mode,
type 'DO DXCCCLR' (without the ' characters). It
assumes that there is a DXCC database on drive B
called 'dxcc'. It copies the prefix and country
information into a second dxcc database which it
calls 'blankdx' and puts it on drive B. You then
have to quit DBASE2, rename the existing DXCC.DBF
file to something else and then rename the
'blankdx.dbf' file as 'dxcc.dbf'.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 15
DXCCPRIN.PRG Performs 'PRINT DXCC RECORDS'
This module displays or prints the contents of a
dxcc database. You are given the choice of
printing the whole database, those countries
worked/qsled, or just those countries qsled. The
database is in alphanumeric prefix order, so it is
ready to be sent to the ARRL with the award
request, and is handy for having at the operating
position when monitoring the bands.
In this release of the software, the DXCC database
file is assumed to be on drive B and is assumed to
be called DXCC.
LOG2DBF.PRG Performs 'APPEND FROM LOG FORMAT TO DBF FORMAT'
It creates a database file (.DBF) of the contest
log using a blank log database file (BLANKLOG.DBF).
It copies the contact data from the log generated
by the CONTEST.BAS program into the new database
log. It then lets you append the contest log
database to the main station logbook database.
The main logbook database is then ready for the
next contest or any further data processing and
analysis desired.
Since the contest log database is saved as a stand
alone log file, even after its cointents have been
appended to the main log database, the module
allows you to index the contest log database so
that you can then display or print the call signs
in the contest in alphanumerical order to check for
duplicates, prefixes or what ever. You may even
get displays of contacts on different individual
bands by using variations of the DBASE command
'DISPLAY ALL FOR BAND = "xx" ' where xx is the band
you want displayed.
The module performs much of the same task as the
LOGCONV.BAS program. If you compare the two source
code listings, you will get an idea of string
handling in DBASE2 and BASIC.
LOGADD.PRG Performs 'APPEND ENTRIES'
This module allows you to enter contacts in the log
in the traditional sequential manner. It is the
module that is "on-line" while you are on the air.
As it is used whilst actually in contact with other
stations, or in monitoring the bands it has
additional features which are as follows.
L This is the basic working mode of the module.
You enter the QSO data into the spaces
provided on the screen. Once the contact
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 16
data is in the entry, you use the 'L' option
to log it to the disk.
H You can check the log to see if a station or
prefix has been worked before.
P You can display the last five contacts in the
logbook on the screen.
* Terminates the module.
LOGCALL.PRG Performs 'PRINT LOG INDEXED BY CALL SIGN'
This module prints the whole contents of the log in
the alphanumerical order of the call signs. It
should be used once in a while, probably after each
contest to give you a printed booklet you can refer
to during contacts when the computer is not
available.
LOGDXCC.PRG Performs 'UPDATE DXCC RECORDS'
This module automatically searches a logbook
database and updates the DXCC status of a DXCC
database file. In this release of the software,
the DXCC database file is assumed to be on drive B
and is assumed to be called DXCC, and the program
DOES NOT RECOGNISE SEPARATE BANDS OR MODES.
LOGPRINT.PRG Performs 'PRINT LOG PAGES`
This module prints log pages in the order in which
the contacts are made. You are prompted to enter
the first contact from which the list will be
printed as well as the page number. In this way
each time you only printout the new entries.
LOGQSL.PRG Performs 'UPDATE QSL STATUS'
This module allows you to update the QSL status of
each contact in the log. If you enter a prefix or
call sign, the computer will sequentially present
you with each contact in the log for that prefix or
call and allow you to change the QSL information.
If you don't want to change the information, just
type the ENTER key.
The module terminates when you enter a '*` as the
prefix.
LOGSRCH.PRG Performs 'HUNT FOR PREFIX/CALL IN LOG'
This module allows you to display previous contacts
with any station or prefix. If you enter 'G3' for
example, you will get a display of all contacts
with stations having the "G3" prefix. If you enter
'G3ZCZ' for example, you will get a display of all
the contacts with "G3ZCZ".
By entering the prefix for a particular country,
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 17
all contacts with that country (and more important
the QSL status for DXCC purposes) may be seen.
The module terminates when you enter a '*` as the
prefix.
LOGSTAT.PRG Performs 'SUMMARISE LOG'
This module does a statistical analysis of the
contents of the log. It sequentially checks each
entry and displays an ongoing summary of the
contacts arranged into the following categories.
TOTAL NUMBER OF CONTACTS
QSL CARDS SENT DIRECT
QSL CARDS SENT VIA BUREAU
QSL CARDS SENT VIA MANAGERS
QSL CARDS SENT
QSL CARDS RECEIVED
QSL CARDS OWED
SUMMARY OF ENTRIES BY BAND
10 METERS
15 METERS
20 METERS
40 METERS
80 METERS
160 METERS
2 METERS
OSCAR MODE A
OSCAR MODE B
OTHERS
REPORT BY MODES
SSB CONTACTS
CW CONTACTS
RTTY CONTACTS
FM CONTACTS
When the log has been processed it gives the option
of printing a summary.
UPDATE.PRG Allows you to enter (by hand) contact data from old
contest logs in a speedy manner to build the log
data base. After all, there is no point in using
this program if you don't have any data in the log.
The first entry should be made manually using the
APPEND command in an interactive manner to set the
date, mode and power information. The LOGBOOK
program is then invoked by the 'DO LOGBBOK'
statement. Enter the logbook and then choose the
'U' option. Enter the time and call data in the
relevant spaces, then enter the whole report
received in the comments area, (If you are updating
an SSB contest, leave a space between the report
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 18
any any further data. IE., use '59 100' rather
than '59100'), the computer will take care of the
reformatting later. After the contact data for
each QSO has been input, the program prompts for a
decision. It gives the operator the choice of three
things to do as follows;
L Log the entry into the database
B Change the band information.
* Terminate the program
When the program is terminated, the computer
prompts the user asking if the last entry was
the last entry in the whole log. If it was,
the module formats the log by moving the
first three characters in the comments to the
"report received" column. You are also asked
if you want the contacts numbered. If you
do, the contacts will be numbered
sequentially and that number placed in the
comments column. The last operation
performed is that the log is indexed so that
the regular commands of the package will work
on it.
It must be repeated that this program is designed
for rapid entry of old contest logs into the
database, logs in which the only differences
between one entry and the next are the time,
callsign and reports with the occasional change of
band. Any other data must be set or changed using
DBASE features.
BY THE WAY, THIS MODULE IS GOOD FOR CHECKING A
CONTEST (OPERATED AS NON COMPUTER ASSISTED) FOR
DUPES AFTER THE EVENT. IF THE CALL AND BAND
INFORMATION FROM THE LOGS ARE ENTERED INTO THE
DATABASE USING THIS MODULE, THE COMPUTER CAN THEN
BE USED TO SORT THE CALLS AND FIND DUPES OR
MULTIPLE BAND CONTACTS, TELL YOU HOW MANY COUNTRIES
YOU WORKED, ETC. DO YOU KNOW IF YOU WORKED THE
SAME STATION ON 5 BANDS? (DO YOU EVEN CARE?)
DATABASE SRUCTURES
The program package uses two data bases.
The structure of the log data base is as follows.
BLANKLOG.DBF This is a blank logbook data with the following
structure.
Fld Name Type Width Comment
001 DATE C 008 Date in format YY/MM/DD
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 19
002 TIME C 004 Time in format HHMM
003 BAND C 003 Band eg 10, 20, 40
004 CALL C 010 Call sign
005 RX C 003 Signal report received
006 TX C 003 Signal report
transmitted
007 MODE C 004 Mode of QSO, eg SSB,FM.
008 POWER C 004 Transmitter power
009 QSLSENT C 001 QSL sent info.
eg B (bureau)
010 QSLRX C 001 QSL rx info.
eg R (received)
011 COMMENTS C 010 comments and notes.
DXCC.DBF This is a sample DXCC database with the following
structure.
Number of records: 00271
Date of last update: 09/28/85
Primary use database
Fld Name Type Width Comments
001 PX C 004 Prefix for DXCC
002 PX1 C 004 Alternate prefix
003 COUNTRY C 010
004 DCALL C 010
005 DDATE C 008
006 DTIME C 004
007 BAND C 003
008 DMODE C 004
009 DSTATE C 001 QSL status
** Total ** 00049
The sample file is provided so that you can display
it and print it. A utility is provided to create
new DXCC database files by copying the
prefix/country information to a new blank file.
Two possible prefixes are provided for each
country. This module has picked the most common
ones. If you have worked a different one, edit the
database to include it. For example, the two
prexies for the PHILIPINES are DU and DX. If you
have worked neither of these but have worked a DV
prefix, change the DX to DV and the DXCC status of
the Philipines will be taken care of. In a like
manner, new prefixes can be added by the APPEND
command built into DBASE2. The database can then
be sorted on "prefix" to a new version of DXCC.DBF.
11.0 Shareware Software
PC-HAM is distributed with a marketing approach called
Shareware. Shareware, is a method of distributing quality
software at a low price.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 20
Anyone can receive a distribution copy of the product from the
PC-SIG library or from any source whatsoever. You may then use
and review the product to determine if you'd like to continue
using it. If you decide to use it, you are encouraged to become
a registered user. Whatever your decision, you may still freely
use, copy and share the product with your friends and associates
and other amateur radio operators (hams).
This marketing concept saves everyone money because by having
users distribute and promote the product, users deal directly
with the author, saving the costs of advertising, fancy
packaging as well as distributors fees etc. These savings are
then passed on to you. The contribution is mainly used to pay
for production, copying charges AND to support the further
development of PC-HAM. The next version of PC-HAM depends on
the support of its users.
After using the product, please register for a contribution of
$36.50 (or equivalent in any currency). Registration provides
the following benefits:
Receive an UPDATED copy of PC-HAM with your own registration
number.
You will be included in our mailing list so that you may
receive new product announcements.
Receive further future releases of PC-HAM at a significant
discount.
You may register your copy of PC-HAM by completing the
accompanying registration form and mailing it to one of the
addresses listed below.
Program License Agreement
YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS
BEFORE USING THE PRODUCT. USING THE PRODUCT INDICATES YOUR
ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE
WITH THEM, YOU SHOULD PROMPTLY RETURN THE PACKAGE.
LICENSE
A limited license is granted to any user of the program to
freely copy and distribute the product on the following
conditions:
YOU MAY:
Use the program on any microcomputer on which this
package was designed to operate.
Freely copy and share unmodified copies of the product
with your associates. This includes putting the
software on a BBS.
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 21
YOU MAY NOT:
Sell the product for a fee and/or distribute the
product along with other products without express
written permission.
Provide the use of the software in a computer service
business, network, timesharing, interactive cable
television link, without express written permission.
Grant sublicenses, leases, or other rights in the
software to others.
Modify or remove the Copyright notice from the
program, diskette or its manual.
TERMS and CONDITIONS
The license is effective until terminated. You may terminate it
at any time by destroying the diskette, and notifying Joe
Kasser, G3ZCZ that you have done so.
LIMITED WARRANTY
THE PROGRAM IS PROVIDED FOR HOBBY USE "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED. THE ENTIRE RISK AS TO
QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE ENTIRE COST OF ALL
NECESSARY SERVICING, REPAIR OR CORRECTION. SOME STATES DO NOT
ALLOW THE EXCLUSION OF IMPLIED WARRANTIES SO THE ABOVE EXCLUSION
MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL
RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE
TO STATE.
Joe Kasser, G3ZCZ warrants that the original diskette in which
the PC-HAM program package is distributed is furnished to be
free from defects in the material and workmanship under normal
use for a period of thirty (30) days from the date of delivery
to you as evidenced by a copy of your receipt. The defective
diskette must be returned to Joe Kasser, G3ZCZ for this warranty
to be effected.
IN THE EVENT THAT THE WARRANTY IS INVOKED, you are entited to
EITHER the replacement of the diskette if you have met the
conditions as described under "LIMITED WARRANTY" OR a full
refund if Joe Kasser, G3ZCZ is unable to deliver a diskette free
from defects in materials or workmanship.
IN NO EVENT WILL JOE KASSER G3ZCZ BE LIABLE TO YOU FOR ANY
DAMAGES INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE SUCH PROGRAM.
SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF
LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 22
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.
YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT AND UNDERSTAND
IT AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS.
================================================================
REGISTRATION FORM
Send ____ Copies of Registered PC-HAM at $36.50/ea ____.__(73/2)
TOTAL ____.__
=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
Mail (Together with a QSL card) To:
Joe Kasser G3ZCZ POB 3419, Silver Spring, Md., 20901.
On the other hand since I am on a long term assignment much of
the time that involves travel, the mailbox may not be emptied
for two months at a time, you may get a faster reply if you
register at:
Joe Kasser G3ZCZ Ramot 9/6, Jerusalem, Israel.
Name:_____________________________________________CALL__________
Address:________________________________________________________
City:__________________________ State:_____ ZIP _______________
Telephone:(_____) _____-_______
PC-HAM Version:__________
Registration Number on your current copy:__(SIG)_________________
Comments:
Number on your current copy:__(SIG)_________________
Comments: