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
- Switch the drive on first and wait until the busy light goes out.
- Insert the DOS disk, label side up, and close the door.
- Switch the computer on last. On an XL/XE, BASIC is built in and you'll land at the
READYprompt. On a 400/800 or 1200XL, plug in the BASIC cartridge if you want BASIC. - Type
DOSand 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 FILEprompt 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:
- From BASIC type
DOS, then choose J. - At the
DUP DISK-SOURCE, DEST DRIVESprompt type1,1and press RETURN. - 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.
- 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:
- Formats the extra 64K as drive 8 (
D8:), which holds 499 sectors, about half an enhanced-density disk. - Copies
DUP.SYSto D8:. - Sets up
MEM.SAVon 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:
1change current drive number,2change system configuration (number of drives 1–4, maximum simultaneously open files 1–7, writes with or without verify),3set up an AUTORUN for boot (load the 850's R: handler and/or automatically RUN a BASIC program from the boot disk),0return to DOS. Use option 3 to make a disk that boots straight into your BASIC program. - DISKFIX.COM:
1change drive,2unerase file,3verify disk,4rename file by number (this fixes two files with the same name),5quit. 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
- Antic Vol. 6 No. 10 (Feb 1988) — First-Time Atari Users Handbook (Gregg Pearlman) — AtariMagazines.com (Kevin Savetz), 1988
- Antic Vol. 4 No. 10 (Feb 1986) — DOS 2.5 for Axlon RAMdisk (Patrick Dell'Era) — AtariMagazines.com (Kevin Savetz), 1986
- comp.sys.atari.8bit FAQ (Michael Current), section 7.3.1 — Atari DOS versions — Michael Current (comp.sys.atari.8bit FAQ)
- Antic Vol. 5 No. 5 — I/O Board (DOS 3 exchange for DOS 2.5) — AtariMagazines.com (Kevin Savetz)
