This is a cache of https://vccplus.brianholman.com/manuals/nitros9-on-vcc-plus/disk-names/. It is a snapshot of the page as it appeared on 2026-11-21T00:01:29.252+0000.
Find the disk behind the name · 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

Chapter 2 of 6

Find the disk behind the name

The prompt ends in /DD:. In the Mac’s Virtual Hard Disks window, the drives are called HD0 and HD1. Why do the names disagree? Each belongs to a different layer of your computer. The Mac attaches an image file to a drive; OS-9 gives a name to the filesystem it opens there.

Ask three names for their directories

Click the CoCo display. At the ready shell prompt, enter these commands separately, pressing Return after each one:

dir /dd
dir /h0
dir /h1

In the supplied profile, /dd and /h0 show the same system directory. Look for names such as CMDS, GAMES and SOURCES. /h1 opens the data filesystem on the second hard disk. On fresh practice media, its heading is followed by the next prompt: there are no files there yet.

Name In this profile
HD0, in the Mac controls The image containing the prepared NitrOS-9 system
/dd and /h0, in the shell Two device names reaching that system filesystem
HD1, in the Mac controls The working data image
/h1, in the shell The OS-9 filesystem in the working data image
The current Virtual Hard Disks window shows separate HD0 and HD1 assignments, save modes and Edit buttons using small authored examples. Your practice profile uses its NitrOS-9 system image in HD0 and working data image in HD1; check those filenames in your own window.

Keep the in this profile qualification. Device names belong to a configured OS-9 system. Another boot disk can use a different arrangement.

If /h1 already contains files, keep them. You may have opened your existing working media instead of a new practice copy. The log lesson needs one unused directory name. It does not need an empty hard disk.

Read a path from left to right

Here is the destination you will create in the next chapter:

/h1/mission/captains.log
Part Job
The first / Start with a device name, rather than the current directory
h1 Choose the data filesystem
mission Enter a directory on it
captains.log Name a file in that directory

The slashes separate the steps. This is an absolute path: it gives the route from the device to the file. In historical OS-9 documentation, you will also see the word pathlist.

A shorter name such as captains.log is relative to your current data directory. It becomes useful after you have moved into mission. That will save typing, but it also makes your current location important. A perfectly good filename can produce an error when you ask for it in the wrong place.

OS-9 file lookup here ignores letter case. The prompt may show /H1 while you type /h1. Those names reach the same device. Text stored inside a file keeps its own case; beacon in sight will stay lowercase.

Keep BASIC and OS-9 files apart

The working data image supplied with the system profiles contains separate space for OS-9 files and RGB-DOS BASIC volumes. That explains something that can look alarming on a first visit: /h1 can be empty even though you remember a HELLO program on that image.

HELLO belongs to the BASIC part. An OS-9 directory lists the OS-9 part. Neither listing is a catalog of every byte in the Mac image file.

The default floppy is also a BASIC disk. Attaching it to FD0 does not turn it into an OS-9 filesystem. Keep it as it is. This book uses the already prepared hard disks, so no formatting is required. Software, Storage, and Peripherals follows the same working image from the BASIC side.

The Mac's Disk Image Editor can browse supported raw OS-9 and Disk BASIC filesystems without booting them. Choose Edit… beside HD0 or HD1 in Virtual Hard Disks…. The mounted machine pauses and stays locked while the editor is open; applying edits requires a restart. In an image shared by OS-9 and HDB-DOS, the volume selection distinguishes the OS-9 filesystem from its numbered BASIC disks. Selecting one does not show the files in the others, and the editor's volume names do not replace guest names such as /h1. A numbered BASIC disk that overlaps declared OS-9 boot data is protected and omitted from the editable choices. For these lessons, continue with the guest commands below; follow the native editor guide when you want to inspect a working copy from the Mac.

Give commands their own home

OS-9 keeps a current data directory for your files and a current execution directory for finding commands. The prepared system puts its commands in CMDS. Moving your data directory to /h1/mission will let you use a short log filename while still running commands such as dir and list.

Think of the data directory as your desk and the execution directory as the tool cupboard. You can move your papers to a different desk without carrying the cupboard along. We will change only the data directory in this lesson.

The next chapter turns those names into something worth finding again: your first captain’s log.

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