DiskWiz-II

Year
1983
Publisher
Allen Macroware (Redondo Beach, California)
Type
Utility
Category
Disk sector editor, repair and duplication utility
Developer
Jerry Allen
Language
Atari BASIC with machine-language routines
Requirements
Atari 400/800 (later 1200XL-compatible) with 16K or more (48K recommended), Atari BASIC cartridge, one or two Atari 810 or Percom-type drives
DiskWiz-II command menu in white text on black, listing commands A Alter Data through Z Search, with ENTER SECTOR# OR COMMAND? at the bottom

Overview

DiskWiz-II is a sector-level disk editor and repair kit for the Atari 400/800. It was written by Jerry Allen and sold by his company Allen Macroware of Redondo Beach, California, with a copyright of 1982–83. Antic's New Products column for July 1983 described it as a disk editor for Atari and Percom drives. It needed 16K and one or two drives, repaired both DOS and non-DOS sectors with on-screen hex and ASCII editing, had a built-in disassembler, and was "now 1200XL compatible".

It bypasses DOS completely and lets you work on the raw structure of a disk: the directory at sectors 361–368, the VTOC bitmap at sector 360, and the three link bytes at the end of every DOS 2 data sector. This was the kind of tool you reached for when a disk came back with ERROR 164 or a file had just been deleted by mistake. In 2021 Jerry Allen released DiskWiz-II into the public domain, on the one condition that nobody charges for it.

Features

Type a sector number to display it, or a single letter for a command:

  • Main display: the 128 bytes of the sector as hex and ATASCII side by side. Under it are the status code and, for DOS 2/OS/A+ sectors, the decoded file number, next-sector link and byte count. Double-density sectors are shown in two halves.
  • A alters bytes on either the hex or the character side. Nothing reaches the disk until you deliberately use W to write the sector, which asks you to confirm.
  • F reformats the screen as a readable directory listing, so you can edit entries.
  • M maps the whole disk on one screen, with a code for every sector showing which file owns it, whether it is free, empty or bad, and whether the owning file is live or deleted. T traces a single file along its link pointers, whether or not the file is still in the directory.
  • R moves a block of sectors elsewhere, and S rebuilds a run of link pointers afterwards. E rewrites the file-number bits, and V checks, locks or frees sectors in the VTOC bitmap. These are the commands you need to defragment a file by hand or splice a damaged one back together.
  • D duplicates sector ranges between drives or by swapping disks, buffering as many sectors as memory allows: about 196 per pass on a 48K machine and 76 on 32K.
  • X disassembles machine code straight from a sector, with an offset to skip a binary-file header. H is a hex/decimal/ASCII calculator, and Z searches the whole disk for a string.
  • G and P print screens. G reproduces inverse and graphics characters on Epson/Graftrax or NEC/Prowriter printers.
  • Y is a drive speed check, updated every few seconds. The manual gives 288 ±3 rpm as correct for an 810 and 295–301 rpm for Percom drives, and explains where the adjustment potentiometer sits on older and newer 810 boards.
  • U opens a utility menu that switches density, formats a disk without writing DOS sectors, selects the printer type and turns write-verify on or off.

Behind the scenes

The manual is part reference and part tutorial on DOS 2's disk layout. It shows how to recover a deleted file (flag the directory entry as in use again, trace its sectors, re-lock them in the VTOC). It also explains how to fix duplicate filenames, change the load addresses in a binary file's header, salvage a disk that will not format by locking out its bad sectors, and use the reverse side of a disk by cutting a second write-protect notch. That last trick does not work on Percom drives, which use the index hole.

Like many disk utilities of its day, it also discusses copy protection. DiskWiz copies unreadable "bad" sectors as blank good ones, so protected software often refuses to run from a copy. The manual explains how users of the time slowed an 810 down to create bad sectors deliberately, while reminding readers that copying is legal only for backups of disks they own.

Although its time-critical routines are machine language, DiskWiz runs through the Atari BASIC cartridge. If the disk finishes loading and leaves you at a READY prompt, the program did not load properly.

Limitations

DiskWiz-II was designed around 720-sector DOS 2 disks. When Atari's DOS 2.5 arrived in 1985, Antic found that DiskWiz 2 could read enhanced-density sectors up to 1023 but would not map or trace beyond sector 720. Its own "format" command writes only the track and sector structure. To make a DOS disk from it you copy sectors 1–3 and 360–368 from a disk formatted by DOS.

Using it today

Boot the DiskWiz-II disk with BASIC enabled (on an XL/XE, do not hold OPTION) on a 48K or larger machine set up as an 800 or XL. Disk images of single-density DOS 2 disks behave exactly like the floppies the program expects. As the manual itself insists, work on a copy. On a modern setup that just means duplicating the ATR file before you start editing sectors.

Credits