This is a cache of https://vccplus.brianholman.com/manuals/nitros9-on-vcc-plus/field-guide/. It is a snapshot of the page as it appeared on 2026-11-21T00:00:57.534+0000.
At the OS-9 prompt · NitrOS-9 on VCC Plus — A Practical Quick Start · 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 8: NitrOS-9 on VCC Plus — A Practical Quick Start

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

Download PDF
Contents

Appendix A

At the OS-9 prompt

Keep this page beside the emulator while you explore. Begin by looking at the prompt. Commands belong to the computer that is listening: BASIC, the OS-9 shell, or an explicitly opened Mac shell.

Which prompt is this?

What you see Who is listening What to do next
A Shell+ prompt ending in /DD: or /H1/mission: The CoCo's OS-9 shell Try the directory and file commands below. The path names the current data directory.
OK after the HARD DISK BASIC banner CoCo BASIC with RGBDOS PRINT 2+3 prints 5. DOS 255 starts the supplied NitrOS-9 system again.
R.Gault's Emulator Hard Drive System menu The archive's BASIC menu program Choose 6, EXIT TO BASIC, and press Return. This is the extra step after the cold restart.
Your Mac's shell prompt after allowing telnet macshell 2323 Your Mac user account /usr/bin/uname prints Darwin. exit ends that shell and returns to OS-9.

A Mac shell prompt can vary with your own settings. Recognize it by the connection you deliberately opened, rather than by expecting a particular symbol. See An optional connection to another computer.

Find a disk, directory or file

Type one command, press Return, and wait for the next prompt before entering another. These examples use the supplied NitrOS-9 L2 V3.3.0 setup and the log created in Leave a captain's log.

Your task Command Checkpoint
Look at the system disk dir /dd The listing includes CMDS, GAMES and SOURCES.
Use its other device name dir /h0 You see the same system directory.
Look at the data filesystem dir /h1 A fresh working copy is empty. Keep any files already present on your own copy.
Find the log's directory dir /h1/mission The listing includes captains.log after the exercise.
Work inside that directory chd /h1/mission The prompt's path changes to /H1/mission:.
Check your current data directory pwd It prints /H1/mission.
Read the file from that directory list captains.log It prints beacon in sight.
Read the file from another directory list /h1/mission/captains.log The full path reaches the same saved message.

An initial / makes the path start with a device name. In /h1/mission/captains.log, /h1 names the data filesystem, mission names its directory, and captains.log names the file. Without that initial device path, OS-9 looks for a data file relative to your current data directory.

OS-9 file lookup is case-insensitive in this setup. The screen can display /H1/mission even when you typed /h1/mission. Text inside a file keeps its own case. The command name and its arguments also do different jobs: list is the program to run; captains.log is the data it reads. The shell has a separate execution directory for finding command programs. See Find the disk behind the name before assuming a command must live beside your log.

Leave a new log

Use these commands once on a fresh practice copy where mission does not yet exist:

makdir /h1/mission
chd /h1/mission
pwd
echo beacon in sight >captains.log
dir
list captains.log

makdir creates the directory. chd changes where the following relative filename will be found. The > sends the output of echo into a new file. list reads those saved characters back.

The output should finish with beacon in sight. Let the command complete and the app finish saving the writable hard-disk image. Preserve that same HD1 image when you restart. Find your way back shows how to recover the log from a new session.

When a command answers with an error

Message in this exercise What happened Useful next step
ERROR #216 after list /h1/captains.log That path does not name the saved file. The log is inside mission. Enter dir /h1/mission, then list /h1/mission/captains.log.
ERROR #218 after repeating makdir /h1/mission The directory already exists. Use chd /h1/mission to enter it and dir to inspect it.
ERROR #218 after repeating echo beacon in sight >captains.log This shell's single > would create a file whose name already exists. The tested command leaves the original intact. Read it with list captains.log, or repeat the lesson using a new filename.

An error number is a clue about the command that just ran. Check the path and the current directory before deciding that a disk or file has disappeared. A fresh practice copy is useful for repeating the lesson; it does not require replacing the disk that holds your earlier work.

Map the equipment to the names

The following map describes the built-in NitrOS-9 L2 V3.3.0 profile. Fresh-media copies use their own files. Inspect the mounted assignments in VCC Plus to identify the actual Mac files for your session.

Mac image or component VCC Plus assignment Meaning inside this setup
Working NitrOS-9 L2 V3.3.0.vhd HD0, through the hard-disk controller in Multi-Pak slot 1 /dd and /h0 reach its OS-9 system filesystem.
Working Hello World.vhd HD1, through the same controller in slot 1 /h1 reaches its OS-9 data filesystem. This is where the captain's log goes.
Working Hello World.dsk FD0, through the FD-502 controller in slot 4 The supplied floppy holds a BASIC filesystem. It is not an OS-9 practice disk.
RGBDOS ROM FD-502 in startup slot 4 BASIC can boot the supplied system with DOS 255. BASIC volume numbers and the app's HD0/HD1 labels describe different levels of storage.

The shared Hello World.vhd has separate OS-9 and BASIC areas. The ordinary Hard Drive BASIC profile mounts that shared working file as HD0. The NitrOS-9 profile mounts it as HD1. Changing the app's assignment does not turn its BASIC files into OS-9 files. See Which part of the image? for the broader storage map.

The tested starting machine uses the MC6809, 512 KB, and Composite video. These exercises also passed on the HD6309 in its startup mode. A profile saves equipment choices and file references. It does not preserve a running process or its memory. Where is my work? explains how to keep those different kinds of state straight.

See which guest drivers serve these devices in Trace three paths from the same shell.

Continue the journey

For the surrounding Mac controls, use The VCC Plus User's Handbook. For media formats and the difference between a mounted image and the files inside it, turn to Software, Storage, and Peripherals.

Take the next watch in Working with OS-9. Turn the log into a shell procedure, follow its bytes onto disk, or assemble a report writer inside OS-9. Keep the command finder handy while you work.

Books behind the journey

  • The NitrOS-9 Project. NitrOS-9 Operating System User's Guide. Version 03.02.01, 2004. Sections 2.1–2.3, pp. 5–7, on the shell; sections 3.2–3.5, pp. 10–14, on devices, pathlists and directories; section 3.8, pp. 15–16, on working directories; section 4.2.2, pp. 23–24, on redirection.
  • Tandy Corporation and Microware Systems Corporation. OS-9 Commands Reference. 1986. CHD/CHX, p. 6-12; DIR, pp. 6-35–6-37; ECHO, p. 6-42; LIST, p. 6-59; MAKDIR, p. 6-63; PWD/PXD, p. 6-82.
  • Tandy Corporation. Getting Started With OS-9, in OS-9 Level Two Operating System. 1986. Chapter 4, pp. 4-5–4-6, on pathlists and device names; chapter 6, pp. 6-1–6-5, on directories and files.

The Color Computer Archive preserves historical documentation that informed this book. The lessons and command exercises here were written for VCC Plus.

Original VCC Plus prose and instructional images © 2026 Brian K. Holman. See the application's Licenses & Notices and the library's artwork credits.

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