home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / hamradio / list-log.lbr / LIST_LOG.DQC / LIST_LOG.DOC
Encoding:
Text File  |  1987-02-08  |  4.4 KB  |  144 lines
  1. LIST/LOG.DOC    for   LIST/LOG.LBR
  2. March 86 p.p.p.
  3.  
  4.  
  5.  
  6. LIST/LOG.LBR  contains two MBASIC programs which are 
  7. used to create and manipulate lists of records. 
  8.  
  9.  
  10. 1.   LIST/LOG.BAS creates records of two fields.
  11.           
  12.           A.   Field 1 can be up to  18  characters 
  13.                long and cannot contain commas.
  14.  
  15.  
  16.           B.   Field 2  can be up to 55  characters 
  17.                long and may contain commas.
  18.  
  19.  
  20. Note: Both fields may be longer except in that case, 
  21. the  record  will  occupy more than  one  line  when 
  22. printed. 
  23.  
  24.  
  25. The list can be searched, sorted, saved and edited.     
  26. The  program is menu driven for ease  of  operation. 
  27. See the following, LIST DOCUMENTATION, for details.
  28.  
  29.  
  30.  
  31. 2.   HAMLOG.BAS works very much like LIST/LOG but is 
  32. designed  specifically for keeping an Amateur  Radio 
  33. log.  Fields are provided for Call sign,  RST,  Time 
  34. and  comments.  A  duplicate check is  included  for 
  35. contests. See HAMLOG.DOC for details.
  36.  
  37.  
  38. HISTORY:
  39. These  programs  are patterned after CONTEST.BAS  by 
  40. W0XI  which  was  modified  by  KA5OIT  and   called 
  41. SUPERDUP.BAS. 
  42.   
  43.  
  44. LIST/LOG DOCUMENTATION
  45.  
  46. Documentation for LIST/LOG.BAS, an MBASIC program
  47. March 86 P.P.P.
  48.  
  49.  
  50. Purpose:
  51. LIST/LOG.BAS   is  a  program  used  to  create  and 
  52. manipulate  lists of records containing two  fields. 
  53. An  example would be a list containing a name  field 
  54. and  an  address  field.   Field  one  is   eighteen 
  55. characters long and cannot contain commas. Field two 
  56. is   fifty-five  characters  long  and  can  contain 
  57. commas but cannot contain parenthesis.   Both fields 
  58. can  be longer but in that  case the   record   will  
  59. occupy more than  one  line  when printed.
  60.  
  61.  
  62. Operation:  
  63. When entered,  the fields are combined into a record 
  64. in the log which can be  viewed,  edited,  searched, 
  65. saved and erased. Logs can also be loaded from disk. 
  66. Operation  is menu driven but a few comments are  in 
  67. order.
  68.  
  69.  
  70. When  the  program  is run it starts in  the  create 
  71. mode.   You   may enter M  to get to  the  main menu  
  72. or  D  to  toggle the Duplicate Check  on  and  off. 
  73. Otherwise  enter  field  one  and  field  two   when 
  74. prompted. 
  75.  
  76.  
  77. The following operations are available from the main 
  78. menu:
  79.  
  80.  
  81. 1.   - CREATE LOG (just described)  
  82.  
  83. 2.   - VIEW LOG
  84.  
  85. 3.   - EDIT LOG
  86. Editing in this case means re-entering the incorrect 
  87. entry.  To  skip over a correct entry just hit  <cr> 
  88. and the field will remain unchanged. (At any  prompt 
  89. <cr> results in the default value.) A deleted record 
  90. remains in the log until the log is saved to disk. A 
  91. deleted  record  may  be  restored  by  editing  and 
  92. removing the delete mark, * , from field one.
  93.  
  94. 4.   - SORT ON FIELD 1
  95. Records are sorted in alphabetical order.
  96.  
  97. 5.   - CHANGE DISK
  98. If  you wish to save a log to a disk other than  the 
  99. disks  currently in use,  hit 5 at the menu and  you 
  100. will  be prompted to change  disks.  After  changing 
  101. disks hit any key and the disk drives will be reset. 
  102. If  you fail to do this,  CPM will detect the change 
  103. and  dump  you  out of basic and  back  to  the  CPM 
  104. prompt.  The  log in memory will be lost or at least 
  105. difficult to recover.
  106.  
  107. 6.   - SEARCH FIELD 1
  108. Enter a string to search for. The string may be from 
  109. one  to eighteen characters.  The program looks  for 
  110. the  string starting from the left.  For example  to 
  111. find  all  names beginning with An enter An  at  the 
  112. prompt.
  113.   
  114. 7.   - SEARCH FIELD 2
  115.  
  116. 8.   - READ LOG FROM DISK
  117. Logs   read  in  are appended to the log  all  ready  
  118. in memory.
  119.  
  120. 9.   - WRITE LOG TO DISK
  121. Enter  a valid CPM filename.  If the filename is all 
  122. ready  on  the  disk it will  be  renamed  with  the 
  123. extension .bak and a new file will be opened.
  124.  
  125. 0.   - EXIT TO BASIC
  126. Don't  use ^C to end the program because the log  in 
  127. memory  will be lost.  Selecting  0  from  the  menu 
  128. gives   you   a chance to change your mind and  also 
  129. resets the error checking routine so MBASIC is again 
  130. in control.
  131.  
  132. G    - COLLECT GARBAGE
  133. When  the  program runs out of string  space, MBASIC 
  134. will  delete  old strings no longer  used.  This  is 
  135. called garbage collecting and can take anywhere from 
  136. a  few seconds to over a minute.  By selecting G  at 
  137. the  menu you can force a garbage collection at your 
  138. leisure.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.