home *** CD-ROM | disk | FTP | other *** search
/ The Best of the Best / _.img / 02192 / contest.arc / CONTEST.DOC < prev   
Text File  |  1987-12-25  |  22KB  |  595 lines

  1.         PC-HAM CONTEST.DOC Version 3.0 PAGE 1
  2.  
  3.  
  4.                                PC-HAM Version 3.0
  5.  
  6.                  G3ZCZ AMATEUR RADIO CONTEST PACKAGE VERSION 3.0
  7.          
  8.                   (C) Copyright 1985, 1986 - All Rights Reserved 
  9.  
  10.                                By Joe Kasser G3ZCZ
  11.                                     POB 3419,
  12.                                   Silver Spring,
  13.                                  Md., 20901, USA.
  14.  
  15.         PC-HAM is a set of DATA Processing Amateur Radio programs for the 
  16.         user  of  a microcomputer in Amateur Radio.  The  BASIC  language 
  17.         programs  may or may not be described in or be based on  programs 
  18.         described in the book,  SOFTWARE FOR AMATEUR RADIO written by Joe 
  19.         Kasser,  G3ZCZ,  published by TAB Books (Number 1560), Blue Ridge 
  20.         Summit,   Pa.,   17214.  The  DBASE2  programs  perform  database 
  21.         operations on logbook information.
  22.  
  23.              PC-HAM is written and supported by Joe Kasser, G3ZCZ.
  24.  
  25.         The program is distributed as a Shareware product. You may freely 
  26.         copy  and  share the product with your  friends,  associates  and 
  27.         other radio hams. If you decide to use the product, you are asked 
  28.         to  become a registered user by sending  a QSL card and  a  cont-
  29.         ribution  to the author (suggested amount of $36.50 (ie.  half of 
  30.         73)  or  equivalent  in foreign currency (See  registration  form 
  31.         below).
  32.  
  33.         The  contribution covers the cost of distribution of the  updated 
  34.         disk,  and  supports the continual development of  "Software  for 
  35.         Amateur  Radio".   Upon  receipt of your contribution,  you  will 
  36.         receive  one free update disk ),  mail (electronic  and  regular) 
  37.         support,  and  notice of further releases.   The update disk will 
  38.         contain any new versions of the software on this disk  (converted 
  39.         programs  from Northstar BASIC to IBM) plus new software,  accom-
  40.         panying  the  series of articles currently being written  on  the 
  41.         applications  of  data processing concepts of  microcomputers  to 
  42.         amateur radio.
  43.  
  44.         Under  no circumstances may this product be sold  or  distributed 
  45.         with  another  product without the express written permission  of 
  46.         Joe Kasser, G3ZCZ.  
  47.  
  48.         Joe  Kasser,  G3ZCZ  will only support unmodified copies of  this 
  49.         software.   Your comments and suggestions for changes are however 
  50.         welcome.   If you are the first to suggest a change that is  imp-
  51.         lemented,  you will be sent a complimentary copy of the disk with 
  52.         the change incorporated.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         PC-HAM CONTEST.DOC Version 3.0 PAGE 2
  68.  
  69.  
  70.                                     TABLE OF CONTENTS
  71.  
  72.         1.0  INTRODUCTION
  73.  
  74.         2.0  DURING THE CONTEST
  75.  
  76.         3.0  COMMANDS
  77.  
  78.              3.1  QSL       (Function Key 1)
  79.              3.2  Band      (Function Key 2)
  80.              3.3  CALL      (Function Key 3)
  81.              3.4  *QRT      (Function Key 4)
  82.              3.5  RPT RX    (Function Key 5) 
  83.              3.6  Fudge     (Function Key 6)
  84.              3.7  XMT RPT   (Function Key 7)
  85.              3.8  /PX CHK   (Function Key 8)
  86.              3.9  LOG       (Function Key 9)
  87.              3.10 ?CLN      (Function Key 10)
  88.              3.11 WATTS
  89.              3.12 MODE
  90.  
  91.         4.0  AFTER THE CONTEST
  92.  
  93.         5.0  SAMPLE DISK FILES
  94.  
  95.         6.0  REVISION HISTORY
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         PC-HAM CONTEST.DOC Version 3.0 PAGE 3
  134.  
  135.  
  136.         1.0  INTRODUCTION
  137.  
  138.         Contests  are   a  natural  application of  computers in  amateur 
  139.         radio.  After  all   the purpose of a contest can  be  stated  as 
  140.         gathering  data   (the  calls and reports of stations worked)  in 
  141.         such a way as to avoid  duplicates.  When working  contests in  a 
  142.         manual    (non  computer)   mode,    if  you  desire  to    avoid 
  143.         duplicates,  you  usually have to  keep two sets of records   for 
  144.         each   contact.   The log entry has to  be made,  and a duplicate  
  145.         sheet  of some kind has  to be kept to  give real time notice  of  
  146.         potential  duplicate contacts.   
  147.  
  148.         The  use of a good contest logging program simplifies  the  paper  
  149.         work  during  and   after a contest and allows  the  operator  to  
  150.         concentrate  on  working  stations. 
  151.  
  152.         During  the  contest,  the  operator  has  only  to  perform  the 
  153.         following tasks.  
  154.  
  155.         *    Enter the call sign of the station worked.  
  156.  
  157.         *    Enter the  report received.  
  158.  
  159.         *    Tell the computer to log the  contact.  
  160.  
  161.         The  computer takes care of the rest of the  data  handling.  The  
  162.         computer thus performs the following tasks.     
  163.  
  164.         *    Keeps  a  check list in memory to notify the operator  if  a 
  165.              contact  has  been made on the same (duplicate) or an  other 
  166.              band.   
  167.  
  168.         *    Updates date and time information automatically.  
  169.  
  170.         *    Stores the contact data in a floppy disk file.  
  171.  
  172.         2.0  DURING THE CONTEST
  173.  
  174.         The  contest  program on this disk maintains the check  list  for 
  175.         duplicates  in  memory,  logs  all contacts to disk  and  can  if 
  176.         desired  (and  so it should be) print a running log  of  contacts 
  177.         and/all callsigns to the printer as the contest progresses.  This 
  178.         print  operation  is desirable in case of  a  power  failure,  or 
  179.         operator error in which a contact was not logged by mistake.
  180.  
  181.         BEFORE  YOU  DO ANYTHING ELSE,  SET THE CAPITALS KEY SO THAT  ALL 
  182.         CHARACTERS ARE ENTERED IN CAPITAL LETTERS.
  183.  
  184.         The  program  is invoked by loading BASIC and  then  loading  and 
  185.         executing  the  contest program in the usual manner for  programs 
  186.         written in BASIC.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.         PC-HAM CONTEST.DOC Version 3.0 PAGE 4
  200.  
  201.  
  202.  
  203.         When  the program begins,  a sign on message such as  that  shown 
  204.         below will appear.  
  205.  
  206.                      G3ZCZ CONTEST LOGGING PROGRAM VERSION 3.0
  207.  
  208.         IF TIME IS NOT SET TO UTC, STOP NOW AND SET THE CLOCK IN DOS
  209.  
  210.         At  this  time,  if the clock has not been set to UTC before  you 
  211.         loaded the program,  break the sequence and return to DOS to  set 
  212.         the date and time to the correct UTC values.
  213.  
  214.         You  will then be requested to give the computer the name of  the 
  215.         file you wish be the log.  The computer checks the disk to see if 
  216.         the file exists.   If it does, the computer will load the data in 
  217.         it  into the check list,  and display the calls worked as it goes 
  218.         along.   If there is no such file on the disk,  the computer will 
  219.         create  one.   You  will then be asked about your  running  print 
  220.         requirements. You have the option of printing the logged contacts 
  221.         and/or just the calls (as you enter them) as you go along.  Reply 
  222.         with the CAPITAL letters please as in the examples below.
  223.  
  224.         Enter name of lOG file (D:NAME) Log type .LOG Assumed ? FIELD85
  225.         Do you want a running log printed out (Y/N) ? Y
  226.         Do you want CALL SIGNS printed out (Y/N) ? Y
  227.  
  228.         If the log file is new, the computer will prompt you to enter the 
  229.         Mode,  Band and after a short pause, it will request you to enter 
  230.         the   Transmitter  Power information before getting down  to  the 
  231.         contest.  
  232.  
  233.         If you are loading an existing file,  after a break for  example, 
  234.         the  computer  will  load the check list from the  log  file  and 
  235.         display the calls as it goes along.   When the log is loaded, the 
  236.         computer  will  pause and wait for you to touch the  'ENTER'  key 
  237.         before  setting up the main screen.   A typical example from  the 
  238.         FIELD85 log  is shown below.
  239.  
  240.          166          G4NWG         54019
  241.          167          G4TSH         55024
  242.          168          G4OVF         57001
  243.          169          G4EKT/P       55592
  244.          170          DF0WB/P       53
  245.         Waiting,touch ENTER to continue ?
  246.  
  247.         You  can see the entry number,  followed by the call sign od the 
  248.         station  worked  and lastly the report received.   The  remaining 
  249.         data in the log file associated with each contact is there but is 
  250.         not displayed at this time.
  251.  
  252.         When the program begins a new contest log,  you will be presented 
  253.         with the following screen.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.         PC-HAM CONTEST.DOC Version 3.0 PAGE 5
  266.  
  267.  
  268.         G3ZCZ CONTEST LOGGING PROGRAM VERSION 2.60          DUMMY    
  269.         -------------------------------------------------------------
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.         --------------------------------------------------------------
  284.                                      CURRENT ENTRY
  285.          1            ?
  286.  
  287.         QRU ?
  288.  
  289.         The top line contains the version of the program and displays the 
  290.         name of the disk file you are using as the log.   It is recommen-
  291.         ded that the name be somewhat representative of the contest.  Use 
  292.         names such as WPX87, ARRLDX86, FIELD85 and so on.
  293.  
  294.         The blank area following is where the last few contacts you  made 
  295.         will be displayed.   You thus have an ongoing display of the last 
  296.         contacts .  It is very useful to see how you are doing and in the 
  297.         Worked  All  Europe  contest you can use that data  for  the  QTC 
  298.         information (if you are located outside Europe).
  299.  
  300.         The  lower  part of the screen contains the  CURRENT ENTRY  data.  
  301.         This  is the data concerning the contact in  progress.   In  this 
  302.         case the next contact is the first or number 1, and the call data 
  303.         is blank because nothing has been entered.
  304.  
  305.         As  you work the contest you will pick up information from  other 
  306.         stations.   This  information will consist of call signs and  re-
  307.         ports.  In some contests (eg. The ARRL Sweepstakes) the report is 
  308.         relatively complex,  in others it is simple.   You do not know in 
  309.         which order you will get the data for each contact.  This program 
  310.         thus lets you enter the data in any order.  You tell the computer 
  311.         which  piece  of data is going to be entered by typing  a  single 
  312.         letter followed by the 'ENTER' key.  
  313.  
  314.         In order to speed up that operation,  the function keys have been 
  315.         set up with those commands,  and are displayed during the contest 
  316.         for your convenience.
  317.  
  318.  
  319.         3.0  COMMANDS
  320.  
  321.         The   contest  logging program gives the operator  the  following 
  322.         choices. If you do not wish to use the function keys, you have to 
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.         PC-HAM CONTEST.DOC Version 3.0 PAGE 6
  332.  
  333.  
  334.         type the first letter followed by the 'ENTER' key.
  335.  
  336.              3.1  QSL       (Function Key 1)
  337.  
  338.              Displays the log entry data on the screen . This command may 
  339.              be  used for example to verify that  the  correct  band data 
  340.              is set  after  changing  bands.   
  341.  
  342.              3.2  Band      (Function Key 2)
  343.  
  344.              Enters  the band information for the checklist and log.  Use 
  345.              the following designations for the different bands, 160, 80, 
  346.              40, 20, 15, 10, and 2.
  347.  
  348.              NOTE,  changing the band will clear the call and report data 
  349.              elements form the display.
  350.  
  351.              3.3  CALL      (Function Key 3)
  352.  
  353.              Enters the Call of the station to be or being worked.   When 
  354.              the call is entered,  the computer will  perform a check  to 
  355.              see  if  that call has  already been worked and  if  so   on 
  356.              what  band. If the call has  been worked on the  band in use 
  357.              at  that  time it will also display the word  DUPLICATE  and 
  358.              BEEP  an audible  alarm.   The beep is a must at  0330  hrs. 
  359.              local time.   
  360.  
  361.              If you change your mind,  type the 'ENTER' key and the  call 
  362.              in the display will not be changed.
  363.  
  364.              3.4  *QRT      (Function Key 4)
  365.  
  366.              This  command terminates  the  program.  It saves  the  data 
  367.              associated  with  the last  12 contacts in a file  with  the 
  368.              ".CHK"   extension     so  that when the program is restart-
  369.              ed,  the operator  will not even notice that a  break occur-
  370.              red.  The  disk files are closed and any previous  log  file 
  371.              present from the start  of the session is named as a  backup 
  372.              file.
  373.  
  374.              Since  you  have  the potential to lose a  number  of  QSO's 
  375.              (while  recovering)  if you invoke this command by  mistake, 
  376.              the  computer  will ask you to verify that you meant  to  do 
  377.              what  you just asked for.   You will be prompted to  confirm 
  378.              your request with the following message.
  379.  
  380.                             ARE YOU SURE ?
  381.  
  382.              At  this time,  type the letter Y for "YES" followed by  the 
  383.              'ENTER'  key if you want to got QRT for a while,  or if  the 
  384.              contest is over.  Any other key will abort the sequence.
  385.  
  386.              3.5  RPT RX    (Function Key 5)
  387.  
  388.              Enter the Report received into the  log.   
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.         PC-HAM CONTEST.DOC Version 3.0 PAGE 7
  398.  
  399.  
  400.  
  401.              3.6  Fudge     (Function Key 6)
  402.  
  403.              This command is used to flag an erroneous log entry.   Since 
  404.              the  log on disk is a sequential file,  and the log data  is 
  405.              not double buffered by the program, once an entry is written 
  406.              to the log,  it is gone.  This command deletes the call from 
  407.              the list checklist and puts a "/*" entry  into the logbook. 
  408.  
  409.              Since  you have the potential to delete a QSO if you  invoke 
  410.              this command by mistake, the computer will ask you to verify 
  411.              that you meant to do what you just asked for.   You will  be 
  412.              prompted to confirm your request with the following message.
  413.  
  414.                             ARE YOU SURE ?
  415.  
  416.              At  this time,  type the letter Y for "YES" followed by  the 
  417.              'ENTER'  key  if you want to fudge the  last  contact.   Any 
  418.              other key will abort the sequence.
  419.  
  420.              3.7  XMT RPT   (Function Key 7)
  421.  
  422.              Enter  the signal report Xmitted to the  other station  into 
  423.              the log.   
  424.  
  425.              3.8  /PX CHK   (Function Key 8)
  426.  
  427.              This   command  is used to scan the contents of   the  check 
  428.              list  for prefixes.  You use  this  when  you are sure  that 
  429.              you  have  worked a station  but the computer tell you  that  
  430.              you haven't.   You may also use it to check if a prefix  has 
  431.              been  worked as a help in deciding if you want to get into a 
  432.              pile up or pass it  by.   NOTE however that the response  is  
  433.              not instantaneous.  It takes a good few  seconds to scan the 
  434.              4000 slots in the check list.  The  computer will prompt you 
  435.              to enter  a prefix.  If you want to look at all the calls in 
  436.              the check list,  enter an asterisk (*) as the desired prefix 
  437.              and  you will get a list of every call in the check list  in 
  438.              the order in which they are hashed in the check list.   
  439.  
  440.              3.9  LOG       (Function Key 9)
  441.  
  442.              Enter the QSO information into the Log book/check list.  The 
  443.              data  is written into the log file in ASCII format delimited 
  444.              with  commas.  This  makes  it easy to modify  with  a  word 
  445.              processor  and  read  into the program used  by  the  second 
  446.              computer.  You may also list the contents of the log file to 
  447.              the screen under DOS using the "TYPE" command.   
  448.  
  449.              Logging a contact clears the call and time data.
  450.  
  451.              THE  COMPUTER  WILL NOT LET YOU LOG THE QSO UNTIL  YOU  HAVE 
  452.              ENTERED BOTH A CALL SIGN AND A REPORT.   This traps one type 
  453.              of error that can be made in the heat of the moment.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.         PC-HAM CONTEST.DOC Version 3.0 PAGE 8
  464.  
  465.  
  466.              3.10 ?CLN      (Function Key 10)
  467.  
  468.              This command clears the screen dialog  lines. It is normally 
  469.              used  rarely,  only in the event that the BASIC  interpreter 
  470.              generates  an error message  in response to a  user   input. 
  471.              The  typical   one   normally  seen  is  "REDO  FROM  START" 
  472.              which  results from an  alphabetical response  to the   BAND  
  473.              interrogation,   where BASIC is looking for a number,  not a 
  474.              string.                     
  475.  
  476.              3.11 WATTS
  477.  
  478.              Enter   the Transmitter Power used  in  Watts into the  log-
  479.              book.   
  480.  
  481.              3.12 MODE
  482.  
  483.              Enter   the  Mode used in the contest in the log.   You  may 
  484.              enter anything,  but the most commonly used ones are SSB and 
  485.              CW.   
  486.  
  487.  
  488.         4.0  AFTER THE CONTEST
  489.  
  490.         When  the contest ends,  or you take a break,  the computer  will 
  491.         close  out the log and 'CHK' files and ask you if the contest  is 
  492.         over.  The following messages will be displayed.
  493.  
  494.         SAVING LAST ENTRY STRINGS BEFORE CLOSING
  495.         Is the contest over (Y/N) ?
  496.  
  497.         If you reply with the letter N for NO,  the program will end.  If 
  498.         the contest is over, and you reply with the letter Y, the program 
  499.         will  proceed to process the contest log data.   It  will  delete 
  500.         entries  flagged  for  deletion and optionally  will  number  the 
  501.         contacts  in the comments column.   The program prompts for inst-
  502.         ructions as to the number option as follows.
  503.  
  504.         CONVERTING (CLEANING UP) CONTEST LOG TO STANDARD LOG
  505.         Do you want the contacts numbered (Y/N) ? N
  506.  
  507.         The  computer will put a dummy entry into the first  position  of 
  508.         the  log  identifying the contest.   It will thus request you  to 
  509.         give  it  the  name of the contest.   You must use  a  name  that 
  510.         contains  10  or fewer characters.   The questions  is  posed  as 
  511.         follows.
  512.  
  513.         What is the name of the contest ? FIELD85
  514.  
  515.         The   program  first generates a reference entry for the  contest 
  516.         log.   It then reads each line of  log  information,  strips  the 
  517.         report part from the comments and  puts it into the report  space 
  518.         and  if it as been so instructed,  adds the serial number of  the 
  519.         contact into the comments space.    When the program has done its 
  520.         job,  the  original  log has been renamed  with   a  ".RUN"  file  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.         PC-HAM CONTEST.DOC Version 3.0 PAGE 9
  530.  
  531.  
  532.         extension   while  the converted log data file has the  extension 
  533.         ".LOG".
  534.  
  535.         The  computer generates a running display as the data  processing 
  536.         job proceeds, a typical example of which is shown below.
  537.  
  538.         85/09/08      -CONTEST               SSB           FIELD85
  539.         85/09/07 1646 G4ANT/P    20  59  59  SSB  200  - - 064
  540.         85/09/07 1647 DF0KD/P    20  59  59  SSB  200  - - 131
  541.         85/09/07 1648 G4AAX/P    20  59  59  SSB  200  - - 086
  542.         85/09/07 1649 YU4EXC/P   20  59  59  SSB  200  - - 198
  543.         85/09/07 1651 DF0SSB/P   20  59  59  SSB  200  - - 160
  544.         85/09/07 1659 G3WAS/P    20  59  59  SSB  200  - - 089
  545.         85/09/07 1703 YU4EZC/4   20  59  59  SSB  200  - - 219
  546.          -------
  547.         85/09/08 1305 G4NWG      15  54  53  SSB  200  - - 019
  548.         85/09/08 1306 G4TSH      15  55  59  SSB  200  - - 024
  549.         85/09/08 1307 G4OVF      15  57  53  SSB  200  - - 001
  550.         85/09/08 1323 G4EKT/P    20  55  59  SSB  200  - - 592
  551.         85/09/08 1330 DF0WB/P    20  53  53  SSB  200  - -
  552.  
  553.          10 Entries were corrected/deleted
  554.         OK
  555.  
  556.         Note  that the date is set to the date at the end of the contest, 
  557.         not the date at the start of the contest.   When the job is over, 
  558.         you will be shown how many entries were corrected or deleted.
  559.  
  560.         You may examine the log with a word processor (non-document  mode 
  561.         please),  or better still APPEND it to the DBASE2 logging package 
  562.         for further  processing.  Since the logging package processes the 
  563.         data  so well,  a program in BASIC to display the log was  deemed 
  564.         unnecessary.
  565.  
  566.         5.0  SAMPLE DISK FILES
  567.  
  568.         The   following  sample files of an extract from the  1985  Field  
  569.         Day  contest   log  are  presented on the disk as   an   aid   to 
  570.         understanding the operation of the CONTEST package.
  571.  
  572.         FIELD85.LOG  Log (output of the CONTEST program),  ready for con-
  573.                      version to .DBF format.
  574.         FIELD85.CHK  Last few entries in log.
  575.         FIELD85.DBF  Log, in DBASE2 data base format.
  576.         FIELD85.NDX  Index file for DBASE2 log database.
  577.  
  578.  
  579.         6.0  REVISION HISTORY
  580.  
  581.         This section documents changes and revisions.
  582.  
  583.         3.0  Logbook  format  changed  from  dBASE2  to  dBASE3   LOGBOOK 
  584.              compatibility.   If  you never used a an earlier release  of 
  585.              the  CONTEST  program,  or the dBASE LOGBOOK package with  a 
  586.              Revision letter lower than 3.0, forget this.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.