home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / d / directory_opus / magicdopusdisk.dms / in.adf / Goodies / DopusReq / Un-DMS.doc < prev   
Encoding:
Text File  |  1992-08-18  |  6.1 KB  |  168 lines
  1.                 UnDMS Requestor for Directory Opus v3.50+.
  2.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. Introduction
  4. ~~~~~~~~~~~~
  5. This requester was created because I wanted a nice DMS/UnDMSer which was
  6. integrated into Directory Opus.  The new user requesters in Directory Opus
  7. just made it possible to integrate all the options nicely.
  8.  
  9.  
  10. Requirements
  11. ~~~~~~~~~~~~
  12. Format, DiskCopy and DMS _must_ be in PATH.
  13.     eg.
  14.  
  15.         If DMS is in DH0:Archivers, then you should have:
  16.                 Path DH0:Archivers Add
  17.         in your s:startup-sequence
  18.  
  19. DopusReq: _must_ be assigned to where the requesters are kept.
  20.     eg.
  21.  
  22.         Assign DOpusReq: Sys:DOpus/Requesters
  23.  
  24.  
  25. Installation
  26. ~~~~~~~~~~~~
  27. WB1.3 users should assign env: to ram: and envarc: to s:.  This hasn't been
  28. tested but should work.  If it doesn't it's another reason to upgrade!
  29.  
  30. Go into the Directory Opus configuration and setup a new gadget called DMS.
  31. In the entry type, toggle the entry type gadget until you see "Requester"
  32. appear.  Then enter the path and name of the requester file into the string
  33. gadget.  This entry line should look something like:-
  34.  
  35.                 Requester   DopusReq:UnDMS.creq
  36.  
  37. The flags enabled should be:-
  38.  
  39.         Directory Opus to front
  40.         Do all files
  41.         Output window
  42.         Workbench to front
  43.  
  44. All other flags should be off.
  45.  
  46. If you want DMS Text to display properly, go into the DOpus Configuration.
  47. Select "System" and then "Functions".  The output window should be
  48. something like:
  49.  
  50.         con:15/11/640/256/Directory Opus Output Window/SMART
  51.  
  52. The SMART option is very important as it disables the buffer and displays
  53. non-Wb2 compatible DMS Texts.
  54.  
  55.  
  56. Using the requester
  57. ~~~~~~~~~~~~~~~~~~~
  58. Select a drive to UnDMS to.
  59.   DMS to FFx: devices are for those of you who use FMSdisk.device.
  60.   I don't think there's any need for more than 4 but if there is, I may or
  61.   may _not_ add more. :-)
  62.  
  63.   If you are UnDMSing to a FFx: device then you also have the option to
  64.   "DiskCopy" to a normal floppy after UnDMSing to FFx:.
  65.     ie.
  66.         If you select UnDMS to FF0: and then DiskCopy to DF1: then it will
  67.         UnDMS to FF0: and then perform a "DiskCopy FF0: DF1:" afterwards.
  68.  
  69. Enter the start and end tracks.
  70. Select whether you wish to validate the disk.
  71. Select if you want to show any text or not and whether you want to pause
  72.   after showing the text.
  73. Enter the decryption password if it's needed.  Leave it blank if it isn't.
  74. If you want to format the floppy before UnDMSing to it, select "Format".
  75. "Reload DMS" will reload DMS before UnDMSing each .DMS file.  This is used
  76. for UnDMSing lots of single part .DMS files.
  77.     eg.
  78.  
  79.         If you select Widget.DMS and Fnar.DMS then select "Reload DMS", it
  80.         will UnDMS Widget.DMS and then ask you to insert a new disk before
  81.         UnDMSing Fnar.DMS.  If "Reload DMS" is not selected then it would
  82.         simply UnDMS Widget.DMS and then Fnar.DMS straight over Widget.DMS.
  83.  
  84.  
  85. Options
  86. ~~~~~~~
  87. "UnDMS"      will UnDMS the selected file to the drive specified.
  88.  
  89. "Test"       will test the selected .DMS file for errors.
  90.  
  91. "View"       will display information (crunch mode, machine the archive was
  92.              created on,etc) about the selected .DMS file.
  93.  
  94. "Text"       will display the first text track of the selected .DMS file.
  95.  
  96. "Save Prefs" will save your DMS requester settings to env: and envarc:.
  97.              It will save _everything_, filenames, passwords, drives, etc.
  98.              (Thanks RC, cunning bit of coding!).
  99.  
  100. This requester should be present no problems to those who have used DMS
  101. before.  To those who haven't, why not? :-)
  102.  
  103. The colours of the text may look strange on some palettes.  If they do...
  104. _Change your Palette_ :-)
  105.  
  106. You can contact me (JC) or Rasta Catcha on:-
  107. Bad Dreams: +44 (0)81 679 5693
  108. C.A.L.:     +44 (0)81 346 6842
  109.  
  110.  
  111.  
  112. History
  113. ~~~~~~~
  114. v1.0  07/07/92   by JC
  115. First version released only to a few friends.
  116.  
  117. v1.1  07/07/92   by JC
  118. Added requester title to the status bar.
  119.  
  120. v1.2  08/07/92   by JC
  121. Added drive gadgets for DF2: and DF3: (request).
  122. Added options for Pause/NoPause and Val/NoVal.
  123.  
  124. v1.3  08/07/92   by JC
  125. Changed the gadget type of all the drive gadgets to tick gadgets for
  126. cosmetic reasons.  I hated the inversed colours when a gadget was selected.
  127. Added options to select Low Track and High Track (using string gadgets).
  128. Added option for Decrypt Password (also using string gadgets).
  129. Added options to Test, View and Show Text.
  130.  
  131. v1.4  09/07/92   by JC
  132. Added option to Format a disk before UnDMSing to it.  Uses a tick gadget.
  133.  
  134. v1.5  10/07/92   by JC
  135. Added option to UnDMS 1 part .DMS file or 2 part .DMS file.  This will
  136. either ask for another disk before UnDMSing the next file or carry on
  137. UnDMSing the file over the same disk.
  138.  
  139. v1.6  10/07/92   by JC
  140. Renamed 1 Part to "Reload DMS" and changed the gadget to a tick gadget.
  141. Moved the Format gadget next to the "Reload DMS".
  142.  
  143. v1.7  10/07/92   by JC
  144. Fixed a bug with the "Reload DMS" and "Format" gadget.  It was possible to
  145. select both gadgets.  Because of the way the requester system works, its
  146. not possible to have both options.
  147. Still a minor bug with a wierd error msg at the start of UnDMSing a file.
  148. There is also an intermittent error at the end of UnDMSing a file.
  149. It seems to be trying to run the requester.  I think its a bug in this
  150. release of DOpus/CRC.
  151.  
  152. v1.8  06/08/92   by JC&RC
  153. Rasta Catcha had some ideas for the requester.
  154. Made the requester more compact (200 lines high) for US users.
  155. "Save Prefs" gadget added.  Thanks R_'the fox'_C :-)
  156. To fit all these gadgets in a requester 200 lines high, all the gadgets had
  157. to be re-arranged and compacted.
  158. Lines under the "D" in "DMS" and "C" in "Cancel" were added for a more OS2
  159. look.  :-)
  160. Used more meaningful gadget names for Validate, Show Text and Pause.  ie.
  161. Validate: Yes/No instead of Val/NoVal and Show Text: Yes/No instead of
  162. Text/NoText and Pause: Yes/No instead of Pause/NoPause.  Well actually
  163. Pause/NoPause was ok, just want to make the requester neat! :-)
  164. RC tidied up my code and rewrote my UnDMS string to get round the error at
  165. UnDMSing bug but there doesn't seem to be a way around the intermittent error
  166. at the end. :-(.
  167. First public release on 18/08/92 after bugtesting and "using".
  168.