Appendix A
Beside the keyboard
Keep this page open next to the emulator if you're trying a personal disk for the first time. The practice files also work offline. Save a copy in a Finder folder you can return to.
Pick up the practice files
| File | Open it here | What you can do |
|---|---|---|
| Port Zero.dsk | Media → Floppy Disks…, in FD0 | A whole BASIC floppy with PORT already on it. Follow the protected-disk exercise. |
| PORT.bas | Develop → BASIC Development… → Open… | The same program, in five editable lines. It asks for your call sign on a 40-column screen. |
| STRIPES.bas | Develop → BASIC Development… → Open… | Run the program and leave it waiting while you change video signals. |
In the app, select the disk link and choose where to save a working copy. Select either BASIC link to open an editable example in BASIC Development. Some browsers open a BASIC listing as plain text. To use the offline original, choose Open… in BASIC Development and select the named file in the examples folder beside this book. Make a copy before changing it. Port Zero needs the floppy controller and Disk BASIC. The two listings run from the editor at a BASIC prompt. Open the disk image when you want the drive to take part.
When an old habit gets a surprising result
| What you see | What to check |
|---|---|
| Typing moves a Mac control. | Click the CoCo display or use Input → Focus CoCo Display. If the toolbar says Run, resume the machine first. |
| You clicked Run but BASIC is still at OK. | The Mac toolbar resumed the machine. To start a BASIC program already in RAM, type RUN at the prompt. |
You can read PORT, but trying to save LOG gives ?WP ERROR. |
On the protected practice disk that's the expected result. Run PORT again from RAM. To keep a change, use your own writable copy. |
| You recognize the filename HELLO but suspect you're reading the wrong disk. | Check your profile. In Hard Drive BASIC, compare the hard disk and floppy. Both can have a HELLO at drive zero. |
| You came back to the right disk but your program is gone from the screen. | A profile reopens its media and starts a fresh machine. Load the copy you previously saved on that disk. See Come home. |
| You expected blue and orange but see two sets of stripes. | Keep STRIPES running and choose Composite TV under Video Signal. Compare the two actual pictures. |
Before you put a treasured disk away
Look at the drive's Mac filename, the write mode beneath it, and any message about pending changes. Write protected prevents guest writes. Saves automatically writes changes to that Mac image. Temporary changes holds writes in memory. If you want to keep temporary edits, choose Actions → Save As… and give the copy its own name before ejecting or switching setups.
Try it on disposable media in Prove which copy changed.
For another turn at the desk, keep both pieces: the file containing your program and a note or profile telling you how you ran it. The book's final exercise walks through saving your setup and returning to it.