home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / rde_v5 / rde_v5.doc < prev    next >
Text File  |  1993-08-30  |  38KB  |  635 lines

  1.        RDE ( Version_5 )  -  Upgrade and BugFix on RDE_Version_4.
  2.        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.                      ( Distribution to the Public Domain 
  4.  
  5.                              by kind permission of 
  6.  
  7.                             Mark Williams Company )
  8.  
  9.  RDE Version 5 improves the GUI on previous RDE versions in that:
  10.  
  11. i/   whenever a filename is to be chosen, it now uses a fileselector
  12.      rather than the dialogue box. The advantages are obvious.
  13.  
  14. ii/  On creating a ramdisk, the _precise_ desired size in Kbytes can
  15.      now be typed in via a dialogue box.  If 711 or 811 kbytes is
  16.      requested, then the ramdisk is configured as an exact image of
  17.      the 2 popular Floppy Formats (720kb and 820kb) - see RDE_V3
  18.      documentation below.
  19.  
  20. iii/ When removing a ramdisk in the GUI, you are no longer "forced" to
  21.      remove one of your installed disks (unless you hit the warmstart
  22.      button).  Of course there should have been a last chance to cancel,
  23.      and now there is!
  24.  
  25.  
  26.  BUG FIX
  27.  ~~~~~~~
  28.  
  29.      There has always been an obscure bug in Mark Williams' original
  30. RDY and in all subsequent RDE Versions.  The symptoms are that if a
  31. "nearly full" ramdisk is saved to file and then restored, then its
  32. contents near the top end can get corrupted.  Luckily this hardly ever
  33. happens in normal usage - as most people would leave empty work space
  34. in the saved ramdisk and make sure the files are contiguous (i.e.
  35. "reorganise" or "defragment") before saving.  Those who have used RDE
  36. to create ramdisks that are nearly-full ( usually with "read-only"
  37. utilities) might have noticed the last few files on the disk are
  38. sometimes corrupted after loading.
  39.  
  40.      I am indebted to Wojciech Surowka for diagnosing the trouble and,
  41. indeed, for suggesting a cure which is now implemented.  From my tests,
  42. it appears to have done the job.
  43.  
  44.      Basically during loading, RDE/RDY copy the contents of the saved
  45. file to high memory below PHYSTOP where the screen is.  Now if it so
  46. happens that screen interrupts ( mouse movement, flashing cursor etc.)
  47. are made during the load just AFTER the last few kbytes of contents
  48. have overwritten the screen and BEFORE the ensuing warm reset, then it
  49. is clearly possible for these contents to get corrupted.
  50.  
  51.      The cure is, of course, to set the system byte of the Status
  52. Register so that all interrupts are disabled during the load.
  53.  
  54.      Ramdisks created with Version_5 retain full compatibility with
  55. all earlier RDE versions.
  56.  
  57.      I am not aware of any remaining bug in RDE.
  58.  
  59.      Documentation(s) that accompanied previous versions are appended at
  60. the end. Newcomers to RDE can find useful hints by studying them. Users
  61. are reminded that RDE only displays its full flexibility if invoked from
  62. a shell with command line arguments. RDSH (available from the archives) is
  63. a tiny, quick-loading, shell tailored to RDE's needs.
  64.  
  65.      The current executable is about 22 kbytes and is not "packed". If
  66. you desire to pack it to about 12 kbytes or so, I recommend either ICE
  67. (version 2.4) or PFXPAK, both of which produce MINT compatible executables.
  68.  
  69.      It goes without saying that neither I nor Mark Williams Co. will
  70. assume any responsiblity for whatever (dire or otherwise) consequences
  71. that may arise through the use of this software.
  72.  
  73. Cheers,
  74. W. Alan B. Evans. ( August 27th 1993)
  75.  
  76.  
  77. ******************  PREVIOUS DOCUMENTATION WITH Version_4 ******************
  78.  
  79.     Hot on the heels of my last submission of RDE ( Version_3 ), comes
  80. Version_4 with the very significant upgrade that loaded RDE/RDY ramdisks
  81. can now be removed (dropped) IN ANY ORDER WHATSOEVER. The restriction of
  82. "Last in First Out" that ALL previous versions of RDE/RDY have had is now
  83. lifted.  Otherwise this has ALL the features of Version_3 and is FULLY
  84. compatible with all previous RDE/RDY ramdisks and saved ramdisk files.
  85. Unlike Version_3, I've packed RDE Version_4 with the ICE (v_2.4) packer
  86. which is MINT-compatible. You can unpack it with Marinos Yannikos' NAUGHTY
  87. unpacker if you like.
  88.  
  89.     Why did I submit Version_3 a week or so ago if I was working on
  90. this? Well, I WASN'T WORKING ON IT! - and the idea only occurred after the
  91. latter was submitted. I was also led to believe that this could not be
  92. done within TOS - but I persevered out of interest. After finding out by
  93. "trial and error" about OEM cruft links and the way TOS boots-up its
  94. hard disk partitions I finally could see how this (very desirable) feature
  95. could be incorporated. For those who prefer to have as much RAM as possible
  96. and work with utilities installed on RDE ramdisks (like me!) this will make
  97. life much easier. 
  98.  
  99.     For example, I could be writing a paper within my SIGNUM2 ramdisk
  100. when I find I need to finalise some data analysis with Fortran. So I wish
  101. to load my RDE FORTRAN installation but, da*?*n it, I had forgotten to
  102. remove that CALAMUS ramdisk installation I was previously working with
  103. BEFORE loading the SIGNUM2 one and now there is no room for the FORTRAN one
  104. as well on my 4 Mbyte machine. With Version_4 it becomes possible to get
  105. rid of that CALAMUS ramdisk I've finished with to make room to load the
  106. FORTRAN without disturbing the SIGNUM2 installation at all (Of course -
  107. there will be a warm reset - so you must save your document to file on
  108. the ramdisk first - come to think of it you'd HAVE TO anyway with SIGNUM2
  109. as it does not allow the execution of external programs from within itself.
  110.  
  111.     I'm sure that other RDE users can see similar benefits. This now
  112. makes me extremely envious of Falconers and TT'ers with 32 Mbytes or so.
  113. (Thanks to Ofir Gal who has verified that Version_3 works OK on a Falcon.)
  114. They could install huge applications (given that Version_3 removed the bug
  115. that previously had limited RDY ramdisks to no bigger than about 2036 kb)
  116. or a huge number of smaller applications simultaneously. I must get one
  117. of those Falcons..... but with Maximum RAM as a PREREQUISITE so that I
  118. can defragment whole Hardisk Partitions (<= 16 Mbytes) in safety on a
  119. huge suitably configured RDE ramdisk in a few seconds (minutes?) only. The
  120. only risk is in "sector copying" the defragmented ramdisk (with DFT.TOS)
  121. back to the Hardisk Partition. But this should be QUICK (few seconds) and
  122. you'd have to be unlucky indeed for the electricity supply to fail during
  123. that time!!
  124.  
  125.     My apologies to the archivists for bothering them again so soon after
  126. Version_3 was downloaded. But I guess they must be used to this phenomenon
  127. for I know of few authors who can discipline their minds not to continue
  128. thinking about the task that's occupied a hefty % of their "thinking time"
  129. for the previous few days - so if further good ideas occur to them....!!
  130. I guess this must be a phenomenon well-known to software archivists &
  131. justifies an appropriate "delay-time" before submissions are archived
  132. that sometimes annoys "over-keen" authors.
  133.  
  134.         For the curious, RDE ramdisks install themselves at the
  135. top of memory and decrement PHYSTOP to allow space. Removing a previously
  136. loaded ramdisk leaves the "stack" fragmented - and it is necessary to pull
  137. its tail up to fill the gap. However you must do this in a way that TOS
  138. will not complain about and plunge your machine into utter darkness out
  139. of which re-birth (i.e. a cold boot) is the only solution. This involves
  140. monitoring the values of several "vectors" held within RDE's bootsectors
  141. to take into account the ensuing change of addresses of the routines these
  142. vectors point to as well as altering in a different way the cruft-link
  143. pointers that RDE uses to "find" its disks etc. etc. Anyway now I've got
  144. the sums right - the whole operation happens usually within about a second
  145. and reliably.
  146.  
  147.     There are a few minor quirks. If you remove your "booting" ramdisk
  148. then after a warm reset booting defaults to A:\ (all this assumes you do
  149. NOT make your Hardisk (if any) boot-itself from C:\ - Rather Harddisks
  150. MUST be woken up AFTER the ramdisks have loaded - preferably from a prog.
  151. such as AHDI in the AUTO folder of a "booting" RDE ramdisk (see IQ_BOOT
  152. the intelligent booting sourcecode for a booting program that I submitted
  153. with Version_2 of RDE last year). If subsequently you reload your booting
  154. ramdisk off A:\ you will get a normal "loading" warm reset usually followed
  155. (at least with ICD Harddisks) by another warmreset after which your booting
  156. ramdisk will take over control. There is nothing to worry about in this -
  157. it is normal and your data should be intact. HAVING SAID THAT I EMPHASIZE
  158. THAT NEITHER I (nor Mark Williams Co. who developed the original RDY)
  159. CANNOT BE RESPONSIBLE FOR ANY LOSS OF DATA, ACCIDENTS ETC. THAT MIGHT
  160. ENSUE FROM THE USE OF THIS SOFTWARE. THIS SOFTWARE IS NEW! AND, AS SUCH,
  161. SHOULD BE TREATED WITH CARE (but it's passed all my tests so far - wabe).
  162.  
  163. Good Luck,
  164. W. Alan B. Evans.
  165. [wabe@ukc.ac.uk] - May 27th 1993.
  166.  
  167. ******************  PREVIOUS DOCUMENTATION WITH Version_3 ******************
  168.  
  169.    RDE ( Version_3 )  -  Some upgrades on RDE_Version_2 + some bug fixes.
  170.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  171.                      ( Distribution to the Public Domain 
  172.  
  173.                              by kind permission of 
  174.  
  175.                             Mark Williams Company )
  176.  
  177. PREAMBLE:
  178. ¯¯¯¯¯¯¯¯¯
  179.     Mark Williams Co's RDY always had a few "bugs" that, on the whole,
  180. were unimportant until "larger" ST's i.e. the Mega 2 and Mega 4 machines
  181. came out. One early bug caused a failure to load on 4-Mbyte machines as
  182. the offset was not allowed for in checking whether an address is in RAM
  183. or not. This was soon corrected before MWC left the ST-scene. Another
  184. (less serious) bug prevented Ramdisks of "total" size greater than 2047kb
  185. from loading properly even on 4-Mbyte machines and this has remained in
  186. all versions of RDY/RDE to date. Seldom does one wish to have a ramdisk
  187. greater than 2 Mbytes even if we have 4-Mbytes of RAM (for we can always
  188. load a second one with another volume label) - so this bug did not trouble
  189. most users. However there are a few occasions when it is desirable to have
  190. ramdisks of size 3 Mbytes and above - and on the Falcon or TT ( I "think"
  191. RDE should work OK on these but I have not had the means to test it - and
  192. would value hearing from anyone who use it on these machines) it is possible
  193. to have so much RAM that I expect that Ramdisks of 8 Mbytes and more may
  194. soon become commonplace. Of course this opens up a quick way of reorganising
  195. (or defragmenting) hard disk partitions in a completely safe way provided
  196. they are not too big to be loaded on to the ramdisk. This is especially
  197. favourable with RDE ramdisks for they can be configured to look exactly
  198. like your hard disk in structure (excluding BGM [i.e. logical sectors
  199. sizes > 512bytes] partitions) e.g.
  200.  
  201.     setenv CMD MAKE ; rde SIZE=8000 FATSIZE=16 FATS=24 ROOT=50
  202.  
  203. would make an embryo ramdisk of size 8000 clusters, with 24 sectors of
  204. 16-bit Fats and ROOT directory size of 50 sectors. Then you could transfer
  205. your entire harddisk partition to such a ramdisk - using a sector copier
  206. like DFT.TOS (included) - then defragment the ramdisk which is VERY quick
  207. with Atari's CHKDISK3.PRG or Simon Poole's REORG.PRG - and then "DFT" the
  208. defragmented ramdisk back on to the partition. Alternatively, of course,
  209. if you have no defragmenting program it is almost as quick to sequentially
  210. copy your harddisk files and directories on to the ramdisk, where they
  211. will be contiguous and then DFT (or copy again) the ramdisk back to the
  212. cleared partition.
  213.  
  214. THE MAIN UPGRADE - ( NO  SIZE < 2037kb  restriction)
  215. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  216.     Anyway, as you'll have gathered by now, I managed to find and
  217. cure the assembler "bug" that prevented RDY/RDE's handling of large ramdisks
  218. and so RDE Version_3 is currently offered. For the curious the bug ocurred
  219. becase the loop instrucuton "dbf" only uses a 16-bit counter - a "common"
  220. oversight according to Tim King in his 68000 Assembly Language Book!! The
  221. new Version_3 is completely compatible with RDE Version_2 (released in
  222. March 92) and with the "All TOS" saved ramdisk files made with this.
  223.  
  224.     If you use RDE V_3 from the Desktop using the GUI, you will find
  225. that I have revised the selection of Ramdisk button-sizes to reflect the
  226. larger sizes now possible (the largest GUI-selectable size is now 3.5 Mbytes).
  227. I have included the buttons-sizes marked "720k" and "820k" which, if
  228. selected, and all default values then chosen will create your Ramdisk in
  229. two favourite "Floppy" Formats - the standard Atari "720k" double-sided
  230. format, and the 82-track, 10-clusters per track format that you get (for
  231. example if you use DCFORMAT). I have yet to experience an ST or STE for
  232. which this larger format does not work perfectly. These are useful if you
  233. want to sector copy a floppy onto a Ramdisk (for "defragmenting" perhaps?)
  234. using DFT.TOS or similar. Note that your sector copier MUST NOT copy the
  235. bootsector. DFT.TOS checks for FSIZE and FATSIZE compatability before it
  236. will copy anyway. Of course, you can also create these floppy formats
  237. from a shell (e.g. GULAM ) also with (for example)
  238.  
  239.   setenv CMD MAKE;rde DISK=F SIZE=711 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=0
  240.   setenv CMD MAKE;rde DISK=D SIZE=811 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=0
  241.  
  242. or, the equivalent command in RDSH would be
  243.  
  244.     m F 711 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=0
  245.     m D 811 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=0
  246.  
  247. ( but note that   ROOT=7 , FATSIZE=12 are superfluous as these are the
  248. default values on RDE Version_3 anyway. To see what the defaults are
  249. give the argument CMD=HELP to RDE.TTP (i.e. RDE.PRG renamed to RDE.TTP ).
  250. Or, from Gulam you can enter
  251.  
  252.     setenv CMD HELP; rde.prg
  253.  
  254.     Note, in the above, I have put CLUSTERS=0, so that the ramdisk
  255. complies exactly with floppy structures. However TOS (no doubt for some
  256. obscure GOOD reason? ) always wastes 2 clusters of disk space at the high
  257. end. If you add up the number of useable sectors on a conventional floppy
  258. you will find the total is 4 short of the total "formatted" number. Mark
  259. Williams Co. incorporated an ingenious scheme into their RDY to reclaim
  260. these "lost clusters" from being wasted by TOS. Effectively it involves
  261. telling TOS there are 4 sectors more on the ramdisk than you actually
  262. have (by upping the cluster number in the boot parameter block) and then
  263. marking the last two clusters as "bad" in the FATs. This allows usage of
  264. the lost clusters and is what happens if CLUSTERS=1 is specified. By the
  265. way this also appears to work on Floppies!! - so if you can be bothered,
  266. you can make each formatted disk you have hold 2 kbytes more! - but I
  267. digress. I can think of no good reason why CLUSTERS=0 need ever be chosen
  268. ( apart from exactly mimicking other media ). So, to have a floppy like
  269. ramdisk and 2 kbytes more left-over memory, you could use
  270.  
  271.   setenv CMD MAKE;rde DISK=F SIZE=709 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=1
  272.   setenv CMD MAKE;rde DISK=D SIZE=809 ROOT=7 FSIZE=5 FATSIZE=12 CLUSTERS=1
  273. (i.e.  SIZE decreased by 2 but now with CLUSTERS=1 - the default anyway)
  274.  
  275. Other Minor Mods:
  276. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  277.  i/    One of the useful features of RDSH was its ability to alter the
  278. Disk Drive Label of a saved RDE ramdisk file. For example you may wish to
  279. load another ramdisk which you've just "happened" to name with the same
  280. drivelabel as one you've already got loaded. The solution here would be
  281. to alder the drivelabel of the file you wish to load to a new label that's
  282. unused. Then it can be loaded and, afterwards, one would normally change
  283. the drivelabel back to its original label. Now I've included this feature
  284. in RDE_V3.1 as an additional MENU item in GUI mode. You simply select a
  285. ramdisk file and after click on the driveable button you wish its label to
  286. be changed to. RDE will check that the file is indeed a ramdisk file and
  287. report on the change made. This is also possible in the command line mode
  288. from a shell with the new command "ALTER". For example to alter the label
  289. of a saved ramdisk file   SIG_RAM.PRG from  I:\  to J:\ (say), just enter
  290.  
  291.     setenv CMD ALTER ; rde.prg  FILE=SIG_RAM.PRG  DISK=J
  292.  
  293. and if all went well you will get a message:
  294.  
  295.   RDE_File: SIG_RAM.PRG  | | DriveLabel I altered to J   
  296.  
  297. if all went well. Needless to add, it will NOT be possible to alter the
  298. drivelabels of "packed" saved ramdisk files without unpacking them.
  299.  
  300.  ii/    In "CREATING" a ramdisk from the GUI, you can now opt
  301. for either 12 or 16 bit fatsize. In the "Get Data on a Ramdisk" and "Save"
  302. options the only buttons now active are those that pertain to genuine RDE
  303. loaded ramdisks (and NOT ALSO those of any Hard Disk partitions that may
  304. be present as in previous Versions).
  305.  
  306.  iii/    There was a small format bug in older Versions of RDY\RDE that
  307. caused some ridiculous values to be output when it informed you that the
  308. set value of FSIZE (no. of FAT sectors) was too small for the SIZE of the
  309. Ramdisk and that it was adjusting it upwards to ??*?**!!. This was caused
  310. because a "long" was printed using a "%d" (i.e. word) format. This is now
  311. corrected. To set FSIZE you must be in command line invocation (i.e. shell)
  312. mode. I could not see much point in setting it from the GUI. Apart from
  313. making floppy or hard-disk compatible ramdisks, there is no point in setting
  314. it to any other value than Mark Williams Co's "least-value needed" which was
  315. the "default" value on their original RDY.
  316.     
  317.  iv/    I have also altered the ORDER in which the LIST of loaded ramdisks
  318. is displayed ( with the command   ' setenv CMD LIST ; rde '   ) entered from
  319. a shell (like GULAM) or using RDSH.PRG (the mini-shell tailored for RDE that
  320. is already in the Public Domain). The order is now according to the order in
  321. which they were LOADED - which is useful as it reminds you which one can be
  322. removed (Dropped) since dropping must be done on a "Last in, First out"
  323. basis. If you use the GUI to remove ("DROP") a ramdisk, you no longer have
  324. to select it - the "last-loaded" is the ONLY one offered to be sacrificed.
  325.  
  326. Ancilliaries & Advice:
  327. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  328.     A few tutorial(?) points are in order. If you wish to invoke RDE
  329. using its GUI from a shell such as GULAM, don't forget to unsetenv the CMD
  330. environment variable first - otherwise it will not load i.e. use
  331.  
  332.     'unsetenv CMD ; pushd $rdedir ; gem rde.prg ; popd'
  333.  
  334. which you could usefully define as a GULAM alias in your GULAM.G file i.e.
  335.  
  336. set    rdedir    d:\        # wherever RDE.PRG & RDE.RSC reside
  337. alias    g_rde    'unsetenv CMD ; pushd $rdedir ; gem rde.prg ; popd'
  338.  
  339.     The sector copier, DFT.TOS (included) is an upgrade on DFT.PRG
  340. that exists as part of RDUTILS in the public domain - for it now uses
  341. the largest buffer it can get (with Malloc) to do its sector copying.
  342. The previous DFT.PRG assumed you had enough left-over RAM to copy the
  343. whole disk in just 1 go. This is hardly likely even on a 4-Mbyte machine
  344. if you use the larger RAM sizes now available and they are moderately
  345. "full". I would also advise you to get DESKTOP.PRG if you wish to get
  346. the DESKTOP.INF loaded to hard disk drive C:\ (if present) from your
  347. "BOOTING" RDE ramdisk. This is essential for TOS versions 1.04 upwards.
  348. Ideally, for the latest TOS 2.06, the desktop NEWDESK.INF (or DESKTOP.INF)
  349. should at boot-time be copied from the booting ramdisk to C:\NEWDESK.INF to
  350. over-ride any previous NEWDESK.INF that may have been there. The
  351. current DESKTOP.PRG that was bundled with RDSH.PRG does not do this.
  352. Da?n!! - I'd better compile an upgrade and include it & at the same time
  353. possibly save you some hassle if you use TOS 2.06 (done! - DESKTOP.TOS,
  354. an upgrade on DESKTOP.PRG is included. It is still less than 2 clusters in
  355. size and, as a bonus, displays your TOS Version at boot-up. You'll probably
  356. get tired of this! - so the sourcecode of DESKTOP.TOS is also included so
  357. you can compile your own version of it - tailored to do some other tasks
  358. also perhaps. With older TOS'es it will work exactly as Version_1 - wabe).
  359. The "brief" documentation with the earlier version is included as this was
  360. involved no effort on my part and could be useful to first timers using
  361. RDY/RDE. See also some new comments in the sourcecode.
  362.  
  363. MINT COMPATIBILITY - Careful how you "pack" it!
  364. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  365.     And, that's about all for now - except that the binary RDE.PRG
  366. is now included "unpacked" in contrast to some previous postings which
  367. were packed with the POMPEY packer. Unfortunately this made them MINT-
  368. incompatible, that led to a few unneccessary hiccups with some users.
  369. Incidentally this also applies to a previously posted version of RDSH -
  370. so, if yours is MINT Incompatible, unpack it with the Pompey Packer (or
  371. possibly with that "Universal Unpacker" of Marios Yannikos, NAUGHTY.PRG).
  372. If you wish to pack RDE.PRG, then I'd recommend the ICE (v_2.4) packer
  373. or PFXPAK which retains MINT compatibility. If you NEVER use the GUI,
  374. then change the name of RDE.PRG to RDE.TTP and discard RDE.RSC.
  375.  
  376.                    Good Luck,     W. Alan B. Evans,
  377.                                   [wabe@ukc.ac.uk] - May 19th 1993.
  378.  
  379.     Below is listed the documentation that accompanied previous releases
  380. of earlier versions of RDE.
  381.  
  382. *****************************************************************************
  383.         RDE ( Version_2 ) "ALL-TOS" compatible form with enhanced GUI
  384.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  385.             of Mark Williams Co.'s "RDY" Reset Survivable Ramdisk
  386.             ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  387.                      ( Distribution to the Public Domain 
  388.  
  389.                              by kind permission of 
  390.  
  391.                             Mark Williams Company )
  392.  
  393.        This  latest  version of RDE.PRG is compatible  with  ALL  TOS_versions 
  394. tested to date - and so,  unlike my previous RDE offering,  (see documentation 
  395. below)  is  a genuine upgrade enabling RDY Fans to painlessly upgrade  to  the 
  396. latest TOS machines and continue to use their saved RDY installations. To load 
  397. "old"  saved ramdisk files on TOS 1.4 (and upwards) machines they need  to  be 
  398. converted.  This  is most easily achieved using option "U" of the  mini  shell 
  399. RDSH.PRG  (see  separate  offering) - but could also be done  by  loading  the 
  400. ramdisk on an old TOS ST and then saving it with the new "All-TOS" RDE.PRG.
  401. Files  saved with the new RDE will load without problems (i.e.  bombs) on  any 
  402. ST.  I  have also slightly enhanced RDE's Graphics User Interface in that  now 
  403. all  drive  letters C:\ through to P:\ are selectable  in  this  manner.  Some 
  404. parameters (e.g.  FSIZE,  FATSIZE, ROOT, SIZE, CLUSTERS, HELP etc.) must still 
  405. be  set  from a shell - which is why RDSH.PRG is currently also  offered  (see 
  406. RDSH.DOC for details) - but beginners will doubtless prefer the GUI. One novel 
  407. and very useful option in RDSH is option "A" which allows the Drive Label of a 
  408. saved RDE/RDY File to be altered - very useful if one wishes to simultaneously 
  409. load  two ramdisks saved with the same drive label!  - and for changing  drive 
  410. labels  to higher alphabetic positions to accommodate that huge new  hard-disk 
  411. you've  just  bought  whose partitions insists on  monopolising  many  of  the 
  412. earlier  drive letters.  I have also made other minor improvements which  only 
  413. "old  hands" who are very familiar with the old RDY/RDE will notice  e.g.  the 
  414. new  RDE will not ask to Load a newly created Ramdisk if its drive  letter  is 
  415. already used etc.
  416.  
  417.      Note  that  for  an installation-dependent  desktop  from  "booting"  RDE 
  418. ramdisks when disk C:\ is present on the Newer TOS machines still requires the 
  419. DESKTOP.PRG utility in the "booting" ramdisk's AUTO folder (see below). I have 
  420. included  a  new  DESKTOP.PRG  version with some  enhanced  features  that  is 
  421. distributed with the RDSH.PRG utility (Read the DESKTOP.DOC file for details). 
  422.  
  423.      Finally, this version obviates the need for the earlier RDY - for which I 
  424. had  requests  from Netters on diverse occasions.  Of course,  this  is  still 
  425. distributed  with the Mark Williams "C" software - though they "may"  soon  be 
  426. including an "ALL-TOS" RDY that is almost identical to this (save for "default 
  427. values" that comply with their Manual).
  428.  
  429.      The present RDE.PRG is quite small (~11000 bytes) having been packed with 
  430. the POMPEY Packer (which,  though slow,  produces good compaction). If the GUI 
  431. is not desired, it may be renamed RDE.TTP (in the which case the Resource File 
  432. RDE.RSC will not be needed).
  433.  
  434.      I reproduce (below) the original documentation that I wrote for Version 1 
  435. of RDE - apart from the novelties mentioned above, it still applies.
  436.  
  437.                    Good Luck,     W. Alan B. Evans,
  438.                                   [wabe@ukc.ac.uk] - March 22nd 1992.
  439.  
  440.  *****************************************************************************
  441.  
  442.        RDE  -  STE-Compatible form of Mark Williams Co.'s "RDY" Ramdisk.
  443.  
  444. ( Distribution to the Public Domain authorised by MWC [Doug Peterson] Jan 91)
  445.  
  446.         Let  it be clearly herein stated and understood that I can  assume  no 
  447. responsibility whatsoever from the use of this modified software - and, as MWC 
  448. have  authorised  its  PUBLIC  DOMAIN  distribution  WITHOUT  benchtesting  my 
  449. modifications, neither can they be held responsible for any unforeseen adverse 
  450. effects consequential to its use.           Alan Evans (Email: wabe@ukc.ac.uk)
  451.                                                
  452.  
  453.      Mark  Williams C's  "RDY"  configurable,  saveable-with-contents-to-file, 
  454. self-loading, eternal ramdisk utility has, from its inception, reigned supreme 
  455. amongst sophisticated reset-survivable ramdisks.  As fans of "RDY" will  know, 
  456. you  can  have as many RDY-ramdisks simultaneously loaded  as  volume  letters 
  457. allow and further one can be made a "booting ramdisk" so that the ST (on  warm 
  458. reset)  will boot from the auto-folder present on the  "booting"  ramdisk.  In 
  459. fact,  since I purchased Mark Williams C (version 2.1.7 on disk label) in 1987 
  460. and  thereby found how convenient an installation of that software that  "RDY" 
  461. afforded, I naturally used it to install ALL my various ST packages (Wordplus, 
  462. Signum, Prospero Fortran, Degas Elite etc. etc.) on "booting" RDY disks stored 
  463. as rather large executable (.PRG) files (which nevertheless load very quickly) 
  464. on floppies.  Since those days the advent of "executable" packers such as PACK 
  465. and  now  the Lharc based PFXPAK has not only meant that the  executables  one 
  466. puts  on the ramdisk can be shrunk in size but the saved (.PRG) ramdisk  files 
  467. can  themselves be packed ( reasonably quickly with PFXPAK - but don't try  it 
  468. with PACK-ICE!!) - which made large installations possible on a single  floppy 
  469. (I normally format to 82 tracks and 10 sectors giving 820 kbytes using  Double 
  470. Click's  DCFORMAT  - and have experienced next to no failures).  In  this  way 
  471. (with  PFXPAK) I have installed the ENTIRE Mark Williams C (v_3.0) plus  their 
  472. C-Source Debugger and Resource Editor on a Single Floppy!  (except I used  the 
  473. smaller  (and  better?) Gulam shell rather than "msh") which loads in about  a 
  474. minute onto my Mega ST-4. Who needs expensive, troublesome hardisks?
  475.  
  476.            Recently  I  decided to "upgrade" and buy myself  an  STE  (with  4 
  477. Mbytes) for home use.  Imagine my dissappointment when I then discovered  that 
  478. none  of my numerous "RDY" installations worked - "bombs" appeared  each  time 
  479. they tried to load.  I FAXED Mark Williams Co.  to ask if there was an upgrade 
  480. that  worked  on the Rainbow TOS 1.6 - only to be told in one  brief  sentence 
  481. that,  as I have the sourcecode,  I should HACK out a solution to the  problem 
  482. myself! True I had the sourcecode (but only that which came with version 2.1.7 
  483. - which would not work satisfactorily on Mega-4 machines - when I upgraded  to 
  484. version  3.0,  MWC supplied a new "rdy.prg" binary that had cured this  Mega-4 
  485. bug  but  supplied no sourcecode for the new version.  So much  for  so-called 
  486. "Software-Support"  - despite my MWC manual boasting of "SOFTLINE -  Telephone 
  487. Support"  to  registered  users (such as I!).  Neither did  I  understand  the 
  488. differences between the new TOS and previous TOSses(?) - and I really  thought 
  489. it  unreasonable  that  MWC  appeared not to care at  all  for  its  dedicated 
  490. clientele  -  as  this  just was not a trivial problem  in  C  but  caused  by 
  491. Operating System changes that are kept secret from "amateurs" like myself  and 
  492. only  revealed  to  "Sofware Developers" who pay a  substantial  sum  for  the 
  493. priviledge (How else would they keep abreast of amateurs?).
  494.  
  495.            Despite my annoyance at MWC's response to my plight,  I hated  more 
  496. the prospect of not being able to use my "RDY" installations on my  (otherwise 
  497. very  satisfactory) new STE - and so I began to HACK.  As you can see  I  have 
  498. been  successful  -  the trouble being traced to  RDY's  "non-standard"  RESET 
  499. procedure.  Atari  UK,  despite their willingness to help - simply  could  not 
  500. advise  me  of the proper RESET procedure - but at a Computer Show  in  London 
  501. early  this  New Year,  I mentioned this to Mike  Vedermann  (of  Double-Click 
  502. Software) and,  immediately he informed me that,  by definition,  the required 
  503. RESET Vector can ALWAYS be found by *((char **)0x4) - which is required by the 
  504. 68000 assembly code - which turned out to be the vital info I needed.
  505.  
  506.         Since  Mark Williams Co's Doug Peterson had informed me that "RDY"  is 
  507. now  "PUBLIC DOMAIN" - I asked MWC (via Doug Peterson) for permission -  which 
  508. swiftly  forthcame - to  release this  STE-compatible  version of "RDY" to the
  509. PUBLIC DOMAIN  Networks in  order  to  save  other  "RDY"-Fans  the hassle  of
  510. similarly spending a lot of time "hacking about" to get their installations to
  511. work - possibly without eventual success. It  is  rather  important  to  avoid
  512. confusion with "RDY", as the STE-version will  NOT work  satisfactorily on the
  513. older  TOSses (to version 1.2) - which is why I have called the STE-compatible
  514. version "RDE" (I never  could fathom what the "Y" in "RDY" stood for anyway!).
  515. If you try "RDE" with the older TOSses "bombs" will result.
  516.  
  517.           So  herin please find "RDE.PRG"  and its resource file  "RDE.RSC"  - 
  518. but see below. "RDE.PRG"  is PFXPAKed as this reduces it to about 11,798 bytes 
  519. rather than 17865 or so - you can recover the unpacked binary using the latest 
  520. "lharc" or by     "pfxpak -u rde.prg  bare_rde.prg"  .
  521.  
  522.           There is another small problem.  It appears that the new RAINBOW TOS 
  523. will  insist  on  taking its DESKTOP.INF from the "C"-drive if  there  be  one 
  524. despite booting from the auto folder of the booting  "RDE" ramdisk.  So how do 
  525. you  get  an  installation-dependent desktop?  My solution  is  to  save  your 
  526. tailored  "DESKTOP.INF"  file  on your "booting" RDE  installation  (as  with 
  527. previous  TOSses)  -  but,   now  be  sure  to  include  the  little   utility 
  528. "DESKTOP.PRG" in the auto folder.  On boot-up this checks to find if DRIVE C:\ 
  529. exists,  in  the which case it copies the DESKTOP.INF file on the  ramdisk  to 
  530. "C:\DESKTOP.INF" - else it does nothing.  This will OVERWRITE any  DESKTOP.INF 
  531. there may be on C:\ however - so the next time you boot-up your system from  a 
  532. floppy  disk  A:\  (with AHDI.PRG in its AUTO folder) you may  get  a  strange 
  533. desktop.  If you care about this,  copy your preferred boot-up DESKTOP.INF  to 
  534. your "boot-up" (A:\)floppy disk - and put DESKTOP.PRG in its AUTO folder  also 
  535. - but after "AHDI.PRG" naturally.
  536.  
  537.           Oh,  and FINALLY,  I should mention that I have altered some of  the 
  538. "defaults"  of "RDE" - as compared with the original "RDY".  As fans will  be 
  539. aware,  "RDY" recognises several "Environment VARIABLES" and, because of this, 
  540. it  is  optimal to invoke it from a shell like Gulam - in the which  case  you 
  541. might as well rename it "rde.ttp" and discard "rde.rsc".  As you can discover 
  542. with the shell command (entered from "me" or Gulam):
  543.  
  544.                  setenv CMD HELP;rde
  545.  
  546. the new default settings and list of all Environment VARIABLES is as follows:
  547.  
  548. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  549.                     rde - rebootable ram disk
  550.         
  551.         Copyright 1987, Mark Williams Company, Chicago
  552.         
  553.         commands passed in the environmental variable 'CMD'
  554.         
  555.         LIST - provides a list of installed RAM disks.
  556.         MAKE - constructs a new RAM disk executable binary.
  557.         LOAD - loads a saved RAM disk 'FILE' into memory.
  558.         SAVE - saves active RAM disk 'DISK' with its contents to 'FILE'.
  559.         DROP - removes an active RAM disk from memory
  560.         HELP - presents information.
  561.         
  562.         parameters passed in other environmental variables
  563.         
  564.         DISK - drive identifier for RAM disk (default = G).
  565.         SIZE - size in kilobytes of the RAM disk data area (default = 200).
  566.         ROOT - size in sectors of the root directory (default = 7).
  567.         FILE - file name for RAM disk image (default = rdedisk.prg).
  568.         BOOT - should the disk install itself as the boot device (default = 0).
  569.         FATSIZE - should the disk use 12- or 16-bit tables (default = 12)
  570.         CLUSTERS - should the disk recover two lost clusters (default = 1)
  571.         FSIZE - specify the number of FAT sectors (default = least needed)
  572.  
  573. ______________________________________________________________________________
  574.  
  575.           Note I have changed the default drive identifier to G:\ (from C:\  - 
  576. after  all many ST'ers now DO have Hard Diskdrives) for when a new ramdisk  is 
  577. made (setenv CMD MAKE). The default FATSIZE is now 12 bits (rather than 16) so 
  578. that  "RDE"'s fats and disk-sectors correspond to nearly all floppy  formats. 
  579. Usually on most floppies each FAT table occupies 5 sectors so,  if you want to 
  580. configure your "RDE" like a floppy (apart,  of course,  from "RDE"'s  rather 
  581. special bootsector - ensure that you setenv FSIZE 5 before MAKEing the ramdisk 
  582. -  otherwise "RDE" will choose its own FSIZE - which depends on the  SIZE  of 
  583. the  ramdisk  that  is made.  For some reason - the maximum  size  of  ramdisk 
  584. possible  appears  to be 2 Mbytes (even on Mega-4's  or  STE-4Mbyte).  Let  me 
  585. hasten to add that this is the case with the original "RDY" as well as  "RDE" 
  586. also. If this is a "bug" it is to do, at least partially, with the FSIZE value 
  587. that is chosen.
  588.  
  589.           Here  are  a  few  useful  "RDE" or  "RDY"  commands  to  help  the 
  590. uninitiated  to get used to this most sophisticated piece of software that  is 
  591. now "PUBLIC DOMAIN"
  592.  
  593. 1/     setenv CMD MAKE;setenv DISK H;setenv BOOT 1;setenv SIZE 900;rde
  594. OR                     rde CMD=MAKE DISK=H SIZE=900 BOOT=1
  595.       (makes an embryo "booting" ramdisk H:\ of size 900k as the "default" 
  596.       filename "rdedisk.prg". Simply executing this loads the ramdisk). 
  597.  
  598.         Note  the second command is shorter and "should" achieve the same  end 
  599. (but in my experience it is,  on the whole,  better to setenv the  environment 
  600. variables before calling "RDY").
  601.  
  602.  
  603. 2/                          setenv CMD DROP;rde DISK=H 
  604.                 (removes ramdisk H:\ - which is followed by a warm reset) 
  605.  
  606.  
  607. 3/       setenv CMD SAVE;setenv DISK H;setenv FILE c:\mwcram.prg;rde
  608. OR                    rde CMD=SAVE DISK=H FILE=c:\mwcram.prg
  609.         Saves   the   ramdisk  H:\  with  all  its  contents   to   the   file 
  610. "c:\mwcram.prg"  onto a hard disk C:\ presumably - but C:\ "could" be  another 
  611. RDE ramdisk, for example!) etc. etc.
  612.  
  613.                                                Good Luck,
  614.                                              
  615.                                                 Alan Evans, 
  616.                                                 University of Kent,
  617.                                                 Canterbury,
  618.                                                 Kent, CT2 7NR, UK.
  619.                                                 ( Email: wabe@ukc.ac.uk )
  620.  
  621. PS:     My  factual  account  above,   which  underlines  the  farcical  MWC's 
  622. "software  support"  for the ST that now seems to exist,  probably  arise  (as 
  623. knowledgeable  3rd parties "reliably" inform me) because MWC have now  "given-
  624. up"  developing  software  for  the  ST  and  have  alledgedly  moved  on   to 
  625. financially-lusher  pastures  -  I  hope these rumours  prove  to  be  without 
  626. substance ( not that I wish any financial hardship on MWC you  understand!!  - 
  627. but,  rather,  simply bemoan the lack of any future prospects of more  elegant 
  628. and  masterly software contributions to the ST-scene as this  gifted  Software 
  629. House have come up with in the past).  MWC's generosity in making "rdy" PUBLIC 
  630. DOMAIN  -  and permitting this modified "rdy" to be distributed  deserves  the 
  631. HIGHEST COMMENDATION - even though this generosity - if the rumours be true  - 
  632. "might" have stemmed from a guilty conscience re.  ST support?  Who  cares?  - 
  633. facts are facts - and things are seldom ENTIRELY good or bad, are they? 
  634.  
  635.