home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / d / directory_opus / magicdopusdisk.dms / in.adf / Goodies / DopusReq / DMS.doc < prev    next >
Encoding:
Text File  |  1992-08-18  |  4.3 KB  |  129 lines
  1.                 DMS 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. 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:DMS.creq
  36.  
  37. The flags enabled should be:-
  38.  
  39.         Directory Opus to front
  40.         Output window
  41.         Rescan source
  42.         Workbench to front
  43.  
  44. All other flags should be off.
  45.  
  46.  
  47. Using the requester
  48. ~~~~~~~~~~~~~~~~~~~
  49. Select a drive to DMS from.
  50.   DMS from FFx: devices are for those of you who use the FMSdisk.device.
  51.   I don't think there's any need for more than 4 but if there is, I may or
  52.   may _not_ add more. :-)
  53.  
  54. Enter a filename for the .DMS file.
  55. Enter the start and end tracks.
  56. Select crunch mode.
  57. Select whether you wish to validate the disk.
  58. Select if the disk bitmap is to be used to read the tracks or whether to
  59.   ignore it and read _all_ the tracks between start and end track.
  60. Enter a text file to append to the .DMS file if necessary. (This text file
  61.   may be displayed when UnDMSing.  Leave it blank if no text file is required.
  62. Enter an encryption password if you want the .DMS file encrypted.  Leave it
  63. blank if not.
  64.  
  65.  
  66. Options
  67. ~~~~~~~
  68. "DMS"        will DMS the disk in the drive selected using the filename
  69.              specified.  'D' is used as a hotkey for this gadget.
  70.  
  71. "Save Prefs" will save your DMS requester settings to env: and envarc:.  It
  72.              will save _everything_, filenames, passwords, drives, etc.
  73.              (Thanks RC, cunning bit of coding!).
  74.  
  75. The following options requires that a .DMS file is selected before the
  76. requester is executed:-
  77.  
  78. "Repack"     will repack a selected .DMS file using the crunch mode specified
  79.              to the filename specified. eg.
  80.  
  81.                 Click on "Widget.DMS" file
  82.                 Click on "DMS" gadget in DOpus
  83.                 Enter "Fnar" as the filename
  84.                 Select "Best" as the crunch mode
  85.                 Click on "Repack" in the requester
  86.  
  87.              That will UnDMS "Widget.DMS" and then DMS it up as "Fnar.DMS"
  88.              using "Best" crunch mode.
  89.  
  90. "Test"       will check the selected .DMS file for errors.
  91.  
  92. "View"       will display information (crunch mode, machine the archive was
  93.              created on,etc) about the selected .DMS file.
  94.  
  95. "Text"       will display the first text track of the selected .DMS file.
  96.  
  97. And that concludes this lecture on "How to use DMS requesters in DOpus".
  98.  
  99. The colours of the text may look strange on some palettes.  If they do...
  100. _Change your Palette_ :-)
  101.  
  102. You can contact me (JC) or Rasta Catcha on:-
  103. Bad Dreams: +44 (0)81 679 5693
  104. C.A.L.:     +44 (0)81 346 6842
  105.  
  106.  
  107.  
  108. History
  109. ~~~~~~~
  110. v1.0  09/07/92   by JC
  111. First version released only to a few friends.
  112. Worked first time.
  113.  
  114. v1.1  10/07/92   by JC
  115. Repack gadget added.  Again only released to a few friends.
  116.  
  117. v1.2  06/08/92   by JC&RC
  118. Rasta Catcha had some ideas for the requester.
  119. Made the requester more compact (200 lines high) for US users.
  120. "Save Prefs" gadget added.  Thanks Rasta 'The Fox' Catcha :-)
  121. To fit all these gadgets in a requester 200 lines high, the options gadgets
  122. had to be re-arranged.
  123. Lines under the "D" in "DMS" and "C" in "Cancel" were added for a more OS2
  124. look.  :-)
  125. Used more meaningful gadget names for Validate and Bitmap gadgets. ie.
  126. Validate: Yes/No instead of Val/NoVal and Use Bitmap: Yes/No instead of
  127. Zero/NoZero.
  128. First public release on 18/08/92 after bugtesting and "using".
  129.