Appendix E
Find your way back into the system
An OS-9 manual from the 1980s can explain a process descriptor in today’s emulated CoCo. Its example boot disk may give the terminal a different driver or start a different shell. Use the book to understand the structure, then use the guest to identify the particular parts you have.
Which edition is on the screen?
The prepared image identifies itself as NitrOS-9/6809 Level 2 V3.3.0 and dates its build August 14, 2015. Its interactive shell identifies itself as Shell+ v2.2a. All required programs and practice files in these chapters use this supplied system and your own writable HD1. The guest operating system, shell, BASIC09 and C compiler each have their own versions.
| Question | Where to look |
|---|---|
| Which processor and memory did I configure? | The running VCC Plus machine and its profile. The book’s exercises use 512 KB. A 6809 program can also run on the HD6309 in its startup mode. Both runs here used the same 6809 OS image. |
| Which shell, disks and device drivers am I actually using? | Read the startup banner, check the two mounted hard-disk images in the Mac controls, then consult the device table. |
| Why does a command in a period manual behave differently? | Compare the manual’s shell and utility editions to the command finder and the guest’s own help. For example, the second greater-than sign in this Shell+ output syntax selects the error path. |
| How do I get back to a known boot? | Preserve the bootable system image and restore the personal practice data. For a separate boot experiment, start from a fresh personal copy of the built-in profile and confirm it reaches Shell+ before changing it. A working copy of HD0 together with its matching profile gives you a route back to that boot. |
Read by question
- I’m new to OS-9. Start with Book 8’s practice setup. Once you have recovered your captain’s log, write the station procedure.
- Where are my files? Trace the file through the data and execution directories, then follow its sectors. The storage book explains why the same VHD also holds BASIC volumes.
- What is the CPU actually doing? Start with the CoCo 3 MMU lesson, then match a guest process to physical memory. The debugger workbench identifies the Mac controls used to inspect the machine.
- I want to write a command. Build the same kind of executable the shell knows how to start. Follow Night in BASIC09, Beacon in assembly, or the guest C build. Book 6 covers the Mac CMOC workbench for BASIC-hosted programs.
Trace a command lookup in a period guide
When you type a command name, where does the shell look after checking the module directory? Choose Help → Archive Library…, select Entire Archive and search for OS-9 Level II module directory. Under Dale Puckett and Peter Dibble’s Complete Rainbow Guide to OS-9 Level II, open the result for PDF page 79. The printed page number is 64. It explains how the shell looks in the current execution directory when the requested module is absent from memory. Compare the guide with the Echo module on your practice system.
Choose Copy Citation to keep the Archive’s original ZIP link, the name of the PDF inside it and the PDF page you opened. If you refer someone to the printed book, include page 64 as well.
Books behind the exercises
- The NitrOS-9 Project. NitrOS-9 Operating System User’s Guide, version 03.02.01 (2004). §§4.2–4.7, pp. 23–28, cover redirection, concurrent commands and procedures. Chapters 5–6, pp. 30–37, explain process scheduling and startup organization.
- The NitrOS-9 Project. NitrOS-9 Technical Reference, revision 0.1 (July 10, 2004). Chapters 1–4 describe the kernel, Level Two memory, module headers and paths. Chapters 5–7 describe the random block, sequential character and pipe file managers. Chapter 8 indexes the service requests. See F$Exit, p. 99, F$Fork, p. 100, F$Wait, p. 128, I$ReadLn, p. 144, and I$WritLn, p. 148.
- The NitrOS-9 Project. The NitrOS-9 Level 2 Windowing System, revision 0.1 (June 4, 2004), pp. 7–8, 20–23, 44, 49 and 58. These sections describe creating, selecting, drawing into and closing the graphics window.
- Tandy Corporation and Microware Systems Corporation. OS-9 Commands Reference (1986). Compare the original CHD/CHX, DIR, LIST, PWD/PXD and process-command entries with the contemporary guest’s command help.
- Tandy Corporation. OS-9 Level Two Development System (1987). “Relocating Macro Assembler,” chapters 1–2, 5 and 9. See the language guide for BASIC09 and C sources and the build paths used on this system.
The Color Computer Archive preserves historical documentation that informed this book. The lessons, programs and instructional captures here were produced for VCC Plus.
Original manual prose and instructional images © 2026 Brian K. Holman. See artwork credits and the application’s Licenses & Notices.