Atari DOS 2.5: A Practical Guide to the Menu, RAMdisk and Utilities

Atari DOS 2.5 is the DOS most 8-bit owners end up with. Atari Corp. released it in 1985 as the replacement for the unpopular DOS 3. It reads and writes the same disks as the older DOS 2.0S, it can use the extra "enhanced density" capacity of a 1050 drive, and it can turn the 130XE's spare 64K into a fast RAM drive. A huge share of the software and type-in programs out there assumes a DOS 2-style disk, so DOS 2.5 is a good default even today, on real hardware or in an emulator.

What you'll learn: how DOS 2.5 loads, what each menu letter does, how to format and copy disks, how MEM.SAV protects a BASIC program while you're in DOS, how the 130XE RAMdisk works, and what the three extra utilities on the master disk are for.

What you need: any Atari 8-bit with at least one disk drive (a real 1050 or 810, or an emulated drive in Altirra/atari800, SIO2PC, FujiNet, etc.) and a DOS 2.5 master disk or ATR image. For enhanced density you need a 1050 or a compatible drive. The 810 can only handle single density.

1. Where DOS 2.5 came from

DOS 2.5 (title line "DISK OPERATING SYSTEM II VERSION 2.5, COPYRIGHT 1984 ATARI CORP.") was written for Atari by Optimized Systems Software, Bill Wilkinson's company. It shipped with 1050 drives from fall 1985 into early 1986, and with XF551 drives in 1987–88. Atari's own manual makes the pitch plainly: compared with DOS 3, most utilities live in a single file, so you aren't loading pieces from disk all the time, and it stays compatible with DOS 2.0S. Antic's I/O Board told readers in 1986 that Atari Customer Relations would swap a DOS 3 disk for DOS 2.5 free of charge.

The master disk (DX5075) contains:

File Purpose
DOS.SYS The File Management System, i.e. the resident D: handler, loaded at boot
DUP.SYS The Disk Utility Package, i.e. the menu program
RAMDISK.COM Sets up the 130XE's extra 64K as drive 8
SETUP.COM Changes drive count, file buffers and write-verify, and builds AUTORUN.SYS files
COPY32.COM Copies files from DOS 3 disks to DOS 2.5
DISKFIX.COM Un-erase, verify, and rename-by-number repairs

2. Booting and getting to the menu

  1. Switch the drive on first and wait until the busy light goes out.
  2. Insert the DOS disk, label side up, and close the door.
  3. Switch the computer on last. On an XL/XE, BASIC is built in and you'll land at the READY prompt. On a 400/800 or 1200XL, plug in the BASIC cartridge if you want BASIC.
  4. Type DOS and press RETURN. DUP.SYS loads and the menu appears.

Antic's 1988 beginner's handbook printed the screen you should see:

DISK OPERATING SYSTEM II VERSION 2.5
COPYRIGHT 1984 ATARI CORP.

A. DISK DIRECTORY     I. FORMAT DISK
B. RUN CARTRIDGE      J. DUPLICATE DISK
C. COPY FILE          K. BINARY SAVE
D. DELETE FILE(S)     L. BINARY LOAD
E. RENAME FILE        M. RUN AT ADDRESS
F. LOCK FILE          N. CREATE MEM.SAV
G. UNLOCK FILE        O. DUPLICATE FILE
H. WRITE DOS FILES    P. FORMAT SINGLE

SELECT ITEM OR RETURN FOR MENU

To pick a function, type its letter, press RETURN, then answer the prompts. To boot commercial machine-language software on an XL/XE, hold OPTION while you switch on. That disables the built-in BASIC.

3. The menu, letter by letter

  • A – DISK DIRECTORY. Lists filenames, extensions, the sector count for each file and the free sectors left. Press RETURN twice at the DIRECTORY-SEARCH SPEC,LIST FILE prompt to get the whole of drive 1. Locked files show an asterisk.
  • B – RUN CARTRIDGE. Hands control back to BASIC (built in or cartridge) or whatever cartridge is inserted.
  • C – COPY FILE. Copies between drives, or to a new name on the same disk. It can also copy to devices such as the printer or the screen editor.
  • D – DELETE FILE(S). Erases files. Wildcards work, and locked files are skipped.
  • E – RENAME FILE. Give the old name, a comma, then the new name: D:CHRCOUNT,CHRCOUNT.704.
  • F / G – LOCK / UNLOCK FILE. A locked file can still be read but not changed, renamed or deleted.
  • H – WRITE DOS FILES. Writes DOS.SYS and DUP.SYS to a disk so that it boots.
  • I – FORMAT DISK. On a 1050 this formats in enhanced density. On other drives it formats single density.
  • J – DUPLICATE DISK. Whole-disk copy. In DOS 2.5 it formats the destination disk automatically, which is the "change in Option J" Atari's manual mentions.
  • K – BINARY SAVE / L – BINARY LOAD / M – RUN AT ADDRESS. Save a range of memory as a binary file, load a binary file, or jump to a hex address. These are for machine-language work.
  • N – CREATE MEM.SAV. Reserves a file that holds the part of user memory DUP.SYS overwrites (see section 5).
  • O – DUPLICATE FILE. Copies a file with disk swapping, for single-drive owners.
  • P – FORMAT SINGLE. New in 2.5. Forces a single-density format on a 1050.

4. Everyday tasks

Back up the master disk first. Antic's beginner procedure, step by step:

  1. From BASIC type DOS, then choose J.
  2. At the DUP DISK-SOURCE, DEST DRIVES prompt type 1,1 and press RETURN.
  3. Insert the master when asked for the source disk and press RETURN. Insert a blank disk when asked for the destination and press RETURN. Swap disks whenever prompted.
  4. Store the master. Work from the copy.

Pick a density. Enhanced density (option I) holds about 50% more than single density, but an 810 can't read it and some programs can't handle it. Use P for disks you'll share with 810 owners or older software.

Save and load BASIC programs:

SAVE "D:FILENAME.123"
LOAD "D:FILENAME.123"
RUN "D:DIMNDAVE.BAS"

D: means drive 1. Use D2:, D3: and so on for other drives. Filenames are up to eight letters or digits, they can't start with a digit, and they take an optional three-character extension.

5. MEM.SAV: keep your BASIC program when you visit DOS

DUP.SYS loads into the same RAM a BASIC program uses. Without precautions, typing DOS wipes your program. Choose N once on your working disk to create MEM.SAV. From then on DOS saves the threatened memory to that file before loading DUP.SYS and restores it when you leave with B. The cost is the wait while MEM.SAV is written and read back. Leave it off disks where you don't need it.

6. The 130XE RAMdisk (D8:)

If the boot disk contains RAMDISK.COM and the machine has 130XE-style banked memory, DOS 2.5 runs it at boot. It does three things:

  1. Formats the extra 64K as drive 8 (D8:), which holds 499 sectors, about half an enhanced-density disk.
  2. Copies DUP.SYS to D8:.
  3. Sets up MEM.SAV on D8:.

Now typing DOS is almost instant, because the menu loads from RAM. The RAMdisk is volatile, so copy anything you want to keep to a real disk before you power off.

To reclaim the space DUP.SYS and MEM.SAV take, change location 5439 ($153F) and then delete both files from D8::

POKE 5439,ASC("1")

Then use menu option D with D8:*.*. After that DOS looks for DUP.SYS on drive 1 again. If you don't want the RAMdisk at all, rename RAMDISK.COM on your boot disk and the extra RAM is free for other programs. A 1986 Antic article by Patrick Dell'Era even patched RAMDISK.COM to drive an Axlon 128K board in an Atari 800. The modified DOS warns you by showing its top menu line in inverse video.

Some limits: option J can't duplicate a full floppy onto the RAMdisk because it's smaller, so copy individual files instead. You can duplicate the RAMdisk out to a floppy. When the RAM drive is installed, DOS 2.5's drive map defaults to D1:, D2: and D8:.

7. The three utilities

All three are binary files. Run them with L (BINARY LOAD) and the filename, e.g. SETUP.COM.

  • SETUP.COM has a menu: 1 change current drive number, 2 change system configuration (number of drives 1–4, maximum simultaneously open files 1–7, writes with or without verify), 3 set up an AUTORUN for boot (load the 850's R: handler and/or automatically RUN a BASIC program from the boot disk), 0 return to DOS. Use option 3 to make a disk that boots straight into your BASIC program.
  • DISKFIX.COM: 1 change drive, 2 unerase file, 3 verify disk, 4 rename file by number (this fixes two files with the same name), 5 quit. Type the number without pressing RETURN.
  • COPY32.COM copies files from DOS 3 disks to DOS 2.5 disks. It lists DOS 3 files by number, sixteen at a time. You pick one and confirm with START. With one drive you'll be asked to swap disks, and files over 124,700 bytes need two drives.

8. Technical notes

  • Capacity: a DOS 2.5 enhanced-density disk has 1040 sectors with 1010 usable for data (126,250 bytes). Single density gives 707 usable sectors. Each 128-byte sector keeps 3 bytes for the link to the next sector, so files hold 125 bytes per sector.
  • Layout: VTOC at sector 360, directory at 361–368 (64 files maximum), and an extra VTOC at sector 1024 for the sectors above 719. Older DOS 2.0S sees only the first 720 sectors of an enhanced disk.
  • Tuning from BASIC: like DOS 2.0S, location 1802 (DRVBYT) holds the drive bitmap and 1801 (SABYTE) holds the number of file buffers. Poke them, then use H to write the changed DOS to disk. SETUP.COM does the same job with less risk.

Troubleshooting

  • BOOT ERROR flashes on screen: the disk isn't a boot disk, or the drive was switched on in the wrong order. Power the computer off, check the drive's busy light has gone out, and try again.
  • You get the Self Test screen instead of DOS: Antic's advice is to double-check the cables to the disk drive. Also check the drive select switches (on a 1050, both to the left = drive 1).
  • An 810 can't read your disk: it was formatted in enhanced density. Copy the files to a disk formatted with P.
  • Copy-protected or DOS 2.0S-specific programs misbehave: Atari's own manual concedes that some protected disks still need DOS 2.0S.
  • Your BASIC program vanished after typing DOS: you had no MEM.SAV. Create one with N before next time.

Further reading

  • Inside Atari DOS by Bill Wilkinson (COMPUTE! Books / Small System Services, 1982). The commented source of the DOS 2.0S FMS, which DOS 2.5 builds on.
  • Your Atari Computer by Lon Poole et al. (Osborne/McGraw-Hill, 1982; XL edition later). Antic recommended it to newcomers.
  • Disk Guide Atari 400 and 800 (McGraw-Hill, 1983). A quick-reference card-style guide to DOS and BASIC.
  • Related guides on this site: Choosing a DOS, MyDOS guide, SpartaDOS X guide.

Credits