home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HAMRADIO / FDCALLS.ZIP / CALLS.DOC next >
Encoding:
Text File  |  1990-01-04  |  12.6 KB  |  266 lines

  1.                         FIELD DAY CALLS (CALLS.EXE)
  2.  
  3.                            Version 2.0    1Apr90
  4.  
  5.                           *by Stan Kaplan, WB9RQR
  6.                            11541 N. Laguna Drive
  7.                         Mequon, Wisconsin 53092-3119
  8.                                (414) 242-6966
  9.  
  10. *With  many thanks to Mr. Mark Siegesmund, Systems Analyst, who did much  of 
  11. the  original  programming and worked over the years with  WB9RQR  to  fully 
  12. develop the program.
  13.  
  14. WHATS NEW
  15. ---------
  16. This  is  a major re-write of the previous version.  However,  there  is  no 
  17. substantial  difference in the way the program handles data files,  and  you 
  18. can  list, resort save or add to datafiles created under Version  1.95  with 
  19. this new release.  Major changes:
  20.  
  21. 1.  This  version  has  been renamed CALLS.EXE to distinguish  it  from  the 
  22.     previous version.  
  23.  
  24. 2.  A new working (main) screen which should make it substantially easier on 
  25.     those bloodshot eyes at 3:00 am during Field Day.  The filename,  number 
  26.     of calls it contains, and the last 7 calls you entered are constantly on 
  27.     screen and updated as they change.  Here is what it looks like, minus  a 
  28.     couple of blank spacing lines:
  29.  
  30.                           ┌────────────┐  ┌────┐
  31.                 filename >│░░░░░░░░.░░░│  │░░░░│< calls in file
  32.                           └────────────┘  └────┘
  33.  
  34.                      Last calls entered from keyboard
  35.  ┌───────┐  ┌───────┐  ┌───────┐  ┌───────┐  ┌───────┐  ┌───────┐  ┌───────┐
  36. 1│       │ 2│       │ 3│       │ 4│       │ 5│       │ 6│       │ 7│       │
  37.  └───────┘  └───────┘  └───────┘  └───────┘  └───────┘  └───────┘  └───────┘
  38.  
  39.    WORKING                        MESSAGES
  40.   ╔═══════╗  ┌─────────────────────────────────────────────────────────┐
  41.   ║       ║  │                                                         │
  42.   ╚═══════╝  └─────────────────────────────────────────────────────────┘
  43.  
  44. 3.  In  the previous version, after entering a call, the operator was  asked 
  45.     if the call should be entered in the call list or not.  The purpose  was 
  46.     to  give  the  operator a chance to abort entry if the  call  was  typed 
  47.     incorrectly.  On the other hand, this required an extra keystroke, which 
  48.     WB7WTD suggested was unnecessary.  Accordingly, the new version defaults 
  49.     to  a NO PROMPT condition, but for those who like the prompt, it can  be 
  50.     selected at the second opening screen.  Use it the way you like it best.
  51.  
  52. 4.  The  new version is substantially smaller.  CALLS.EXE is now only  9,889 
  53.     bytes long, as compared to 13,504 bytes for FDCALLS.EXE.  This is a  27% 
  54.     reduction  in  size, and really helps with floppy  based  systems  where 
  55.     space  is  at  a  premium.  It will occupy less than  3%  of  the  space 
  56.     available on a 360k floppy; the rest is for your data.
  57.  
  58.  
  59. Thats  it for the changes.  The remainder of this updated DOC file  explains 
  60. the program for you who have not used it before. Have FUN at Field Day!
  61.  
  62. PUBLIC DOMAIN
  63. -------------
  64. Yes.   Copy  it, share it, modify it, etc.  Do anything you  want  with  it, 
  65. EXCEPT:  1.  Don't sell it (you can charge a nominal fee for the  disk  that 
  66. its  on,  but  that's all).  2.  Do give credit for it -  don't  remove  the 
  67. author's call from the program or this DOC file.  OK?
  68.  
  69. FILES
  70. -----
  71. There are two files in this package:
  72.  
  73.                    CALLS.DOC  12928 bytes 1Apr90 00:00:00 
  74.                    CALLS.EXE   9889 bytes 1Apr90 00:00:00 
  75.  
  76. If  your  source  of these two files was FDCALLS.ZIP, the  ZIP  file  itself 
  77. should show:
  78.                           FDCALLS.ZIP 15566 bytes 
  79.  
  80. The  date  and  time of the ZIP file will vary depending upon  when  it  was 
  81. copied.  However, when you unZIP the DOC and EXE files, DIR should show  the 
  82. date  but  no time stamp OR 00:00:00 (00:00:00 is reflected as a  blank,  at 
  83. least under MS-DOS 3.3).
  84.  
  85. The  DOC file is the file you are reading now.  The EXE file is the  program 
  86. iteself, compiled with Turbo PASCAL Version 5.5.
  87.  
  88. PURPOSE AND GENERAL FEATURES 
  89. ----------------------------
  90. FDCALLS is a FAST, efficient Field Day Logging program.  It has been in  use 
  91. by the Ozaukee Radio Club, PO Box 13, Port Washington, Wisconsin 53074,  for 
  92. over 5 years with excellent results.  There is NO waiting; a call is  logged 
  93. practically  instantly when the ENTER key is hit.  No visible time span  can 
  94. be  detected between the ENTER and the next prompt or DUPE beep until  there 
  95. are well over several hundred calls in a file.  You will be pleased with its 
  96. speed.
  97.  
  98. It can be used when Field Day is over, to log each tent or transmitter  site 
  99. into  a  separate file.  Alternatively, it can be used at Field  Day,  if  a 
  100. portable  or  laptop MS-DOS computer is available, to log each site  into  a 
  101. separate file.  This is what we do (Ozaukee Radio Club) each year.   Another 
  102. alternative,   for  clubs  that  have  several  portable  MS-DOS   computers 
  103. available, is to use it at each site; the no-wait feature makes dupe  sheets 
  104. obsolete,  provided you have a reliable source of power.  One  caution  that 
  105. should be self-evident.  If you are using generators at your Field Day site, 
  106. SAVE THE DATA OFTEN.  Also, work up some system of notifying all power users 
  107. when the generator is going down for refueling.  Don't just kill it, because 
  108. all data will be lost that is not saved on disk! 
  109.  
  110. RUNNING THE PROGRAM
  111. -------------------
  112. To run, type CALLS <ENTER>.  (Note that <ENTER> means pressing the ENTER  or 
  113. RETURN key.  A banner will be displayed showing the program name and version 
  114. number, as well as the upper limits for variables (number of calls that  can 
  115. be placed in a file, prefix first letters allowed, etc.).  An explanation of 
  116. filenames will follow, followed by:
  117.           Enter the filename now, or press the ENTER key 
  118.           without entering any characters to quit the program: ==>
  119.  
  120. Make up a standard filename and extension.  Some examples are:
  121.  
  122.       80PHONE.RQR   40PHONE.RXJ    20CW.CAN    NOVICE.TNT    SOLAR.CW
  123.  
  124. You need not use an extension, but its better if you do.  In the first three 
  125. examples  above, the extension consists of the call letters of the  head  of 
  126. that  tent  or  site.  Novice tent and solar CW are the last  two.   Let  us 
  127. assume you wish to work with a new file, NOVICE.TNT; type it in followed  by 
  128. ENTER.  You will see:
  129.  
  130.     Enter the filename now, or press the ENTER key 
  131.     without entering any characters to quit the program: ==> NOVICE.TNT
  132.     NOVICE.TNT was not found.  Create this file (Y/N)?
  133.  
  134. Respond  with a Y (upper or lower case), and you will see the  next  screen, 
  135. shown below, which gives you a choice of NO PROMPT (default) or PROMPT.
  136.  
  137. PROMPT OR NO PROMPT (that is the question):
  138. -------------------
  139. This is the second screen you will see:
  140.  
  141.      When  using  the program, you will type a call,  then  press  the
  142.      ENTER  key.  At that point, the call is accepted with no  further
  143.      prompt  and  the program is ready to take the  next  call.   Many
  144.      operators prefer this NO PROMPT option for speed.                
  145.  
  146.      Some  operators prefer a prompt,  which  gives  them  a chance to
  147.      check the accuracy of what they have entered.  In this case,  the
  148.      prompt will be:
  149.  
  150.                  ...Not yet logged.  Add to the file? (Y/N)
  151.                                                                  
  152.      In either case,  corrections can always be made by typing a  call
  153.      previously entered incorrectly, then selecting the delete  option
  154.      when the program finds it is a dupe.                          
  155.  
  156.      The NO PROMPT option is the default!  Press the ENTER key now  to
  157.      keep it that way, or press P, then ENTER, to change to the PROMPT
  158.      option.
  159.  
  160.      ENTER = NO PROMPT or P, ENTER = PROMPT.  Make your choice: --> 
  161.  
  162. No  further explanation is needed.  Choose it the way you like it.   If  you 
  163. are  not sure, create a junk data file and try it both ways.  Each time  you 
  164. enter  the program, you are asked to make this choice, so it is easy  enough 
  165. to try it one way for a bit, then the other way. 
  166.  
  167. ENTERING CALLS
  168. --------------
  169. Calls  may be entered in UPPER, lower or MiXeD case - case does not  matter.  
  170. The following will appear in the MESSAGE box when the program is ready for a 
  171. call entry:
  172.  
  173.               Enter a call, or L)ist, S)ave, R)esort or Q)uit
  174.  
  175. Type  the  call, which will appear in the double-line WORKING box.   If  you 
  176. have  chosen the NO PROMPT option, pressing the ENTER key will add the  call 
  177. to  the  list  in  memory.  If you have  selected  the  PROMPT  option,  the 
  178. following will appear in the WORKING box:
  179.  
  180.                  ...Not yet logged.  Add to the file? (Y/N)
  181.  
  182. Typing Y or y followed by ENTER will log the call in the list in memory,  IN 
  183. ITS SORTED ORDER.  That is, the program puts 9s after 8s, and WB8ABC  before 
  184. WB8XYZ, at the moment you press ENTER.  Therefore, the list is sorted as  it 
  185. is being built.  That is why dupes are caught so fast; they are looked up in 
  186. a presorted list.  
  187.  
  188. Now is the time to make a point.  It is very important for you to press  the 
  189. letter  S  every now and then at the main prompt.  Until that is  done,  the 
  190. data is not saved on disk.  If the power goes down, you loose the calls.  It 
  191. is  suggested  that  you save after every 20-25 calls.  The  number  is  not 
  192. important, but that you do it is.  SAVE OFTEN.  It takes very little time, a 
  193. few  seconds with even 500 calls in the file.  Do it; you will be glad  that 
  194. you did.  (Just in case you forget, the program will automatically save  all 
  195. the  calls after somewhere around 50 are entered, depending somewhat on  how 
  196. long  the  calls  are,  so don't panic if you suddenly  get  a  "Saving  the 
  197. data....."  message without requesting it.  However, you are urged  to  save 
  198. more often than this.)
  199.  
  200. DUPES
  201. -----
  202. Let us suppose you type a duplicate call, followed by ENTER.  You will see: 
  203.  
  204.             DUPE: Do you wish to delete it from the file? (Y/N)?
  205.  
  206. and  you  will hear a beep.  Answer N (or n) to this question  and  continue 
  207. with your next entry.  
  208.  
  209. This  is also the mechanism for deleting a call from the file, for  example, 
  210. one  you  entered before you discovered it was typed incorrectly.   In  this 
  211. case,  retype the incorrect call to get the DUPE prompt shown  above.   Then 
  212. answer Y or y to the question, and it will be deleted from the list.  
  213.  
  214. IMPROPER ENTRIES
  215. ----------------
  216. The program will accept calls which begin with W, K, N, A or V.  If you miss 
  217. the W and hit an E, entering a call such as EB9RQR, you will see: 
  218.  
  219.                            *** IMPROPER ENTRY ***
  220.  
  221. in  the message box (if you look quickly!).  A beep will sound and the  main 
  222. prompt  will again appear.  Type the call correctly and proceed.  Note  that 
  223. each call may contain up to 7 characters.  A single data file  (80PHONE.RQR, 
  224. etc.) may contain up to 3,000 calls.
  225.  
  226. LIST
  227. ----
  228. This command (L) at the main prompt will list the contents of the calls,  in 
  229. columns of four across.  Each call is numbered.  Following the screen  list, 
  230. you will see the prompt:
  231.  
  232.            Send to printer as well?  Enter Y)es for hard copy -->
  233. Entering  any  character  other than Y or y will get you back  to  the  main 
  234. prompt; yes will list the calls to the printer, along with space to write in 
  235. your  club name and a heading showing the filename.  This hardcopy is  ready 
  236. to go to ARRL.
  237.  
  238. SAVE
  239. ----
  240. This  command  saves the call list to disk, as mentioned above  in  ENTERING 
  241. CALLS.  Save often!
  242.  
  243. RESORT
  244. ------
  245. This  is  a  command  which  you will  probably  never  use.   As  mentioned 
  246. previously, each call is inserted in its proper position in the whole  list, 
  247. when  first  logged, the instant you press the ENTER key.   However,  should 
  248. some  error  cause  a call to be inserted out of order,  this  command  will 
  249. resort everything.
  250.  
  251. QUIT
  252. ----
  253. Returns  you  to DOS, after first S)aving everything to  disk  (nice  safety 
  254. factor).  
  255.  
  256. LAST SEVEN CALLS
  257. ----------------
  258. This new feature is quite simple.  Calls typed move through the seven screen 
  259. boxes,  in order, just as they were typed (correctly or  incorrectly).   The 
  260. 8th  call  you  type will be shown in box 1; the one that was in  box  8  is 
  261. replaced  by  the one in 7, and so on.  It is hoped that this  feature  will 
  262. help you to spot errors, when there is time to glance at the boxes.  We  all 
  263. hope  there is not - that the calls come too fast and thick for you to  take 
  264. the time!  ENJOY FIELD DAY.  73, WB9RQR 
  265.  
  266.                         <<<<< END OF DOCUMENT >>>>>