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 / MODEMS / MODEM / RAIDSYS1.LBR / RAIDSYS.DZC / RAIDSYS.DOC
Text File  |  2000-06-30  |  12KB  |  272 lines
  1. RAIDSYS v1.00 - 1 April 88
  2.  
  3. The Theory and Practice of Raiding:
  4.  
  5. Everyone knows that batch transfers are much more efficient than the
  6. usual file-here file-there methods we all use.  After watching users
  7. poke around on my system for the last three years and from my own
  8. frustrating experiences in determining what other systems have that
  9. I don't and what I have that they don't I finally decided to do
  10. something about it.  RAIDSYS is a method of acquisition which has
  11. proved very effective for me in the last few months.  Happily the
  12. process can be reversed - you can then easily load up a disk or
  13. two and send the raided systems all the software you have that they
  14. don't.
  15.  
  16. You will need several other programs not included in this library
  17. to use RAIDSYS.  They are: LSTOOL and PASTE - read no further until
  18. you get these libraries.  You will also need a MAST.LST of your
  19. files that uses the same format as Irv Hoff's MCAT/XCAT program, i.e.
  20. the master list looks like:
  21.  
  22. MYFILE  .LBR  -  001
  23. HISFILE .ARK  -  002
  24. THERFILE.AQM  -  003
  25.  
  26.  
  27. Background:
  28.  
  29. I started with a simple idea; find a program that will output the
  30. differences between your MAST.LST and the target systems on-line
  31. list which the DOTEMP program included in this library will produce
  32. for you.  The first program I used in this manner was CCAT26 which
  33. was designed to output the difference between two MAST.LST files.
  34. CCAT had several deficiencies not the least of which was that the
  35. output file is in a multi-column format.  Probably the biggest
  36. problem with this format is that it lacks any information about 
  37. where on the target system the files are - so you still waste a 
  38. lot of time finding out where the files are, either by manually 
  39. writing in the d/u on a hard-copy of CCAT's output or by doing a 
  40. lot of FIND (or FILE) searches on the system.  Plainly this would 
  41. not do - some more efficient method had to be found for this system
  42. to work.
  43.  
  44. To this end I wrote a complete applications program in dBASE which
  45. though awkward and slow does work.  However a lot of people never
  46. got dBASE for their CP/M machines and a lot who did never use it.
  47. I still wanted something simple and FAST.  Then I discovered yet
  48. another program designed to compare two MAST.LST files.  This is
  49. LSTOOL written by Jim Gronek and widely available on RCP/Ms in
  50. the country.  As you will see LSTOOL fits the bill completely for
  51. our raiding purposes.
  52.  
  53.  
  54. Foreground:
  55.  
  56. The aim of RAIDSYS is to produce a "want list" from your
  57. favorite system(s) that you can then use to batch download and
  58. upload files with.  So what makes an ideal "want list" you say?
  59. The most effective list of this kind is of two parts as below.
  60.  
  61.                                    
  62. ARUNZ09 .LBR D01  16k              COMP28  .LBR A01   8k       
  63. ASM-SUBS.LBR C01   8k              HSH13   .LBR A01  28k
  64. BALIAS13.LBR D01  12k              HSHFIX  .LBR A01  20k
  65. CLNDIR11.LBR D01  12k              LDSK11  .LBR B03  12k
  66. COMP28  .LBR A01   8k              IF14    .LBR C00  16k
  67. HSH13   .LBR A01  28k              ASM-SUBS.LBR C01   8k
  68. HSHFIX  .LBR A01  20k              SILENCE .LBR C01  40k
  69. IF14    .LBR C00  16k              IOPSQ   .LBR C03  68k
  70. IOPSQ   .LBR C03  68k              SYSFCP14.LBR C04  20k
  71. LDR15   .LBR F05  16k              ARUNZ09 .LBR D01  16k
  72. LDSK11  .LBR B03  12k              BALIAS13.LBR D01  12k
  73. RCP/FCP .LBR F02  52k              CLNDIR11.LBR D01  12k
  74. SAK21   .LBR F01   8k              SAK21   .LBR F01   8k
  75. SILENCE .LBR C01  40k              RCP/FCP .LBR F02  52k
  76. SYSFCP14.LBR C04  20k              LDR15   .LBR F05  16k
  77. Z3INS13 .LBR H09  12k              Z3LIB12 .LBR G02  96k
  78. Z3KEY12 .LBR G03  36k              Z3KEY12 .LBR G03  36k
  79. Z3LIB12 .LBR G02  96k              Z3INS13 .LBR H09  12k
  80.                                    
  81. Armed with lists like this for several systems you can really "make
  82. a night of it" as far as downloads go.  All you have to do once into
  83. the operating system is systematically go from du to du and enter:
  84.  
  85. A01>KMD SB COMP28.LBR HSH13.LBR HSHFIX.LBR
  86.  
  87. If the system above used ZMD you could "wipe out" B3: by making the
  88. command line appear as such:
  89.  
  90. A01>ZMD SB COMP28.LBR HSH13.LBR HSHFIX.LBR B3:LDSK11.LBR
  91.  
  92.  
  93. Preparation for Raiding:
  94.  
  95. Get the DIRectories of the system(s) you are going to raid.  They
  96. must use SD (usually named DIR.COM) or a derivative thereof that
  97. displays files as below:
  98.  
  99.          Drive A2   Files: 5/304k   Free: 1544k 
  100. EXCHLST .LBR  28k : MEX114  .LBR 136k : PCPIMP6 .LBR  32k : 
  101. IMP245  .LBR  64k : PCPHELP2.LBR  44k : 
  102.  
  103. Note that the word "Drive" must start in column 10 and the
  104. drive/user must appear in columns 16 thru 18 or DOTEMP will
  105. output meaningless data for you.  Some versions of SD have
  106. a ":" after "Drive" - DOTEMP can handle these. Some CP/M+ 
  107. systems use a form of DIR which displays like this:
  108.  
  109.  
  110. EXCHLST .LBR  28k : MEX114  .LBR 136k : PCPIMP6 .LBR  32k : 
  111. IMP245  .LBR  64k : PCPHELP2.LBR  44k : 
  112.          Drive A2   Files: 5/304k   Free: 1544k 
  113.  
  114.  
  115. You must edit these and place the d/u information above the
  116. files or DOTEMP will fail.  If you get line hits during the
  117. ASCII capture then these also must be cleaned up with your
  118. editor.  PCP users note that without XON/XOFF you will get
  119. garbaged lines when your comm program stops input and writes
  120. to disk. Normally this will effect only a line or two and if
  121. the line isn't easily editable just delete it - you will still
  122. be getting a lot of files. 
  123.  
  124. Next you must run a copy of your MAST.LST through DOTEMP. The
  125. output will look as below and will be named SYSDIR.TXT. Rename
  126. this to MAST.LST as soon as it is output.  The lack of disk
  127. numbers will distinguish it from your normal MAST.LST.
  128.  
  129.  
  130. MYFILE  .LBR  -
  131. HISFILE .LBR  -
  132. THERFILE.LBR  -
  133.  
  134.  
  135. NOTE: There are three versions of DOTEMP in the library. They
  136. allow you to selectively determine which kind of files you 
  137. want to acquire. DOTEMPA will search for files having an ARK 
  138. or LBR extension. DOTEMPL will search for files with the LBR
  139. extension only, and DOTEMPC will not filter ANY extensions.
  140. DOTEMPC will produce very large output files from some systems 
  141. as well as when it runs against your MAST.LST. which will
  142. waste a lot of paper and time for you. If you really want to
  143. do it this way be my guest.
  144.  
  145. Now run DOTEMP against each system directory you have acquired.
  146. DOTEMP will operate from the command line, or failing that, it
  147. will display all files on disk having a "DIR" extension.  As it
  148. runs it will display the current drive/user of the system being
  149. scanned and will output a SYSDIR.TXT file that looks like this:
  150.  
  151. SILENCE .LBR C01  40k
  152. SYSFCP14.LBR C04  20k
  153. SAK21   .LBR F01   8k
  154. Z3KEY12 .LBR G03  36k
  155. Z3LIB12 .LBR G02  96k
  156. Z3INS13 .LBR H09  12k
  157.  
  158. Rename these output lists to something that will remind you
  159. what system you got them from such as IRV.DIR or AB17.DIR and
  160. do no more than five or so at a time. I find that beyond five
  161. it gets pretty confusing.
  162.  
  163. In order for LSTOOL to work properly with these lists they must 
  164. be sorted on the filename.ext.  I use SUPERSORT in a batch mode 
  165. but there are a variety of free sort programs that will do the same
  166. thing for you.  Once you have them sorted you are ready for
  167. LSTOOL to do it's work.  
  168.  
  169. Using LSTOOL:
  170.  
  171. The program must be installed for your system; the documentation is
  172. quite adequate but you don't need to read it if you are in a hurry.
  173. Get into the program, select option 2 (compare two lists) and enter
  174. the following:
  175.  
  176. MAST.LST and SYS.LST
  177.  
  178. where MAST.LST is the stripped copy of your MAST.LST file and SYS.LST
  179. is the output of DOTEMP against the systems DIRectory after sorting.
  180.  
  181. LSTOOL will output a file called LIST.DIF.  Using your sort program
  182. and sort this on the drive/user columns to a second file named, say,
  183. LIST2.DIF.  Now run PASTE.COM against these two to produce your final
  184. "want list" and you are in business. Example:
  185.  
  186. PASTE NORMSYS.DIR LIST.DIF LIST2.DIF
  187.  
  188. Now you can use LISTT16 or your editor to print out the file with a
  189. header identifying the date and other information such as the phone
  190. number of the system and you are ready to go.
  191.  
  192.  
  193. Paybacks:
  194.  
  195. It is patently unfair to systematically raid systems in this manner
  196. without paying them back.  Occasionally you should reverse the
  197. process and run the program to find out what you have that the 
  198. target system doesn't.  Get the sysop's permission to upload a
  199. disk or two of files and return the favor.  One obstruction to
  200. paybacks is the ubiquitous program FOR.  FOR requires a description
  201. of each file uploaded to the system and can require a lot of tedious
  202. typing to satisfy the system.  If the sysop permits it you could
  203. make an agreement to upload to the private area or if he using ZMD
  204. you might be allowed to upload without descriptions.  You could 
  205. also write up a series of FOR files and send them ASCII as the
  206. KMD/ZMD programs ask for each description - this is still very time
  207. consuming. Personally I find FOR and LUX to be redundant - if you 
  208. really want to find out what the program does use LUX.  When I used
  209. FOR on my own system I found that two-thirds of the FOR descriptions
  210. were "Look what a great programmer I am" types and the other third
  211. were typo-ridden monstrosities. Additionally, the writing back to 
  212. disk of the FOR file can take precious minutes of your on-line 
  213. dollar.  
  214.  
  215.  
  216. Other favors:
  217.  
  218. Take a look at the sorted-on-filenames list and see if the system
  219. has any duplicate files on-line.  Multi-Megabyte systems have a
  220. way of getting out of hand and often several copies of the same
  221. program will be in several different areas.  Many sysops would
  222. appreciate your reporting these redundant files to them.
  223.  
  224.  
  225. Technical Tips:
  226.  
  227. You can easily get confused as to what order all this has to
  228. fall together and I highly recommend constructing some sort 
  229. of batch file to handle it for you.  I use ZCPR3 and an ALIAS
  230. named RAID which looks like this:
  231.  
  232. DOTEMP $1.DIR                       ; You do have a DIR ext?
  233. SSORT CFILE=SYSDIR                  ; Sorts DOTEMP output on cols 1-12
  234. LSTOOL                              ; Now to compare with MAST.LST
  235. SSORT CFILE=DIFILE                  ; Sorts cols 14-17 (d/u) to LIST2.DIF
  236. PASTE $1 LIST.DIF LIST2.DIF         ; Creates final file from DIF lists
  237. ERASE LIST.DIF,LIST2.DIF,SYSDIR.TXT ; Kills input files for us
  238. LISTT16 $1                          ; Jumps into print mode for us
  239.  
  240. Where the command line entered was:
  241.  
  242. A9>RAID AB17
  243.  
  244. And the final output file would be named AB17 with no extension.
  245.  
  246. You could easily construct a SUBMIT or ZEX (ZCPR3 only) file to
  247. do the same thing for you depending on your preferences.
  248.  
  249. Additional advice:
  250.  
  251. The CLS.DAT file for DOTEMP is set for the clear screen sequence 
  252. of a Kaypro. Configure to your own clear screen sequence and the
  253. program(s) are ready to run.
  254.  
  255.  
  256. Copyright/Source:
  257.  
  258. DOTEMP is a relatively simple program written in MBASIC and 
  259. compiled with BASCOM.  Any programmer of reasonable means
  260. could very easily write it and perhaps even better than I.
  261. However I have no intention of releasing the source for it
  262. either now or in the future.  Use as you desire for your
  263. own purposes but do not sell or mutilate it.
  264.  
  265.  
  266. Happy Raiding!!!
  267.  
  268. Thomas L. Ensminger
  269. AB17 Remote Systems
  270. [513] 879-6263
  271. 24hrs 3/12/24bps
  272.