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
White APX manual cover with the Atari Program Exchange logo, reading Disk Fixer, Rev. 2.0 (FIX) by Mike Ekberg, Instructions, User-Written Software for Atari Personal Computer Systems, APX-20010

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: D for deleted, L for 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 D brings a deleted file back, and adding or removing L locks 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 E marks 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