home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / CATLOG / ORGANIZR.LBR / READ.MZ / READ.ME
Text File  |  2000-06-30  |  12KB  |  210 lines
  1.                              The Organizer
  2.                              Developed by:
  3.                               Tim McNeal
  4.                              McNeal Audio
  5.                               PO Box 344
  6.                            Tipton, IN 46072
  7.  
  8. What does The Organizer do?
  9.  
  10.    The Organizer will give you a printed directory of all the files on your
  11. disks.  This index can be a great time saver in trying to find files, when
  12. you have accummulated a large number of disks.  It can also help in your
  13. reorganization of your files.  You can now figure out which disks you want
  14. to copy from, so that related files can finally be together.  This will greatly
  15. reduce the search time involved in finding these files.
  16.  
  17.    There are two main programs for creating and printing this master index
  18. or directory.  We recommend storing the printed directory in a three ring
  19. binder for easy access and updating.  Dilegence should be given to keep the
  20. pages updated between the times these programs will be run, but even if it's
  21. not done, a periodic maintenance (running these programs) will suffice.
  22.  
  23. GETTING STARTED
  24.  
  25.    If you are using a 48K computer, then rename the file ORGASORT.48K to
  26. ORGASORT.COM.  If you are using a 64K computer, then rename the file
  27. ORGASORT.64K to ORGASORT.COM.  Sorting will be faster with the 64K version.
  28. Example: A>REN ORGASORT.COM=ORGASORT.48K.
  29.  
  30.    Place a bootable Disk in Drive A and this disk in Drive B and load PIP.COM
  31. into the computer.   From the * prompt, type the following. *A:=B:*.*  <CR>.
  32. This disk in drive A will now be your working program Disk.
  33.    Prepare two more disks with just BIOS.SYS on them using SYSGEN.COM.  One of
  34. these will be your SortDisk and the other will be your DataDisk for
  35. ORGANIZE.DAT.
  36.  
  37. ORGANIZE.COM
  38.  
  39.    This program creates the master file called ORGANIZE.DAT.  You will need
  40. a disk in Drive A for this file to be created.  Be sure to sysgen this disk
  41. so that a warm boot may take place on it.  It is recommended that you use a
  42. blank or nearly blank diskette for this file.   The program assumes that you
  43. will have 85K of working space on the disk (90-5 for CP/M).  If this is the
  44. case, then just press <RETURN> when asked for the available K.  Or enter
  45. the K remaining.  To determine the K remaining run the STAT.COM program that
  46. came with your CP/M disk.  You may want to create a SUB file, so that you don't
  47. forget each time you run the program.  Copy the ORGANIZE.SUB file included
  48. onto this disk to the disk on which you will be creating ORGANIZE.DAT.  And
  49. then copy STAT.COM and SUBMIT.COM from your CP/M distribution disk onto your
  50. working copy of this program disk.
  51.  
  52.    Place the program disk in drive B and the DataDisk in Drive A.  Typing
  53. B:ORGANIZE or B:SUBMIT ORGANIZE will then execute the program.  You will
  54. be prompted for the number of Drives you are using.  A minimum of two drives
  55. are required for this program.  One to read from and one to write to.  The
  56. more drives you have available the quicker this can go.  The program will
  57. tell you from which drive it is going to read.  You need only supply the name
  58. of the disk.  You are allowed only 25 characters for this name so you may need
  59. to abbreviate.  But keep the name you enter recognizable with the disk name
  60. you are reading.
  61.                                                                    Page 2
  62.  
  63.    With an 85K disk, 2177 files can be entered into the file.  A maximum of 64
  64. files can be read from a disk regardless of the storage capacity.  Sixty four
  65. records on a disk is rare, so you probably be able to log over 100 disks.
  66. The maximum number of records the program can handle is slightly over 32000.
  67. This would require a 1 meg disk to reach this value so you need not worry
  68. about having too many records for the program, just your disk space.
  69.  
  70.    Based on the K information given, the program may abort because the disk
  71. is getting too full.  If you get this error then the file will close and your
  72. work will not be lost.  This condition is determined from the program and not
  73. from the actual disk property.  Therefore the disk really is not full, but
  74. continuing any farther would be risky.
  75.  
  76.    If the program aborts in the middle of a directory with a Disk is full
  77. error, then this was triggered from the actual physical property of the disk.
  78. Since there is not enough room on the disk to close the file the program will
  79. not close it.  However, all of your work may not be lost.  If this is the case,
  80. then the program COPYFILE.COM will need to be run to fix this error condition.
  81.  
  82. ORGASORT.COM
  83.  
  84.    This is the program for printing the file ORGANIZE.DAT.  You can have your
  85. print-out in one of four formats.  They are as follows.
  86.  
  87.    A. Sorts by Extensions.
  88.           This is very useful in identifying like files.
  89.           Example:
  90.                     LETTERS  BAK
  91.                     APPLE    BAS
  92.                     BROWN    BAS
  93.                     MBASIC   COM
  94.                     WORDWRIT COM
  95.  
  96.    B. Sorts by Filename.
  97.          Example:
  98.                     ASM      COM
  99.                     MBASIC   COM
  100.                     ROBOTNIM BAS
  101.                     TURBO    COM
  102.                     ZSINE    BAS
  103.  
  104.    C. Sorts by DiskName.
  105.          This is according to the name you enter when creating ORGANIZE.DAT.
  106.          The files will then be sorted according to B above within each Disk-
  107.          Name.
  108.  
  109.    D. Straight Print.
  110.          No sorting is done.  The printout will be the same as was inputed
  111.          into the file.  In both C and D you will have your choice of having
  112.          a separate page for each disk directory or continuous.
  113.                                                               Page 3
  114.  
  115.    If you have over 1000 records (200 for 48K version) in your file, then
  116.    you will need to use the SortDisk in drive A.  This program requires
  117.    you to use the DataDisk in Drive B.  It is not necessary for the BIOS.SYS
  118.    file to be on the disk at this time.  If you received the Disk is full
  119.    error and need to run COPYFILE.COM, then you could copy to a freshly
  120.    formatted Disk.  However, BIOS.SYS must be on the disk if you are creating
  121.    ORGANIZE.DAT.
  122.  
  123.    A SortDisk can be prepared by you.  It is a disk containing only BIOS.SYS
  124.    which you can create with the CP/M program SYSGEN.COM.
  125.  
  126. READFILE (ORGAUTIL.COM)
  127.  
  128.    This file simply displays the contents of ORGANIZE.DAT on the console.
  129. ORGANIZE.DAT must be in Drive A.  Use Ctrl-S to start and stop the screen.
  130. The display will stop every 22 records with the prompt -- MORE --.  If you
  131. want to view the next page, then press any key except Ctrl-C or Ctrl-B.
  132. Ctrl-C will cause the program to stop.  Ctrl-B will display the previous
  133. screen.
  134.  
  135.     Should one of the above errors mentioned occur, then this program can be
  136. used to determine if the data was saved to the disk.  It also can show you your
  137. first and last entries if a session was interrupted.  If ORGANIZE.COM finds
  138. ORGANIZE.DAT on the Disk, then it will just add to the existing file.
  139.  
  140. SEARCH.BAS
  141.  
  142.    This program requires MBASIC.COM  to run.  This was my original program
  143. for finding a program when I knew the name and not the location.  The print-
  144. outs are easier and quicker to use than this program.  I have not been able
  145. to give this one up because I find that many of the programs I'm looking for
  146. have been written since my last session with The Organizer.  And I wasn't
  147. diligent to keep up the changes in the notebook (as you were exhorted to do
  148. above).  Since the source code is included, you may edit this program to
  149. fit your needs.  It assumes a three drive system and that disks are in all
  150. three drives.  Enter Ctr-C to stop the program.  At the start of the program
  151. you are prompted for the file you are looking for.  You must enter this
  152. correctly.  If the file is not on the disk then you will receive the message
  153. Not on this Disk.  If the file is on a disk it will display the filename.
  154.  
  155.     Recently, I was looking for a program I had written a few months
  156. earlier.  As I was looking through my notebook, I realized that this program
  157. had been written since my last update, and I hadn't entered it in the note-
  158. book.  Since I had an employee waiting to use this program and I was paying
  159. her to let ME look for it I had her run this program.  (By the way, I found
  160. this one in my notebook, so I know which disk it is on.)  But there was one
  161. other problem.  I couldn't remember the name of the program.  However, I did
  162. remember that I had written it in Pascal.  Now, I have over 200 Pascal files
  163. of programs, procedures etc.  But looking through these is easier then reading
  164. through a directory of every disk.  I have approximately 1700 files at this
  165. writing.  So I had her enter *.PAS for the filename to search.  We found the
  166. file in about 15 minutes and then we were off and running.  Had this been in
  167. the notebook, I probably could have located it in less than a minute.  Without
  168. Search and without the notebook, I probably would have given up after a couple
  169. of hours.  (I say that from experience by the way).
  170.                                                          Page 4
  171.  
  172.    My current directory is printed on 32 pages, which is less than a dollars
  173. worth of paper.  The time wasted in trying to find files would pay for several
  174. directories.  Therefore, it is worth it to me to have current directories
  175. in more than one of the above formats available from ORGASORT.COM.  I would
  176. recommend you use A, B, and C.  With C you can have a separate page for
  177. each disk, then when you add a file, or delete a file, you could write it
  178. on this sheet, or draw a line through a deleted file.  This will keep your
  179. notebook current until your next session with The Organizer.
  180.  
  181.    I suggest that you experiment with 3 or 4 disks, and the above programs
  182. before doing a complete directory on your disks.  You wouldn't want to lose
  183. hours of work because you didn't know how to run the programs.  Play close
  184. attention to the instructions in each program.  Disks must be in the proper
  185. places to avoid aborting the programs.  The programs really are simple to
  186. run, so let's get Organized!
  187.  
  188.    DECEMBER 1986  -- additions to version 2.01
  189.  
  190.    COPYFILE.COM, READFILE.COM, and DST.COM have been combined into the
  191. program ORGAUTIL.COM  (ORGAnizer UTILities).
  192.    In "The Organizer" file creation program the following editing features
  193. were added.  ^S moves the cursor left. ^D moves the cursor right.
  194. ^Y deletes from the cursor to the end of the line. ^A Homes the cursor.
  195. ^F sends the cursor to the end of the line.  Backspaces deletes to left of
  196. cursor. "Delete" key and ^G delete at the cursor.  Typing any character
  197. from ascii 32 to ascii 127 inserts in the text at the cursor.
  198.    The name of the last disk entered is displayed on the screen.  Beginning
  199. with the last disk updated in the file "ORGANIZE.DAT".
  200.    Several "bugs" were fixed.  It is now easier to "back out" of the
  201. programs.  The program now computes the available disk space and is no
  202. longer limited to 90K diskettes.  Although 64 entries per disk is still
  203. the limit.
  204.    VIEW is in the ORGAUTIL program.  This program will allow you to view a
  205. text file or erase it from the disk.  Should a BDOS error occur, then
  206. execute GO.COM.  If GO.COM is not on your disk enter the following at the
  207. A>SAVE 0 GO.COM
  208. A>GO
  209. This will get you back in the program.
  210.