PiDP-8/I Software

Running FOCAL,1969
Log In

The PiDP-8/I project defaults to U/W FOCAL, but it has an option that lets you either add FOCAL,1969 to this or switch to it by disabling U/W FOCAL entirely:

$ ./configure --enable-os8-focal69 --disable-os8-uwfocal

Once that software is built and installed, you might then wonder, "How do I get started?" This document is our answer to that question.

Running Programs with OS/8

OS/8 does not handle commands the same way as Unix, MS-DOS, or the Windows command shells cmd.exe and PowerShell. The first word in an OS/8 command is handled either by the OS/8 Keyboard Monitor or by the optional Concise Command Language (CCL) feature of OS/8. (See pages 1-35 and 1-52 in the 1974 edition of the OS/8 Handbook, respectively, for more information on these OS/8 features.)

In Unix terms, it is as if OS/8 has nothing but shell built-in commands. There is no command PATH in OS/8, not even a hard-coded one.

If you want to run external executables in OS/8 (e.g. *.BN, *.LD, *.SV, etc.) you must give a Keyboard Monitor or CCL command to load them, or you must run a command that can in turn load them.

CCL adds some aliases for running binaries that makes it work more like Unix or DOS (e.g. "TECO"), but don't get confused about what's going on here: these are just one-off helpers, not generic support of running external programs as shell commands.

Starting FOCAL,1969

I've taken the time to go into all of that detail because it explains why none of the following commands start the FOCAL.BN binary we ship when you build the OS/8 disk packs with FOCAL,1969 enabled:

.FOCAL
.R FOCAL
.RUN FOCAL

What you actually want is to start the OS/8 absolute binary loader, which is what handles *.BN files such as FOCAL.BN:

.R ABSLDR
*FOCAL/G

The /G option means "go," starting the program immediately after loading it into core memory.

You'll get another "*" prompt after that, but it's from FOCAL, not ABSLDR. See page 1-108 in the OS/8 handbook linked above for more detail about ABSLDR commands.

There's a CCL shortcut for this:

.EXE FOCAL

The "execute" command in CCL understands several file name extensions (not just *.BN) and has hard-coded recipes for loading and running each type of file. That shortcut doesn't have all of the flexibility you get from starting commands via the dedicated loader program, though, and it can sometimes cause trouble. (See "How to Wreck Your Adventure Game" in our Adventure wiki article for an example.)

Returning to OS/8 from FOCAL,1969

Say "L" (LOGICAL EXIT) at the FOCAL * prompt to get back to OS/8. Unlike U/W FOCAL, FOCAL,1969 does not do this on Ctrl-C.

Using FOCAL,1969

There are several freely-available PDF documents for DEC FOCAL which apply to varying degrees to what we ship. We recommend reading them in this order:

On Naming

You might be wondering about our use of the name "FOCAL,1969". That's because that's how the software identifies itself on starting up:

.EXE FOCAL
*W
C-FOCAL,1969

Calling it by that name refers to a fairly specific version of the software, which matches what we distribute. It is sometimes also called "FOCAL 69", though that term was not favored by DEC.

Another name that was favored by DEC's marketing department is "FOCAL-8." This is a generic name not referring to any specific version of FOCAL. You can read it as "DEC FOCAL on the PDP-8."

There were many variants of FOCAL back in the day, some from DEC and some from outsiders. Because the language was never formally standardized, and there never was one dominant version, it can be useful to be specific about which variant you're talking about. Generic terms like "FOCAL", "FOCAL 69", or "FOCAL-8" should be used only when you're not trying to refer to a specific version.

License

This article is © 2019 by Warren Young and is licensed under the terms of the SIMH license.