home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / dx / cqwlog / cqwwlog.doc < prev    next >
Encoding:
INI File  |  1988-03-06  |  6.3 KB  |  143 lines
  1. [See bug report at end of this file.]
  2.  
  3. This disc contains the Microsoft BASIC (tm) source code for 
  4. the CQ World Wide DX Contest log editing program listed in the 
  5. "Contests" chapter of The ARRL Operating Manual, Third Edition.  
  6. The program takes an ASCII log listing (as created by you with 
  7. your favorite word processor), and produces a log package 
  8. suitable for submission to the contest sponsor.  Three separate 
  9. files are produced:
  10.  
  11.     1. A LOG file - (identified by the filename extension 
  12.        ".LOG").  This file holds the actual log.  New multipliers 
  13.        are identified and counted, QSO point value noted, and 
  14.        duplicate contacts identified.
  15.  
  16.     2. A DUPE SHEET file - (identified by the filename extension 
  17.        ".DUP").  This file holds a dupe sheet as required by the 
  18.        contest sponsors.  This is a complete listing of all the 
  19.        contacts made on a particular band, in alphabetical order.
  20.  
  21.     3. A SUMMARY file - (identified by the filename extension 
  22.        ".SUM").  This file holds a summary sheet for the band 
  23.        edited.  Total valid QSOs, duplicate QSOs, total QSO 
  24.        points, Countries worked, and Zones worked are listed as 
  25.        well as a complete breakdown of QSOs per country and QSOs 
  26.        per zone.
  27.        
  28. In addition to the program listing, I've also included a compiled 
  29. executable version of the program.  The executable version (same 
  30. program name but with the suffix '.EXE') runs 10 to 20 times 
  31. faster than the usual interpreted version, so you'll probably 
  32. prefer to use it rather the .BAS version.  The executable program 
  33. is set up to run on any computer even vaguely compatible with the 
  34. IBM-PC.  If you are able to read this message, your computer is 
  35. probably up to the task.
  36.  
  37. The file containing the log entries must be an ASCII file in the 
  38. following format:
  39.  
  40.     TIME      CALLSIGN      RCV'D REPORT
  41.  
  42. At least one space must be between each field of each log entry, 
  43. and each line must be terminated by a carriage return.  Only a 
  44. changed digit in the time field must be present; for example, if 
  45. the contest begins at 1800Z and the first contact is made at 
  46. 1802Z and the second contact is made at 1805Z, then only 5 need 
  47. be entered in the time field.  If the third contact is made at 
  48. 1812Z, then 12 should be entered in the time field.  If the next 
  49. contact is made at 1812Z, then no number need be entered in the 
  50. time field (however, be sure to enter a space to indicate 
  51. separation between fields).  If no signal report is entered as 
  52. part of the received report, 59(9) (depending on the mode) is 
  53. assumed.
  54.  
  55. To run the compiled program, simply type the program name at the 
  56. screen prompt.  For example, type CQWWLOG at the A> prompt.
  57.  
  58. The three output files (.LOG, .DUP, and .SUM files) can be 
  59. printed by using the MS-DOS print command.
  60.  
  61. Some reminders:
  62.  
  63. 1. Be sure your log is in an ASCII format.  Just about every word 
  64.    processor can operate in an ASCII or Non-Document mode - that 
  65.    should work fine.  As an alternative, you can use one of the 
  66.    many utilities available in the marketplace and in the public 
  67.    domain to convert your word processor output into an ASCII 
  68.    format.  (See note below.)
  69.  
  70. 2. If you want the callsigns in your log to appear in capital 
  71.    letters, be sure to type them in with caps on. (See note below.)
  72.  
  73. 3. Since you probably will copy this program onto a working 
  74.    disc (rather than suffer the usual consequences of Mr. 
  75.    Murphy), remember that CQWWLOG needs access to DXPREFIX.LIB.  
  76.    DXPREFIX.LIB must be on the same disc as this program, and 
  77.    in the same subdirectory if you are using a hard disc.
  78.  
  79. 4. Each band requires a separate entry file.  The output files 
  80.    will be named as the original filname plus the appropriate 
  81.    extension (for example CQCW15.LOG, CQCW15.DUP, and CQCW15.SUM 
  82.    would be produced from the log entry file CQCW15.)  As a 
  83.    consequence of this, any file with the same name will be 
  84.    overwritten when CQWWLOG is run.  To avoid any deletion of 
  85.    valid files, use unique names for the files used on each band, 
  86.    and don't use the extensions .LOG, .DUP, or .SUM.
  87.  
  88. Although this program was tested on a variety of computers and 
  89. peripheral combinations, there are undoubtedly systems that may 
  90. balk at something in this program.  If you do encounter problems 
  91. with your system, please let me know; I may not be able to help, 
  92. but perhaps I can ask someone who can give assistance.  Of 
  93. course, if you find any bugs or have any suggestions for 
  94. improvements to this program, please let me hear about these, 
  95. too.
  96.  
  97.  
  98. 73,
  99.  
  100. Clarke Greene  K1JX
  101. Compuserve ID 73016.25
  102.  
  103.  
  104. Bug Report:
  105.  
  106. 1. An error in the source listing as printed in the Operating 
  107.    Manual caused a error message to appear when running CQWWLOG
  108.    "ILLEGAL FUNCTION 1530".  This has been fixed in both the
  109.    source listing and the executable file.  (Tnx WA2WIP)
  110.  
  111. 2. Expanded DXPREFIX.LIB memory allocation for bigger library.
  112.  
  113. 3. Added ability for program to distinguish between between USA
  114.    prefix ambiguities (i.e. KG6= Guam vs. KG6= Calif.).  (Tnx WD5K)  
  115.  
  116.  
  117. Note:
  118.  
  119. The compiled version of CQWWLOG has been revised substantially through
  120. the liberal use of Assembly language subroutines.  Execution speed
  121. is approximately 3 times faster than previous versions, and a number
  122. of new features have been added.  The source code for the compiled
  123. version is necessarily different from the enclosed source code sample.
  124. Any future version of this program will be enhanced only for the
  125. compiled program.  The source code sample will be upgraded to fix any
  126. bugs, but no additional features will be added.
  127.  
  128. New features include:
  129.  
  130.  * Support of "tab" delimiters in the log source file in addition
  131.    to spaces.
  132.  
  133.  * Automatic capitalizing of entries read from log source file.
  134.  
  135.  * Automatic capitalizing of keyboard entries from program prompts.
  136.  
  137.  * Automatic ASCII conversion of most word processor outputs. (That
  138.    means that you probably don't need to save your log source file
  139.    as an ASCII file).
  140.  
  141.  * Expanded error checking for improper data read both from the log
  142.    source file and the keyboard.
  143.