This is a cache of https://vccplus.brianholman.com/manuals/working-with-os9/sources/. It is a snapshot of the page as it appeared on 2026-11-21T00:01:36.986+0000.
Find your way back into the system · Working with OS-9 — A Comprehensive Manual · VCC Plus
← Manual LibraryVCC Plus 3.7.1 · Reading on the web

Try the exercises in VCC Plus. Example links download files here; open them in the app to work beside the emulator.

The complete book · PDF editionBook 11: Working with OS-9 — A Comprehensive Manual

51 pages · VCC Plus 3.7.1 · Keep a copy to read or print.

Download PDF
Contents

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

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.

Original VCC Plus manuals © 2026 Brian K. Holman. Third-party references retain their authors’ copyrights and licenses. Artwork notices. Edition 3.7.1; source and export identity. Printable edition: PDF source and export identity.

A closer look

Open original