MyDOS 4.5: Subdirectories, Big Drives and RAMdisks with a DOS 2 Feel
MyDOS looks and behaves almost exactly like Atari DOS 2: same DOS.SYS and DUP.SYS files, a lettered menu, same binary file format. Underneath, it adds what DOS 2 never had: subdirectories, double-density and double-sided floppies, hard disks up to 65,535 sectors, and RAMdisks of up to a megabyte. That mix made it the standard DOS for many hard-disk and modern-storage setups, and a lot of disk images you'll find today are MyDOS-formatted.
What you'll learn: where MyDOS came from, how its menu differs from DOS 2.5, how to use subdirectories and the default directory, how to configure drives and a RAMdisk with the O command, and the first-time installation routine from the official manual.
What you need: any Atari 8-bit with one DOS 2-compatible drive (real or emulated) and a MyDOS 4.5x disk image. Version 4.50 was released as freeware, so images are easy to find.
1. Background in brief
In brief:
- Versions 3.0 through 4.3B were written by Charles W. Marslett (Wordmark Systems) between 1982 and 1986. MyDOS started as a side project while he was writing the original firmware for Percom's Atari disk drives.
- 3.x versions were sold commercially by SWP for its ATR8000. 4.x versions shipped with drives and hard-disk systems such as the SupraDrive and the BTL hard disk.
- MYDOS 4.50 (11/28/88) was the first freeware release, distributed through Bob Puff's Computer Software Services. Marslett later made the 4.51 source code available.
- MyDOS 4.53 (1/1/90, David R. Eichel) supports multiple AUTORUN files (
*.AR0–*.AR9) instead ofAUTORUN.SYSand fixes Axlon RAMdisk support. 4.55 Beta (Lee Barnes, 2003) is the most recent version listed.
It was the first Atari DOS to change density on the fly with Percom-compatible drives, and the first to use high-capacity disks even with a single drive.
2. Compatibility at a glance
MyDOS 4.5 aims to be "as compatible as possible" with DOS 2. All DOS 2 system calls (XIO commands) are supported, mostly with identical parameters, and MyDOS reads and writes DOS 2 and DOS 2.5 files on standard single-sided, single-density disks. Points to watch:
- DOS 2.5 enhanced-density disks: MyDOS 4.x reads them fully but writes only to the first 720 sectors. MyDOS has its own 1050 enhanced (1040-sector) format, which DOS 2.5 can't use.
- Not compatible with the SpartaDOS or OS/A+ version 4 formats. Convert those files first.
- A few programs fail because they jump directly into DOS internals or expect the exact DOS 2 directory layout. One example is the three-digit sector count: MyDOS shows four digits, or five above 9999.
- Up to 8 floppy drives are supported, or 9 if the ninth is a RAMdisk.
- Memory: each open file costs 256 bytes, regardless of drive count or density. With the default three file buffers and no extra drivers, programs can load from $1F00.
3. Filenames and paths
Enter filenames as drive number, colon, name: D1:TEST.OBJ, 1:TEST.ASM. A name with no drive uses the default drive and directory. Drive and file names must be uppercase. dl:TEST.OBJ fails, and so does 1TEST.ASM, because a filename can't start with a digit. Wildcards are * (rest of name or extension) and ? (any one character).
Subdirectories are separated by : or >. If the root holds a directory BAS containing GRAPHICS.1, both of these work:
BAS:GRAPHICS.1
BAS>GRAPHICS.1
The root and each subdirectory can each hold up to 64 entries. A subdirectory takes 8 sectors in its parent, and in a directory listing its name is preceded by :.
4. The menu
The MyDOS 4.5 menu has 18 functions. Line two of the screen shows which drives are present and their density, and the next line shows the current default directory. After a command runs, the menu may scroll away. Press RETURN to bring it back, and BREAK to abort any function. BREAK or RESET during a write won't destroy the disk, though the file being written may be missing from the directory.
| Key | Function | Notes and options |
|---|---|---|
| A | Directory | 2,D1:DIR.TXT writes drive 2's directory to a file. 1,P: sends it to the printer. /A appends |
| B | Run cartridge | Restores MEM.SAV first if it's active |
| C | Copy file(s) | /A append, /Q query each file, /S skip files whose extension starts with S (so a "copy everything but .SYS" mimics DOS 2's option O), /X prompt for disk swaps |
| D | Delete file(s) | Asks per file. /N deletes without asking. Also removes empty subdirectories |
| E | Rename | The new name can't include a drive or path. Renames directories too |
| F / G | Lock / unlock | /Q to confirm each. A locked directory accepts no new files |
| H | Write DOS files | Writes DOS.SYS and DUP.SYS with your current configuration |
| I | Format | /N just clears the directory without reformatting. Answer A at the prompt for 1050 enhanced density |
| J | Duplicate disk | Sector ranges: 1,3/N(19-54). Whole disk: 1,2(1-720), or (1-1040) for enhanced |
| K | Binary save | D1:TEST.OBJ,3000,4000,3010,3100 = start, end, init, run (hex) |
| L | Binary load | /N loads without running. Also switches MEM.SAV off |
| M | Run at address | e.g. E477 restarts the machine |
| N | Load / enable MEM.SAV | Like L, but turns MEM.SAV on. N + RETURN alone just enables it |
| O | Configure | Drives, buffers, verify, RAMdisk (section 6) |
| P | Set density | 2,D or 2,S. Use it before formatting, or for drives that can't detect density |
| Q | Create subdirectory | 1:BAS>COMM |
| R | Set default directory | 1:NEU makes D:PROG.COM mean 1:NEU:PROG.COM |
Version 4.3 introduced S (set the RAM drive number) and V (write-verify on/off).
5. Working with subdirectories, step by step
- Q, then
1:GAMES: createsGAMESin the root of drive 1. - Q, then
1:GAMES>ARCADE: createsARCADEinside it. The parent must already exist, so1:NEW:COMMfails ifNEWdoesn't exist yet. - C, then
D1:*.COM,1:GAMES>: copies files into the subdirectory. - A, then
1:GAMES:: lists it. Note the trailing separator. - R, then
1:GAMES: makes it the default. Now plainD:names point there. After a disk swap you have to set it again, unless the root is your default. - To remove a directory, empty it, then D with
1:GAMES:ARCADE, without a trailing separator.
6. Configuring drives and a RAMdisk (option O)
Press O. At Drive number or RETURN:
- RETURN configures the system parameters:
Verify WRITEs?: N writes without read-back verification.Number of File Buffers?: RETURN gives 3, the minimum the menu needs, since a copy uses three files.RAM disk present: if yes, choose[A]xlon or [X]E type?, accept or override the detected size (in K, a multiple of 16; 1K = 8 single-density sectors), the control address (RETURN = $D301 for 130XE-style memory; $CFFF for an Axlon RAMPOWER 128), the page sequence (RETURN for a standard 130XE), and finallyRAM disk drive no?.- A drive number configures that drive. Decide whether it's active and whether it's configurable (Percom-standard: upgraded 1050s, Percom drives, ATR8000…). A hard disk takes its size in sectors (256–65,535). A configurable floppy asks for double-sided Y/N, tracks per side (35, 40, 77 or 80), and a step-rate code: 0 = 6 ms (XF551), 1 = 12 ms (1050), 2 = 20 ms, 3 = 30 ms.
Beware: pressing RETURN doesn't keep old values. It enters defaults. And BREAK or RESET won't undo changes, so reboot if you want to abandon a configuration. Changes stick only after you write DOS with H.
MyDOS ships with drives 1 and 2 active, which keeps booting fast. Active drives that aren't connected are polled at each boot or RESET, costing about a second. The number of buffers lives in location 1801, the same byte DOS 2.5 uses. Write-verify is at 1913 ($779): 87 ($57) means verify, 80 ($50) means none.
7. First-time installation (from the manual)
- Remove all cartridges.
- Power the drive, insert the MyDOS disk, close the door.
- Switch the computer on holding OPTION. The MyDOS menu appears.
- With two ordinary 40-track single-sided drives (e.g. 1050s) and no RAMdisk, or a standard 130XE RAMdisk, skip to step 6.
- Configure every drive with O.
- If you need more than 3 open files, or a non-130XE RAMdisk, set it up with O.
- Format a new disk (P to set density first, then I).
- Write MyDOS to it with H. No RAMdisk? Skip to step 10.
- Copy
RAMBOOT.AUTto the new disk asAUTORUN.SYS. It mimics DOS 2.5's RAMDISK.COM: it formats the RAMdisk and copies DUP.SYS and MEM.SAV there. It also copies every file in a directory namedRAMDISKon the boot disk, so you can preload tools. MAC/65 source (RAMBOOT.M65) is included if you want to change the drive number or behaviour. - Boot from this disk from now on.
Troubleshooting
MyDOS error numbers mostly match DOS 2. These are new or worth knowing:
| Error | Meaning |
|---|---|
| 160 | Bad drive number |
| 161 | No sector buffer, too many files open (raise buffers with O) |
| 162 | Disk full |
| 164 | File number mismatch in sector link (only when writing DOS 2/2.5-format disks) |
| 169 | Directory full (64 entries) |
| 172 | A file or directory with that name already exists |
| 174 | Directory not found |
| 175 | Directory not empty, can't delete |
| 180 / 181 | Not a binary file / bad address range (from XIO 39/40 loads) |
- Formatted at the wrong density: MyDOS formats at the density last used on that drive unless you set it with P first.
- Can't write to the high sectors of a DOS 2.5 disk: expected. Copy the files to a MyDOS-format disk.
- Typed an uppercase name but got error 165: the name probably starts with a digit, or you typed a lowercase drive letter.
Further reading
- Inside Atari DOS by Bill Wilkinson (COMPUTE! Books / Small System Services, 1982). MyDOS keeps the DOS 2 FMS structure documented there.
- The FAQ's §3.2.6 on the Percom configuration block explains why "configurable" drives matter.
- Related guides on this site: Choosing a DOS, DOS 2.5 guide, SpartaDOS X guide.
Credits
- MYDOS Version 4 Benutzerhandbuch, Revision 4.5 (Charles Marslett & Robert Puff, WORDMARK Systems, 1988) — German translation, archive.org OCR — Internet Archive, 1988
- comp.sys.atari.8bit FAQ (Michael Current), section 7.3.3 — MYDOS entry — Michael Current (comp.sys.atari.8bit FAQ)
- Nir Dary CD collection — MyDOS 4.53/4 disk image note — Nir Dary collection
