The Monkey Wrench II
- Medium
- Cartridge
- Year
- 1983
- Publisher
- Eastern House Software (Winston-Salem, North Carolina)
- Type
- Utility
- Category
- Atari BASIC programming aid and monitor (cartridge)
- Developer
- J. R. Hall
- Language
- 6502 machine language
- Requirements
- Atari 800 with Atari BASIC (Monkey Wrench II goes in the right cartridge slot), or an XL/XE with built-in BASIC using the separate XL version; disk drive for the DOS commands
- Tags
- basic, programming-aid, renumber, monitor, cartridge, right-slot, eastern-house, atari-800, xl
- Related
- Altirra
Overview
Atari BASIC has a good screen editor but no programmer's conveniences: no automatic line numbers, no renumbering, no search and replace. The Monkey Wrench II from Eastern House Software adds them. It is a machine-language cartridge that sits alongside BASIC and gives you 33 new direct-mode commands, plus a 6502 machine-language monitor with 16 commands. The manual's pitch is that it can do in seconds what would otherwise take hours of retyping.
The original Monkey Wrench (1981) was one of the very few commercial cartridges for the Atari 800's right-hand slot. It had nine commands: auto line numbering, delete lines, margins, a memory test, renumber, cursor exchange, hex and decimal conversion, and the monitor. Monkey Wrench II (copyright 1983) greatly enlarged the set. It came in two physically different editions that are not interchangeable: a right-slot cartridge for the Atari 800, and an XL version for the single slot of the XL machines, where BASIC is built in. Antic's New Products column listed it in mid-1983.
Features
Every command is typed without a line number and starts with > in the first column:
| Command | Function |
|---|---|
>A 1000 10 |
Automatic line numbering (start, step); >E ends it |
>R 10 10 |
Renumber, including GOTO/GOSUB references |
>D 100 200 |
Delete a range of lines |
>MO / >CO |
Move or copy a block of lines to a new line number |
>F /FOR/ |
Find every occurrence of a string |
>X /GOTO 100/GOTO 500/ |
Search and replace (exchange) |
>L / >LP |
Formatted listing to screen or printer, with page numbers |
>V / >VP |
Show every variable and its current value |
>SE |
Scroll enable: START and SELECT scroll the listing down and up |
>M 2 37 |
Set screen margins |
>$ FF, ># 255 |
Hex to decimal and decimal to hex |
>U |
Upper-case lock |
>* |
Enter the monitor |
There are also DOS commands that work without loading DUP.SYS: >>2 lists drive 2's directory (>>2P also prints it), >>F1 formats (in DOS 2 or DOS 3 format, matching the running DOS), and >>L, >>U, >>D and >>R lock, unlock, delete and rename files. CTRL+5 to CTRL+0 type PRINT#6, ENTER "D, LIST "D, RUN "D, LOAD "D and SAVE "D. A "cursor exchange" mode lets the arrow keys work without CTRL. The XL version adds home keys: CTRL+H, B, L and R jump to the top, bottom, left and right of the screen.
The monitor uses a period as its prompt. It can display memory in hex (M) or with ATASCII (I), alter memory and registers by editing the dump on screen and pressing RETURN, show registers (R), run code (G, returning on BRK), hunt for strings (H), and save or load memory to and from cassette (S/L). The manual uses those cassette commands to back up ordinary boot-format tapes.
How to use it
On the 800, put BASIC in the left slot and Monkey Wrench II in the right, then type X=USR(32768) to start it. The cartridge lives at $8000. An earlier production run started automatically, as the first Monkey Wrench did. On an XL, plug the XL version into the only slot; BASIC still works, and you start it with the same USR call. Once it is running, RESET and trips to DOS leave it active.
Some gotchas from the manual:
- It truncates BASIC lines longer than 120 characters. Atari BASIC lets lines grow longer than three screen rows once entered, so check long lines before using commands that rewrite them.
>MOmoves lines exactly as stored, so you must fix any GOTO references to them yourself (unlike>R).- Take the cartridge out to run finished programs and games. The manual warns that its hooks can upset them.
- On an 800 whose right slot has never been used, clean the contacts first.
Compatibility and emulation
The Monkey Wrench II prints by jumping straight into the OS printer handler, without opening P: first. That made it incompatible with the Microbits MPP-1100 printer interface, whose replacement OS ROM changes the handler. It also showed up decades later: Altirra 3.91 (2021) adjusted the built-in AltirraOS printer handler so that Monkey Wrench II works with it. The original Monkey Wrench needs the 400/800 OS.
In an emulator, set up an Atari 800 with Atari BASIC as the left cartridge and load the Monkey Wrench II image as a right-slot cartridge. For an XL/XE configuration, use the XL version instead. Altirra or another emulator with the real Atari OS is the safest choice.
Credits
- Picture: The Monkey Wrench II cartridge from Eastern House Software. — Cartridge scan from AtariMania (monkey_wrench_ii_cart.jpg) (Label © Eastern House Software — used for identification/commentary)
- The Monkey Wrench II Users Guide (Eastern House) — Internet Archive item MonkeyWrenchIIEasternHouse — Internet Archive
- The Monkey Wrench II for Atari XL Users Guide — Internet Archive item the-monkey-wrench-ii-xl — Internet Archive
- The Monkey Wrench (version I) manual, Eastern House 1981 — Internet Archive item EHSMonkeyWrench — Internet Archive, 1981
- AtariMania — Monkey Wrench II — Cartridge scan from AtariMania (monkey_wrench_ii_cart.jpg) (Label © Eastern House Software — used for identification/commentary)
- comp.sys.atari.8bit FAQ — 8.3 Right-slot cartridges; MPP-1100 incompatibilities; programs needing the 400/800 OS — Michael Current (comp.sys.atari.8bit FAQ)
- Altirra extended change log — version 3.91 (AltirraOS P: handler fix for Monkey Wrench II) — Avery Lee (Altirra)
- Antic Vol. 2 No. 2 contents — New Products include Monkey Wrench II — AtariMagazines.com (Kevin Savetz)
