Hacker Chronicles 2

home *** CD-ROM | disk | FTP | other *** search

/ Hacker Chronicles 2 / HACKER2.BIN / 773.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: