                UnDMS Requestor for Directory Opus v3.50+.
                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Introduction
~~~~~~~~~~~~
This requester was created because I wanted a nice DMS/UnDMSer which was
integrated into Directory Opus.  The new user requesters in Directory Opus
just made it possible to integrate all the options nicely.


Requirements
~~~~~~~~~~~~
Format, DiskCopy and DMS _must_ be in PATH.
    eg.

        If DMS is in DH0:Archivers, then you should have:
                Path DH0:Archivers Add
        in your s:startup-sequence

DopusReq: _must_ be assigned to where the requesters are kept.
    eg.

        Assign DOpusReq: Sys:DOpus/Requesters


Installation
~~~~~~~~~~~~
WB1.3 users should assign env: to ram: and envarc: to s:.  This hasn't been
tested but should work.  If it doesn't it's another reason to upgrade!

Go into the Directory Opus configuration and setup a new gadget called DMS.
In the entry type, toggle the entry type gadget until you see "Requester"
appear.  Then enter the path and name of the requester file into the string
gadget.  This entry line should look something like:-

                Requester   DopusReq:UnDMS.creq

The flags enabled should be:-

        Directory Opus to front
        Do all files
        Output window
        Workbench to front

All other flags should be off.

If you want DMS Text to display properly, go into the DOpus Configuration.
Select "System" and then "Functions".  The output window should be
something like:

        con:15/11/640/256/Directory Opus Output Window/SMART

The SMART option is very important as it disables the buffer and displays
non-Wb2 compatible DMS Texts.


Using the requester
~~~~~~~~~~~~~~~~~~~
Select a drive to UnDMS to.
  DMS to FFx: devices are for those of you who use FMSdisk.device.
  I don't think there's any need for more than 4 but if there is, I may or
  may _not_ add more. :-)

  If you are UnDMSing to a FFx: device then you also have the option to
  "DiskCopy" to a normal floppy after UnDMSing to FFx:.
    ie.
        If you select UnDMS to FF0: and then DiskCopy to DF1: then it will
        UnDMS to FF0: and then perform a "DiskCopy FF0: DF1:" afterwards.

Enter the start and end tracks.
Select whether you wish to validate the disk.
Select if you want to show any text or not and whether you want to pause
  after showing the text.
Enter the decryption password if it's needed.  Leave it blank if it isn't.
If you want to format the floppy before UnDMSing to it, select "Format".
"Reload DMS" will reload DMS before UnDMSing each .DMS file.  This is used
for UnDMSing lots of single part .DMS files.
    eg.

        If you select Widget.DMS and Fnar.DMS then select "Reload DMS", it
        will UnDMS Widget.DMS and then ask you to insert a new disk before
        UnDMSing Fnar.DMS.  If "Reload DMS" is not selected then it would
        simply UnDMS Widget.DMS and then Fnar.DMS straight over Widget.DMS.


Options
~~~~~~~
"UnDMS"      will UnDMS the selected file to the drive specified.

"Test"       will test the selected .DMS file for errors.

"View"       will display information (crunch mode, machine the archive was
             created on,etc) about the selected .DMS file.

"Text"       will display the first text track of the selected .DMS file.

"Save Prefs" will save your DMS requester settings to env: and envarc:.
             It will save _everything_, filenames, passwords, drives, etc.
             (Thanks RC, cunning bit of coding!).

This requester should be present no problems to those who have used DMS
before.  To those who haven't, why not? :-)

The colours of the text may look strange on some palettes.  If they do...
_Change your Palette_ :-)

You can contact me (JC) or Rasta Catcha on:-
Bad Dreams: +44 (0)81 679 5693
C.A.L.:     +44 (0)81 346 6842



History
~~~~~~~
v1.0  07/07/92   by JC
First version released only to a few friends.

v1.1  07/07/92   by JC
Added requester title to the status bar.

v1.2  08/07/92   by JC
Added drive gadgets for DF2: and DF3: (request).
Added options for Pause/NoPause and Val/NoVal.

v1.3  08/07/92   by JC
Changed the gadget type of all the drive gadgets to tick gadgets for
cosmetic reasons.  I hated the inversed colours when a gadget was selected.
Added options to select Low Track and High Track (using string gadgets).
Added option for Decrypt Password (also using string gadgets).
Added options to Test, View and Show Text.

v1.4  09/07/92   by JC
Added option to Format a disk before UnDMSing to it.  Uses a tick gadget.

v1.5  10/07/92   by JC
Added option to UnDMS 1 part .DMS file or 2 part .DMS file.  This will
either ask for another disk before UnDMSing the next file or carry on
UnDMSing the file over the same disk.

v1.6  10/07/92   by JC
Renamed 1 Part to "Reload DMS" and changed the gadget to a tick gadget.
Moved the Format gadget next to the "Reload DMS".

v1.7  10/07/92   by JC
Fixed a bug with the "Reload DMS" and "Format" gadget.  It was possible to
select both gadgets.  Because of the way the requester system works, its
not possible to have both options.
Still a minor bug with a wierd error msg at the start of UnDMSing a file.
There is also an intermittent error at the end of UnDMSing a file.
It seems to be trying to run the requester.  I think its a bug in this
release of DOpus/CRC.

v1.8  06/08/92   by JC&RC
Rasta Catcha had some ideas for the requester.
Made the requester more compact (200 lines high) for US users.
"Save Prefs" gadget added.  Thanks R_'the fox'_C :-)
To fit all these gadgets in a requester 200 lines high, all the gadgets had
to be re-arranged and compacted.
Lines under the "D" in "DMS" and "C" in "Cancel" were added for a more OS2
look.  :-)
Used more meaningful gadget names for Validate, Show Text and Pause.  ie.
Validate: Yes/No instead of Val/NoVal and Show Text: Yes/No instead of
Text/NoText and Pause: Yes/No instead of Pause/NoPause.  Well actually
Pause/NoPause was ok, just want to make the requester neat! :-)
RC tidied up my code and rewrote my UnDMS string to get round the error at
UnDMSing bug but there doesn't seem to be a way around the intermittent error
at the end. :-(.
First public release on 18/08/92 after bugtesting and "using".
