OmniDisk v2.8+ DDOS.txt (14 Oct 2002) Copyright 2002 J. Watton. [jason.watton @ lycos.co.uk (remove spaces)]

You'll need word-wrap enabled to read this document easily.

For sector-level access to disks of any format in OmniDisk see the attached FAQ.txt. This file deals with the enhancements made to OmniDisk to handle the Opus/Slogger DDOS format only. As the facilities of DFS are also available under DDOS this file should be read in conjunction with DFS.txt.

DDOS Extensions to OmniDisk
===========================

OmniDisk can manipulate the Opus/Slogger DDOS format. It includes a set of DDOS/DFS ('*') commands for handling:

	- DDOS floppy disks (DOS, Windows3, Windows 95-ME)
	- DDOS disk image files (DOS, Windows3, Windows95-ME, WindowsNT, 2000, XP)
	- DFS/DDOS .inf files (DOS, Windows3, Windows95-ME, WindowsNT, 2000, XP)

When handling .inf files, you can use the DOS filename or the DFS filename contained within them.

All of the DFS facilities are also available under DDOS - see DFS.txt.

Command List
------------

This is the same as DFS (see DFS.txt) plus some extras listed below. There are some subtle differences for DFS drive specifications, e.g.:

*CAT [<drive>[<volume>]]
*DRIVE [<drive>[<volume>]]
*COPY <DFS drive>...
*COMPACT [<drive>[<volume>]]

where a volume letter (A-H) can be appended to the normal DFS drive number (0-3). Without an explicit volume, the volume defaults to volume A.

All DFS filenames are extended to allow for a volume specification after the drive (e.g. :2B.$.!BOOT).

These are 2 types of DDOS commands implemented:

  - DDOS-only (e.g. *VOLGEN)
  - DFS-compatible (e.g. *MAP)

The commands are listed below, although this list may become outdated - use *HELP interactively for a current list.

DDOS|*DDOS
        Selects Slogger (BBC) DDOS format (without disk scan).
        All drive specifications have optional volume letter A-H (default set
        by *DRIVE).
*STAT [<drive>[<volume>|*]]
        Displays size of volume(s) and space remaining.
*MAP [<drive>[<volume>|*]]
        Displays usage of DDOS volume(s)/DFS drive.
*VOLGEN [<drive> [<vol A sectors>|* [<vol B sectors>|*]...]]
        Displays/sets volume sizes. '*' allocates rest of disk to subsequent
        volumes. NOTE: This command erases the whole drive.

Getting going
-------------
For a floppy disk, insert the DDOS disk and select the drive using '*DRIVE n', where n is the DFS drive number as for a BBC (do not use volume letters - DFS is the default '*DRIVE' handler). Type '*DISK'. The disk will be sampled to check the format - provided there are no errors, you can then use the usual DDOS commands as listed above. Use '*DDOS' if '*DISK' fails to recognise the format.

For a disk image, type '*IMAGE <DOS filename> *DDOS'. The '*DDOS' is necessary to correct the default assumption of DFS. The default sector ordering (type '*ORDER') is HCS, but you can change this using *ORDER.

.inf files are handled by the appropriately tweaked '*' commands listed in DFS.txt.

DDOS only Commands
------------------
The following commands are only available under DDOS:

DDOS|*DDOS
*VOLGEN [<drive> [<vol A sectors>|* [<vol B sectors>|*]...]]

*VOLGEN without parameters will display the volume map; changing the values will erase the contents of the specified drive.

These commands are all valid both on physical DDOS floppy disks or disk images (*IMAGE).

DFS-compatible Commands
-----------------------
The following DDOS commands are also available under DFS:

*STAT [<drive>[<volume>|*]]
        Displays size of volume(s) and space remaining.
*MAP [<drive>[<volume>|*]]
        Displays usage of DDOS volume(s)/DFS drive.

All DFS commands are available under DDOS.
