Disk Fixer (APX)
- Year
- 1981
- Publisher
- Atari Program Exchange (APX-20010; later APX-20189 with Load 'N Go); also Atari Elektronik (Germany) and Atari Italia
- Type
- Utility
- Category
- Disk directory, sector-chain and bitmap repair tool
- Developer
- Mike Ekberg
- Language
- 6502 assembly language
- Requirements
- Atari 400/800 with 24K and an Atari 810 drive (815 double-density disks supported); loaded from the Atari DOS menu
- Tags
- disk-utility, disk-repair, apx, atari-program-exchange, dos-1, dos-2, sector-editor, 810, 815
- Related
- DiskWiz-II, SpartaDOS, Diskey
Overview
Disk Fixer, called FIX on its own screens, was one of the first disk-repair tools for the Atari 400/800. Mike Ekberg wrote it, and it came out through the Atari Program Exchange as APX-20010. The manual for Revision 2.0 is dated 1 July 1981. Earlier internal versions survive: a version 1.0 dated 15 May 1980 and a "2SD" build dated 1 October 1980. Atari's German and Italian subsidiaries also distributed it.
Its job is to fix the things that make DOS give up on a disk: a broken link chain that causes ERROR 164 (file number mismatch), a directory entry pointing to the wrong place, or a bitmap that no longer matches what is actually on the disk. The manual calls it a tool "for an advanced systems programmer only", which requires a detailed understanding of disk structure. Every number FIX displays or accepts is in hexadecimal.
A 1982 re-release, Disk Fixer/Load 'N Go (APX-20189), put the same FIX program on one disk with Load 'N Go, a small Atari BASIC utility that writes an AUTORUN.SYS file to run or load a BASIC program automatically at boot.
Features
FIX is menu-driven. A single keypress picks a command and BREAK aborts it:
- A – Directory Entries. Lists directory slots by number with name, first sector (FSEC), sector count and status flags:
Dfor deleted,Lfor locked. - B – Trace Sector Chain. Follows a file's links from sector to sector. It stops at an end-of-file link (sector 0) or a "bad link" into another file's sector, showing each sector's byte count and forward pointer as it goes.
- C – Modify Directory Entry. Edits a directory line in place: the name, start sector, length or status. Deleting the
Dbrings a deleted file back, and adding or removingLlocks or unlocks it. - D – Check Allocation Map. Builds its own bitmap by walking every file, compares it with the one on the disk, lists sectors wrongly "MARKED IN USE" or wrongly "FREE", and offers to write the corrected map.
- E – Modify Sector Link. Edits the three housekeeping bytes at the end of a sector: the file number, the byte count and the forward pointer. Typing
Emarks a sector as end-of-file. - F – Set Drive Number, G – Exit to DOS.
- H – Dump Sectors. Shows one sector or a range as a hex and ATASCII matrix. CTRL+1 pauses the scroll.
- I – Edit Sector. Edits the hex side of a sector on screen. The changed sector can be written back to the same sector or to a different one, which is handy for copying a good directory sector over a bad one.
Half the manual is a guide to Atari I/O error codes 128–173, with the likely cause and a recovery strategy for each.
Technical notes
FIX dates from the very beginning of Atari disk software, and the manual shows it. It describes three kinds of disk: the original DOS of 9/24/79 (DOS 1), which has a single boot sector and uses the byte-count field as a relative sector number; DOS II 2S and 2D disks with three boot sectors; and 256-byte-sector disks for the Atari 815 dual double-density drive, which was introduced in June 1980 but never went on general sale. When FIX edits a 256-byte sector it shows it in two 128-byte halves. The manual also blames intermittent device timeouts under the 1979 DOS on a timeout value set too low, a problem DOS II fixed.
The program loads as a binary file from the DOS menu: option L, then FIXDMP. The APX diskettes were sold without a write-protect notch, so the manual says to duplicate the disk with DOS option J before using it.
Behind the scenes
Disk Fixer was the obvious recommendation of its day for awkward disk problems. The Creative Atari's chapter on Atari DOS, for example, suggested a disk fixer "such as the one available from APX" for a disk with two files of the same name, where renaming or deleting one would hit both. Commercial tools such as DiskWiz-II later added full-disk maps and duplication, but FIX's allocation-map check (rebuilding the bitmap from the files themselves) is the same idea that later DOS "verify" utilities use.
Using it today
FIX is safe to try under emulation on any ordinary DOS 2.0S single-density image. Boot DOS 2.0S, binary-load FIXDMP, and practise on a copy of the image. Delete a file with DOS, then use A and C to undelete it and D to re-mark its sectors in the bitmap. It knows nothing about DOS 2.5 enhanced density, MyDOS directories or SpartaDOS disks, so keep it away from those.
Credits
- Picture: Cover of the APX-20010 manual for Disk Fixer Rev. 2.0. — Manual cover from the Internet Archive item 'APX 20010 Disk Fixer Manual' (APX20010DiskFixerManual) (Manual © Atari, Inc. 1981 — used for identification/commentary)
- comp.sys.atari.8bit FAQ — 3.2.4 Atari 815 — Michael Current (comp.sys.atari.8bit FAQ)
- APX-20010 Disk Fixer, Rev. 2.0 (FIX) manual, Mike Ekberg, 7/1/81 — Internet Archive item APX20010DiskFixerManual — Manual cover from the Internet Archive item 'APX 20010 Disk Fixer Manual' (APX20010DiskFixerManual) (Manual © Atari, Inc. 1981 — used for identification/commentary)
- APX-20189 Disk Fixer/Load 'N Go manual (1982) — Internet Archive item APX20189DiskFixerLoadNGoManual — Internet Archive, 1982
- AtariMania — Disk Fixer (prototype files V1.0 15 May 1980 and V2.0SD 1 Oct 1980; other releases) — AtariMania, 1980
- The Creative Atari — Atari DOS — AtariArchives.org
