Artifact
f5cb6120e5f902d49821e3fab04b295f5ae0707f:
Wiki page
[Running FOCAL,1969] by
tangent
2019-08-16 10:53:09.
0000: 44 20 32 30 31 39 2d 30 38 2d 31 36 54 31 30 3a D 2019-08-16T10:
0010: 35 33 3a 30 39 2e 37 39 39 0a 4c 20 52 75 6e 6e 53:09.799.L Runn
0020: 69 6e 67 5c 73 46 4f 43 41 4c 2c 31 39 36 39 0a ing\sFOCAL,1969.
0030: 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 N text/x-markdow
0040: 6e 0a 50 20 36 30 36 35 34 63 66 35 30 62 61 38 n.P 60654cf50ba8
0050: 39 64 35 39 62 32 39 63 37 38 34 35 37 38 31 64 9d59b29c7845781d
0060: 31 37 62 32 37 63 64 66 33 61 34 35 0a 55 20 74 17b27cdf3a45.U t
0070: 61 6e 67 65 6e 74 0a 57 20 36 31 34 38 0a 54 68 angent.W 6148.Th
0080: 65 20 50 69 44 50 2d 38 2f 49 20 70 72 6f 6a 65 e PiDP-8/I proje
0090: 63 74 20 64 65 66 61 75 6c 74 73 20 74 6f 20 5b ct defaults to [
00a0: 55 2f 57 20 46 4f 43 41 4c 5d 5b 75 77 66 5d 2c U/W FOCAL][uwf],
00b0: 20 62 75 74 20 69 74 20 68 61 73 20 5b 61 6e 20 but it has [an
00c0: 6f 70 74 69 6f 6e 5d 5b 6f 70 74 5d 20 74 68 61 option][opt] tha
00d0: 74 20 6c 65 74 73 20 79 6f 75 20 65 69 74 68 65 t lets you eithe
00e0: 72 20 61 64 64 20 46 4f 43 41 4c 2c 31 39 36 39 r add FOCAL,1969
00f0: 20 74 6f 20 74 68 69 73 20 6f 72 20 73 77 69 74 to this or swit
0100: 63 68 20 74 6f 20 69 74 20 62 79 20 64 69 73 61 ch to it by disa
0110: 62 6c 69 6e 67 20 55 2f 57 20 46 4f 43 41 4c 20 bling U/W FOCAL
0120: 65 6e 74 69 72 65 6c 79 3a 0d 0a 0d 0a 20 20 20 entirely:....
0130: 20 24 20 2e 2f 63 6f 6e 66 69 67 75 72 65 20 2d $ ./configure -
0140: 2d 65 6e 61 62 6c 65 2d 6f 73 38 2d 66 6f 63 61 -enable-os8-foca
0150: 6c 36 39 20 2d 2d 64 69 73 61 62 6c 65 2d 6f 73 l69 --disable-os
0160: 38 2d 75 77 66 6f 63 61 6c 0d 0a 0d 0a 4f 6e 63 8-uwfocal....Onc
0170: 65 20 74 68 61 74 20 73 6f 66 74 77 61 72 65 20 e that software
0180: 69 73 20 62 75 69 6c 74 20 61 6e 64 20 69 6e 73 is built and ins
0190: 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d 69 67 68 talled, you migh
01a0: 74 20 74 68 65 6e 20 77 6f 6e 64 65 72 2c 20 22 t then wonder, "
01b0: 48 6f 77 20 64 6f 20 49 20 67 65 74 20 73 74 61 How do I get sta
01c0: 72 74 65 64 3f 22 20 54 68 69 73 20 64 6f 63 75 rted?" This docu
01d0: 6d 65 6e 74 20 69 73 20 6f 75 72 20 61 6e 73 77 ment is our answ
01e0: 65 72 20 74 6f 20 74 68 61 74 20 71 75 65 73 74 er to that quest
01f0: 69 6f 6e 2e 0d 0a 0d 0a 0d 0a 23 20 52 75 6e 6e ion.......# Runn
0200: 69 6e 67 20 50 72 6f 67 72 61 6d 73 20 77 69 74 ing Programs wit
0210: 68 20 4f 53 2f 38 0d 0a 0d 0a 4f 53 2f 38 20 64 h OS/8....OS/8 d
0220: 6f 65 73 20 6e 6f 74 20 68 61 6e 64 6c 65 20 63 oes not handle c
0230: 6f 6d 6d 61 6e 64 73 20 74 68 65 20 73 61 6d 65 ommands the same
0240: 20 77 61 79 20 61 73 20 55 6e 69 78 2c 20 4d 53 way as Unix, MS
0250: 2d 44 4f 53 2c 20 6f 72 20 74 68 65 20 57 69 6e -DOS, or the Win
0260: 64 6f 77 73 20 63 6f 6d 6d 61 6e 64 20 73 68 65 dows command she
0270: 6c 6c 73 20 60 63 6d 64 2e 65 78 65 60 20 61 6e lls `cmd.exe` an
0280: 64 20 50 6f 77 65 72 53 68 65 6c 6c 2e 20 54 68 d PowerShell. Th
0290: 65 20 66 69 72 73 74 20 77 6f 72 64 20 69 6e 20 e first word in
02a0: 61 6e 20 4f 53 2f 38 20 63 6f 6d 6d 61 6e 64 20 an OS/8 command
02b0: 69 73 20 68 61 6e 64 6c 65 64 20 65 69 74 68 65 is handled eithe
02c0: 72 20 62 79 20 74 68 65 20 4f 53 2f 38 20 4b 65 r by the OS/8 Ke
02d0: 79 62 6f 61 72 64 20 4d 6f 6e 69 74 6f 72 20 6f yboard Monitor o
02e0: 72 20 62 79 20 74 68 65 20 6f 70 74 69 6f 6e 61 r by the optiona
02f0: 6c 20 43 6f 6e 63 69 73 65 20 43 6f 6d 6d 61 6e l Concise Comman
0300: 64 20 4c 61 6e 67 75 61 67 65 20 28 43 43 4c 29 d Language (CCL)
0310: 20 66 65 61 74 75 72 65 20 6f 66 20 4f 53 2f 38 feature of OS/8
0320: 2e 20 28 53 65 65 20 70 61 67 65 73 20 31 2d 33 . (See pages 1-3
0330: 35 20 61 6e 64 20 31 2d 35 32 20 69 6e 20 74 68 5 and 1-52 in th
0340: 65 20 5b 31 39 37 34 20 65 64 69 74 69 6f 6e 20 e [1974 edition
0350: 6f 66 20 74 68 65 20 4f 53 2f 38 20 48 61 6e 64 of the OS/8 Hand
0360: 62 6f 6f 6b 5d 5b 68 62 5d 2c 20 72 65 73 70 65 book][hb], respe
0370: 63 74 69 76 65 6c 79 2c 20 66 6f 72 20 6d 6f 72 ctively, for mor
0380: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e e information on
0390: 20 74 68 65 73 65 20 4f 53 2f 38 20 66 65 61 74 these OS/8 feat
03a0: 75 72 65 73 2e 29 0d 0a 0d 0a 49 6e 20 55 6e 69 ures.)....In Uni
03b0: 78 20 74 65 72 6d 73 2c 20 69 74 20 69 73 20 61 x terms, it is a
03c0: 73 20 69 66 20 4f 53 2f 38 20 68 61 73 20 6e 6f s if OS/8 has no
03d0: 74 68 69 6e 67 20 62 75 74 20 5b 73 68 65 6c 6c thing but [shell
03e0: 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6d 6d 61 6e built-in comman
03f0: 64 73 5d 5b 73 62 69 5d 2e 20 54 68 65 72 65 20 ds][sbi]. There
0400: 69 73 20 6e 6f 20 63 6f 6d 6d 61 6e 64 20 60 50 is no command `P
0410: 41 54 48 60 20 69 6e 20 4f 53 2f 38 2c 20 6e 6f ATH` in OS/8, no
0420: 74 20 65 76 65 6e 20 61 20 68 61 72 64 2d 63 6f t even a hard-co
0430: 64 65 64 20 6f 6e 65 2e 0d 0a 0d 0a 49 66 20 79 ded one.....If y
0440: 6f 75 20 77 61 6e 74 20 74 6f 20 72 75 6e 20 65 ou want to run e
0450: 78 74 65 72 6e 61 6c 20 65 78 65 63 75 74 61 62 xternal executab
0460: 6c 65 73 20 69 6e 20 4f 53 2f 38 20 28 65 2e 67 les in OS/8 (e.g
0470: 2e 20 60 2a 2e 42 4e 60 2c 20 60 2a 2e 4c 44 60 . `*.BN`, `*.LD`
0480: 2c 20 60 2a 2e 53 56 60 2c 20 65 74 63 2e 29 20 , `*.SV`, etc.)
0490: 79 6f 75 20 6d 75 73 74 20 67 69 76 65 20 61 20 you must give a
04a0: 4b 65 79 62 6f 61 72 64 20 4d 6f 6e 69 74 6f 72 Keyboard Monitor
04b0: 20 6f 72 20 43 43 4c 20 63 6f 6d 6d 61 6e 64 20 or CCL command
04c0: 74 6f 20 6c 6f 61 64 20 74 68 65 6d 2c 20 6f 72 to load them, or
04d0: 20 79 6f 75 20 6d 75 73 74 20 72 75 6e 20 61 20 you must run a
04e0: 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63 61 6e command that can
04f0: 20 69 6e 20 74 75 72 6e 20 6c 6f 61 64 20 74 68 in turn load th
0500: 65 6d 2e 0d 0a 0d 0a 43 43 4c 20 61 64 64 73 20 em.....CCL adds
0510: 73 6f 6d 65 20 61 6c 69 61 73 65 73 20 66 6f 72 some aliases for
0520: 20 72 75 6e 6e 69 6e 67 20 62 69 6e 61 72 69 65 running binarie
0530: 73 20 74 68 61 74 20 6d 61 6b 65 73 20 69 74 20 s that makes it
0540: 77 6f 72 6b 20 6d 6f 72 65 20 6c 69 6b 65 20 55 work more like U
0550: 6e 69 78 20 6f 72 20 44 4f 53 20 28 65 2e 67 2e nix or DOS (e.g.
0560: 20 22 54 45 43 4f 22 29 2c 20 62 75 74 20 64 6f "TECO"), but do
0570: 6e 27 74 20 67 65 74 20 63 6f 6e 66 75 73 65 64 n't get confused
0580: 20 61 62 6f 75 74 20 77 68 61 74 27 73 20 67 6f about what's go
0590: 69 6e 67 20 6f 6e 20 68 65 72 65 3a 20 74 68 65 ing on here: the
05a0: 73 65 20 61 72 65 20 6a 75 73 74 20 6f 6e 65 2d se are just one-
05b0: 6f 66 66 20 68 65 6c 70 65 72 73 2c 20 6e 6f 74 off helpers, not
05c0: 20 67 65 6e 65 72 69 63 20 73 75 70 70 6f 72 74 generic support
05d0: 20 6f 66 20 72 75 6e 6e 69 6e 67 20 65 78 74 65 of running exte
05e0: 72 6e 61 6c 20 70 72 6f 67 72 61 6d 73 20 61 73 rnal programs as
05f0: 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 73 2e shell commands.
0600: 0d 0a 0d 0a 0d 0a 23 20 53 74 61 72 74 69 6e 67 ......# Starting
0610: 20 46 4f 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 49 FOCAL,1969....I
0620: 27 76 65 20 74 61 6b 65 6e 20 74 68 65 20 74 69 've taken the ti
0630: 6d 65 20 74 6f 20 67 6f 20 69 6e 74 6f 20 61 6c me to go into al
0640: 6c 20 6f 66 20 74 68 61 74 20 64 65 74 61 69 6c l of that detail
0650: 20 62 65 63 61 75 73 65 20 69 74 20 65 78 70 6c because it expl
0660: 61 69 6e 73 20 77 68 79 20 6e 6f 6e 65 20 6f 66 ains why none of
0670: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 the following c
0680: 6f 6d 6d 61 6e 64 73 20 73 74 61 72 74 20 74 68 ommands start th
0690: 65 20 60 46 4f 43 41 4c 2e 42 4e 60 20 62 69 6e e `FOCAL.BN` bin
06a0: 61 72 79 20 77 65 20 73 68 69 70 20 77 68 65 6e ary we ship when
06b0: 20 79 6f 75 20 62 75 69 6c 64 20 74 68 65 20 4f you build the O
06c0: 53 2f 38 20 64 69 73 6b 20 70 61 63 6b 73 20 77 S/8 disk packs w
06d0: 69 74 68 20 46 4f 43 41 4c 2c 31 39 36 39 20 65 ith FOCAL,1969 e
06e0: 6e 61 62 6c 65 64 3a 0d 0a 0d 0a 20 20 20 20 2e nabled:.... .
06f0: 46 4f 43 41 4c 0d 0a 20 20 20 20 2e 52 20 46 4f FOCAL.. .R FO
0700: 43 41 4c 0d 0a 20 20 20 20 2e 52 55 4e 20 46 4f CAL.. .RUN FO
0710: 43 41 4c 0d 0a 0d 0a 57 68 61 74 20 79 6f 75 20 CAL....What you
0720: 61 63 74 75 61 6c 6c 79 20 77 61 6e 74 20 69 73 actually want is
0730: 20 74 6f 20 73 74 61 72 74 20 74 68 65 20 4f 53 to start the OS
0740: 2f 38 20 61 62 73 6f 6c 75 74 65 20 62 69 6e 61 /8 absolute bina
0750: 72 79 20 6c 6f 61 64 65 72 2c 20 77 68 69 63 68 ry loader, which
0760: 20 69 73 20 77 68 61 74 20 68 61 6e 64 6c 65 73 is what handles
0770: 20 60 2a 2e 42 4e 60 20 66 69 6c 65 73 20 73 75 `*.BN` files su
0780: 63 68 20 61 73 20 60 46 4f 43 41 4c 2e 42 4e 60 ch as `FOCAL.BN`
0790: 3a 0d 0a 0d 0a 20 20 20 20 2e 52 20 41 42 53 4c :.... .R ABSL
07a0: 44 52 0d 0a 20 20 20 20 2a 46 4f 43 41 4c 2f 47 DR.. *FOCAL/G
07b0: 0d 0a 0d 0a 54 68 65 20 60 2f 47 60 20 6f 70 74 ....The `/G` opt
07c0: 69 6f 6e 20 6d 65 61 6e 73 20 22 67 6f 2c 22 20 ion means "go,"
07d0: 73 74 61 72 74 69 6e 67 20 74 68 65 20 70 72 6f starting the pro
07e0: 67 72 61 6d 20 69 6d 6d 65 64 69 61 74 65 6c 79 gram immediately
07f0: 20 61 66 74 65 72 20 6c 6f 61 64 69 6e 67 20 69 after loading i
0800: 74 20 69 6e 74 6f 20 63 6f 72 65 20 6d 65 6d 6f t into core memo
0810: 72 79 2e 0d 0a 0d 0a 59 6f 75 27 6c 6c 20 67 65 ry.....You'll ge
0820: 74 20 61 6e 6f 74 68 65 72 20 22 60 2a 60 22 20 t another "`*`"
0830: 70 72 6f 6d 70 74 20 61 66 74 65 72 20 74 68 61 prompt after tha
0840: 74 2c 20 62 75 74 20 69 74 27 73 20 66 72 6f 6d t, but it's from
0850: 20 46 4f 43 41 4c 2c 20 6e 6f 74 20 60 41 42 53 FOCAL, not `ABS
0860: 4c 44 52 60 2e 20 53 65 65 20 70 61 67 65 20 31 LDR`. See page 1
0870: 2d 31 30 38 20 69 6e 20 74 68 65 20 4f 53 2f 38 -108 in the OS/8
0880: 20 68 61 6e 64 62 6f 6f 6b 20 6c 69 6e 6b 65 64 handbook linked
0890: 20 61 62 6f 76 65 20 66 6f 72 20 6d 6f 72 65 20 above for more
08a0: 64 65 74 61 69 6c 20 61 62 6f 75 74 20 60 41 42 detail about `AB
08b0: 53 4c 44 52 60 20 63 6f 6d 6d 61 6e 64 73 2e 0d SLDR` commands..
08c0: 0a 0d 0a 54 68 65 72 65 27 73 20 61 20 43 43 4c ...There's a CCL
08d0: 20 73 68 6f 72 74 63 75 74 20 66 6f 72 20 74 68 shortcut for th
08e0: 69 73 3a 0d 0a 0d 0a 20 20 20 20 2e 45 58 45 20 is:.... .EXE
08f0: 46 4f 43 41 4c 0d 0a 0d 0a 54 68 65 20 22 65 78 FOCAL....The "ex
0900: 65 63 75 74 65 22 20 63 6f 6d 6d 61 6e 64 20 69 ecute" command i
0910: 6e 20 43 43 4c 20 75 6e 64 65 72 73 74 61 6e 64 n CCL understand
0920: 73 20 73 65 76 65 72 61 6c 20 66 69 6c 65 20 6e s several file n
0930: 61 6d 65 20 65 78 74 65 6e 73 69 6f 6e 73 20 28 ame extensions (
0940: 6e 6f 74 20 6a 75 73 74 20 60 2a 2e 42 4e 60 29 not just `*.BN`)
0950: 20 61 6e 64 20 68 61 73 20 68 61 72 64 2d 63 6f and has hard-co
0960: 64 65 64 20 72 65 63 69 70 65 73 20 66 6f 72 20 ded recipes for
0970: 6c 6f 61 64 69 6e 67 20 61 6e 64 20 72 75 6e 6e loading and runn
0980: 69 6e 67 20 65 61 63 68 20 74 79 70 65 20 6f 66 ing each type of
0990: 20 66 69 6c 65 2e 20 54 68 61 74 20 73 68 6f 72 file. That shor
09a0: 74 63 75 74 20 64 6f 65 73 6e 27 74 20 68 61 76 tcut doesn't hav
09b0: 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 66 6c 65 e all of the fle
09c0: 78 69 62 69 6c 69 74 79 20 79 6f 75 20 67 65 74 xibility you get
09d0: 20 66 72 6f 6d 20 73 74 61 72 74 69 6e 67 20 63 from starting c
09e0: 6f 6d 6d 61 6e 64 73 20 76 69 61 20 74 68 65 20 ommands via the
09f0: 64 65 64 69 63 61 74 65 64 20 6c 6f 61 64 65 72 dedicated loader
0a00: 20 70 72 6f 67 72 61 6d 2c 20 74 68 6f 75 67 68 program, though
0a10: 2c 20 61 6e 64 20 69 74 20 63 61 6e 20 73 6f 6d , and it can som
0a20: 65 74 69 6d 65 73 20 63 61 75 73 65 20 74 72 6f etimes cause tro
0a30: 75 62 6c 65 2e 20 28 53 65 65 20 22 48 6f 77 20 uble. (See "How
0a40: 74 6f 20 57 72 65 63 6b 20 59 6f 75 72 20 41 64 to Wreck Your Ad
0a50: 76 65 6e 74 75 72 65 20 47 61 6d 65 22 20 69 6e venture Game" in
0a60: 20 6f 75 72 20 5b 41 64 76 65 6e 74 75 72 65 20 our [Adventure
0a70: 77 69 6b 69 20 61 72 74 69 63 6c 65 5d 28 41 64 wiki article](Ad
0a80: 76 65 6e 74 75 72 65 29 20 66 6f 72 20 61 6e 20 venture) for an
0a90: 65 78 61 6d 70 6c 65 2e 29 0d 0a 0d 0a 0d 0a 23 example.)......#
0aa0: 20 52 65 74 75 72 6e 69 6e 67 20 74 6f 20 4f 53 Returning to OS
0ab0: 2f 38 20 66 72 6f 6d 20 46 4f 43 41 4c 2c 31 39 /8 from FOCAL,19
0ac0: 36 39 0d 0a 0d 0a 53 61 79 20 22 4c 22 20 28 60 69....Say "L" (`
0ad0: 4c 4f 47 49 43 41 4c 20 45 58 49 54 60 29 20 61 LOGICAL EXIT`) a
0ae0: 74 20 74 68 65 20 46 4f 43 41 4c 20 60 2a 60 20 t the FOCAL `*`
0af0: 70 72 6f 6d 70 74 20 74 6f 20 67 65 74 20 62 61 prompt to get ba
0b00: 63 6b 20 74 6f 20 4f 53 2f 38 2e 20 55 6e 6c 69 ck to OS/8. Unli
0b10: 6b 65 20 55 2f 57 20 46 4f 43 41 4c 2c 20 46 4f ke U/W FOCAL, FO
0b20: 43 41 4c 2c 31 39 36 39 20 64 6f 65 73 20 6e 6f CAL,1969 does no
0b30: 74 20 64 6f 20 74 68 69 73 20 6f 6e 20 43 74 72 t do this on Ctr
0b40: 6c 2d 43 2e 0d 0a 0d 0a 0d 0a 23 20 55 73 69 6e l-C.......# Usin
0b50: 67 20 46 4f 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a g FOCAL,1969....
0b60: 54 68 65 72 65 20 61 72 65 20 73 65 76 65 72 61 There are severa
0b70: 6c 20 66 72 65 65 6c 79 2d 61 76 61 69 6c 61 62 l freely-availab
0b80: 6c 65 20 50 44 46 20 64 6f 63 75 6d 65 6e 74 73 le PDF documents
0b90: 20 66 6f 72 20 44 45 43 20 46 4f 43 41 4c 20 77 for DEC FOCAL w
0ba0: 68 69 63 68 20 61 70 70 6c 79 20 74 6f 20 76 61 hich apply to va
0bb0: 72 79 69 6e 67 20 64 65 67 72 65 65 73 20 74 6f rying degrees to
0bc0: 20 77 68 61 74 20 77 65 20 73 68 69 70 2e 20 57 what we ship. W
0bd0: 65 20 72 65 63 6f 6d 6d 65 6e 64 20 72 65 61 64 e recommend read
0be0: 69 6e 67 20 74 68 65 6d 20 69 6e 20 74 68 69 73 ing them in this
0bf0: 20 6f 72 64 65 72 3a 0d 0a 0d 0a 2a 20 20 20 5b order:....* [
0c00: 44 45 43 20 46 4f 43 41 4c 20 62 6f 6f 6b 6c 65 DEC FOCAL bookle
0c10: 74 5d 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 t](https://www.g
0c20: 72 63 2e 63 6f 6d 2f 70 64 70 2d 38 2f 64 6f 63 rc.com/pdp-8/doc
0c30: 73 2f 46 6f 63 61 6c 5f 42 6f 6f 6b 6c 65 74 2e s/Focal_Booklet.
0c40: 70 64 66 29 20 28 50 44 46 2c 20 32 35 35 20 6b pdf) (PDF, 255 k
0c50: 42 29 20 e2 80 94 20 54 68 69 73 20 69 73 20 61 B) — This is a
0c60: 6e 20 65 78 63 65 6c 6c 65 6e 74 20 69 6e 74 72 n excellent intr
0c70: 6f 64 75 63 74 6f 72 79 20 62 6f 6f 6b 6c 65 74 oductory booklet
0c80: 20 74 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 to get you star
0c90: 74 65 64 20 77 69 74 68 20 70 72 6f 67 72 61 6d ted with program
0ca0: 69 6e 67 20 69 6e 20 67 65 6e 65 72 61 6c 20 74 ing in general t
0cb0: 68 72 6f 75 67 68 20 74 68 65 20 6d 65 64 69 75 hrough the mediu
0cc0: 6d 20 6f 66 20 44 45 43 20 46 4f 43 41 4c 2e 0d m of DEC FOCAL..
0cd0: 0a 0d 0a 2a 20 20 20 5b 46 4f 43 41 4c 2d 38 20 ...* [FOCAL-8
0ce0: 50 72 6f 67 72 61 6d 6d 69 6e 67 20 4d 61 6e 75 Programming Manu
0cf0: 61 6c 5d 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e al](https://www.
0d00: 70 64 70 38 2e 6e 65 74 2f 70 64 70 38 63 67 69 pdp8.net/pdp8cgi
0d10: 2f 71 75 65 72 79 5f 64 6f 63 73 2f 76 69 65 77 /query_docs/view
0d20: 2e 70 6c 3f 69 64 3d 31 34 34 29 20 28 50 44 46 .pl?id=144) (PDF
0d30: 2c 20 32 2e 36 20 4d 42 29 20 e2 80 94 20 44 65 , 2.6 MB) — De
0d40: 73 70 69 74 65 20 74 68 65 20 6e 61 6d 65 2c 20 spite the name,
0d50: 74 68 69 73 20 69 73 20 74 68 65 20 62 65 73 74 this is the best
0d60: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f documentation o
0d70: 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 n the version of
0d80: 20 46 4f 43 41 4c 20 77 65 20 73 68 69 70 20 77 FOCAL we ship w
0d90: 69 74 68 20 74 68 65 20 50 69 44 50 2d 38 2f 49 ith the PiDP-8/I
0da0: 20 70 72 6f 6a 65 63 74 2c 20 61 63 63 6f 72 64 project, accord
0db0: 69 6e 67 20 74 6f 20 43 68 61 72 6c 65 73 20 4c ing to Charles L
0dc0: 61 73 6e 65 72 2e 20 49 74 20 64 6f 65 73 6e 27 asner. It doesn'
0dd0: 74 20 63 6f 76 65 72 20 74 68 69 73 20 4f 53 2f t cover this OS/
0de0: 38 20 76 65 72 73 69 6f 6e 20 6f 66 20 46 4f 43 8 version of FOC
0df0: 41 4c 20 73 70 65 63 69 66 69 63 61 6c 6c 79 2c AL specifically,
0e00: 20 62 75 74 20 62 65 63 61 75 73 65 20 69 74 20 but because it
0e10: 69 73 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 is derived from
0e20: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 34 6b 20 the original 4k
0e30: 70 61 70 65 72 20 74 61 70 65 20 76 65 72 73 69 paper tape versi
0e40: 6f 6e 20 61 6e 64 20 74 68 65 20 44 69 73 6b 20 on and the Disk
0e50: 4d 6f 6e 69 74 6f 72 20 53 79 73 74 65 6d 20 76 Monitor System v
0e60: 65 72 73 69 6f 6e 73 20 6f 66 20 46 4f 43 41 4c ersions of FOCAL
0e70: 20 69 74 20 64 6f 65 73 20 66 6f 63 75 73 20 6f it does focus o
0e80: 6e 2c 20 69 74 27 73 20 61 20 67 6f 6f 64 20 67 n, it's a good g
0e90: 75 69 64 65 20 74 6f 20 74 68 65 20 6c 61 6e 67 uide to the lang
0ea0: 75 61 67 65 20 70 72 6f 70 65 72 2e 0d 0a 0d 0a uage proper.....
0eb0: 2a 20 20 20 5b 50 72 6f 67 72 61 6d 6d 69 6e 67 * [Programming
0ec0: 20 4c 61 6e 67 75 61 67 65 73 3a 20 50 44 50 2d Languages: PDP-
0ed0: 38 20 46 61 6d 69 6c 79 20 43 6f 6d 70 75 74 65 8 Family Compute
0ee0: 72 73 5d 28 68 74 74 70 3a 2f 2f 62 69 74 73 61 rs](http://bitsa
0ef0: 76 65 72 73 2e 6f 72 67 2f 70 64 66 2f 64 65 63 vers.org/pdf/dec
0f00: 2f 70 64 70 38 2f 68 61 6e 64 62 6f 6f 6b 73 2f /pdp8/handbooks/
0f10: 70 72 6f 67 72 61 6d 6d 69 6e 67 4c 61 6e 67 75 programmingLangu
0f20: 61 67 65 73 5f 4d 61 79 37 30 2e 70 64 66 29 20 ages_May70.pdf)
0f30: 28 50 44 46 2c 20 31 39 2e 32 20 4d 42 29 20 e2 (PDF, 19.2 MB) â
0f40: 80 94 20 54 68 69 73 20 62 6f 6f 6b 20 63 6f 76 €” This book cov
0f50: 65 72 73 20 73 65 76 65 72 61 6c 20 64 69 66 66 ers several diff
0f60: 65 72 65 6e 74 20 50 44 50 2d 38 20 70 72 6f 67 erent PDP-8 prog
0f70: 72 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61 67 65 ramming language
0f80: 20 73 79 73 74 65 6d 73 2c 20 77 69 74 68 20 74 systems, with t
0f90: 68 65 20 46 4f 43 41 4c 20 6d 61 74 65 72 69 61 he FOCAL materia
0fa0: 6c 20 62 65 69 6e 67 20 69 6e 20 43 68 61 70 74 l being in Chapt
0fb0: 65 72 20 31 31 2e 20 49 74 20 64 6f 65 73 6e 27 er 11. It doesn'
0fc0: 74 20 74 61 6c 6b 20 61 62 6f 75 74 20 4f 53 2f t talk about OS/
0fd0: 38 20 46 4f 43 41 4c 2c 31 39 36 39 20 73 70 65 8 FOCAL,1969 spe
0fe0: 63 69 66 69 63 61 6c 6c 79 2c 20 62 75 74 20 72 cifically, but r
0ff0: 61 74 68 65 72 20 69 6e 20 61 20 67 65 6e 65 72 ather in a gener
1000: 69 63 20 66 61 73 68 69 6f 6e 20 61 62 6f 75 74 ic fashion about
1010: 20 61 6c 6c 20 44 45 43 20 46 4f 43 41 4c 20 76 all DEC FOCAL v
1020: 61 72 69 61 6e 74 73 2e 0d 0a 0d 0a 20 20 20 20 ariants.....
1030: 54 68 69 73 20 69 73 20 74 68 65 20 73 65 63 6f This is the seco
1040: 6e 64 20 62 6f 6f 6b 20 6f 66 20 61 20 32 2d 76 nd book of a 2-v
1050: 6f 6c 75 6d 65 20 73 65 74 2c 20 77 69 74 68 20 olume set, with
1060: 22 5b 49 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74 "[Introduction t
1070: 6f 20 50 72 6f 67 72 61 6d 6d 69 6e 67 5d 28 28 o Programming]((
1080: 68 74 74 70 73 3a 2f 2f 77 77 77 2e 70 64 70 38 https://www.pdp8
1090: 2e 6e 65 74 2f 70 64 70 38 63 67 69 2f 71 75 65 .net/pdp8cgi/que
10a0: 72 79 5f 64 6f 63 73 2f 76 69 65 77 2e 70 6c 3f ry_docs/view.pl?
10b0: 69 64 3d 35 33 37 29 22 20 62 65 69 6e 67 20 74 id=537)" being t
10c0: 68 65 20 66 69 72 73 74 2e 20 54 68 65 20 6c 69 he first. The li
10d0: 6e 6b 65 64 2d 74 6f 20 4a 61 6e 75 61 72 79 20 nked-to January
10e0: 31 39 36 39 20 65 64 69 74 69 6f 6e 20 6f 66 20 1969 edition of
10f0: 74 68 61 74 20 62 6f 6f 6b 20 64 69 64 20 63 6f that book did co
1100: 76 65 72 20 46 4f 43 41 4c 20 28 43 68 61 70 74 ver FOCAL (Chapt
1110: 65 72 20 39 29 2c 20 62 75 74 20 74 68 61 74 20 er 9), but that
1120: 6d 61 74 65 72 69 61 6c 20 77 61 73 20 6c 61 74 material was lat
1130: 65 72 20 6d 6f 76 65 64 20 74 6f 20 74 68 69 73 er moved to this
1140: 20 73 65 63 6f 6e 64 20 76 6f 6c 75 6d 65 20 28 second volume (
1150: 70 75 62 6c 69 73 68 65 64 20 4d 61 79 20 31 39 published May 19
1160: 37 30 29 20 61 6e 64 20 69 6d 70 72 6f 76 65 64 70) and improved
1170: 20 63 6f 6e 73 69 64 65 72 61 62 6c 79 2c 20 73 considerably, s
1180: 6f 20 77 65 20 63 61 6e 6e 6f 74 20 72 65 63 6f o we cannot reco
1190: 6d 6d 65 6e 64 20 6c 65 61 72 6e 69 6e 67 20 46 mmend learning F
11a0: 4f 43 41 4c 20 76 69 61 20 22 49 6e 74 72 6f 64 OCAL via "Introd
11b0: 75 63 74 69 6f 6e 20 74 6f 20 50 72 6f 67 72 61 uction to Progra
11c0: 6d 6d 69 6e 67 2e 22 20 54 68 65 20 66 69 72 73 mming." The firs
11d0: 74 20 76 6f 6c 75 6d 65 20 77 61 73 20 5b 6c 61 t volume was [la
11e0: 74 65 72 20 72 65 2d 70 75 62 6c 69 73 68 65 64 ter re-published
11f0: 5d 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 77 6f ](https://www.wo
1200: 72 6c 64 63 61 74 2e 6f 72 67 2f 74 69 74 6c 65 rldcat.org/title
1210: 2f 69 6e 74 72 6f 64 75 63 74 69 6f 6e 2d 74 6f /introduction-to
1220: 2d 70 72 6f 67 72 61 6d 6d 69 6e 67 2d 70 64 70 -programming-pdp
1230: 2d 38 2d 66 61 6d 69 6c 79 2d 6f 66 2d 63 6f 6d -8-family-of-com
1240: 70 75 74 65 72 73 2f 6f 63 6c 63 2f 32 37 37 32 puters/oclc/2772
1250: 32 38 37 29 20 77 69 74 68 6f 75 74 20 64 65 74 287) without det
1260: 61 69 6c 65 64 20 63 6f 76 65 72 61 67 65 20 6f ailed coverage o
1270: 66 20 74 68 65 20 76 61 72 69 6f 75 73 20 70 72 f the various pr
1280: 6f 67 72 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61 ogramming langua
1290: 67 65 73 2c 20 66 6f 63 75 73 69 6e 67 20 6f 6e ges, focusing on
12a0: 20 66 6f 75 6e 64 61 74 69 6f 6e 61 6c 20 6d 61 foundational ma
12b0: 74 74 65 72 73 2e 20 49 20 64 6f 6e 27 74 20 6b tters. I don't k
12c0: 6e 6f 77 20 6f 66 20 61 6e 20 6f 6e 6c 69 6e 65 now of an online
12d0: 20 73 6f 75 72 63 65 20 6f 66 20 74 68 69 73 20 source of this
12e0: 73 65 63 6f 6e 64 20 65 64 69 74 69 6f 6e 20 6f second edition o
12f0: 66 20 22 49 6e 74 72 6f 64 75 63 74 69 6f 6e 20 f "Introduction
1300: 74 6f 20 50 72 6f 67 72 61 6d 6d 69 6e 67 2e 22 to Programming."
1310: 0d 0a 0d 0a 0d 0a 23 20 4f 6e 20 4e 61 6d 69 6e ......# On Namin
1320: 67 0d 0a 0d 0a 59 6f 75 20 6d 69 67 68 74 20 62 g....You might b
1330: 65 20 77 6f 6e 64 65 72 69 6e 67 20 61 62 6f 75 e wondering abou
1340: 74 20 6f 75 72 20 75 73 65 20 6f 66 20 74 68 65 t our use of the
1350: 20 6e 61 6d 65 20 22 46 4f 43 41 4c 2c 31 39 36 name "FOCAL,196
1360: 39 22 2e 20 54 68 61 74 27 73 20 62 65 63 61 75 9". That's becau
1370: 73 65 20 74 68 61 74 27 73 20 68 6f 77 20 74 68 se that's how th
1380: 65 20 73 6f 66 74 77 61 72 65 20 69 64 65 6e 74 e software ident
1390: 69 66 69 65 73 20 69 74 73 65 6c 66 20 6f 6e 20 ifies itself on
13a0: 73 74 61 72 74 69 6e 67 20 75 70 3a 0d 0a 0d 0a starting up:....
13b0: 20 20 20 20 2e 45 58 45 20 46 4f 43 41 4c 0d 0a .EXE FOCAL..
13c0: 20 20 20 20 2a 57 0d 0a 20 20 20 20 43 2d 46 4f *W.. C-FO
13d0: 43 41 4c 2c 31 39 36 39 0d 0a 0d 0a 43 61 6c 6c CAL,1969....Call
13e0: 69 6e 67 20 69 74 20 62 79 20 74 68 61 74 20 6e ing it by that n
13f0: 61 6d 65 20 72 65 66 65 72 73 20 74 6f 20 61 20 ame refers to a
1400: 66 61 69 72 6c 79 20 73 70 65 63 69 66 69 63 20 fairly specific
1410: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 73 version of the s
1420: 6f 66 74 77 61 72 65 2c 20 77 68 69 63 68 20 6d oftware, which m
1430: 61 74 63 68 65 73 20 77 68 61 74 20 77 65 20 64 atches what we d
1440: 69 73 74 72 69 62 75 74 65 2e 20 49 74 20 69 73 istribute. It is
1450: 20 73 6f 6d 65 74 69 6d 65 73 20 61 6c 73 6f 20 sometimes also
1460: 63 61 6c 6c 65 64 20 22 46 4f 43 41 4c 20 36 39 called "FOCAL 69
1470: 22 2c 20 74 68 6f 75 67 68 20 74 68 61 74 20 74 ", though that t
1480: 65 72 6d 20 77 61 73 20 6e 6f 74 20 66 61 76 6f erm was not favo
1490: 72 65 64 20 62 79 20 44 45 43 2e 0d 0a 0d 0a 41 red by DEC.....A
14a0: 6e 6f 74 68 65 72 20 6e 61 6d 65 20 74 68 61 74 nother name that
14b0: 20 2a 77 61 73 2a 20 66 61 76 6f 72 65 64 20 62 *was* favored b
14c0: 79 20 44 45 43 27 73 20 6d 61 72 6b 65 74 69 6e y DEC's marketin
14d0: 67 20 64 65 70 61 72 74 6d 65 6e 74 20 69 73 20 g department is
14e0: 22 46 4f 43 41 4c 2d 38 2e 22 20 54 68 69 73 20 "FOCAL-8." This
14f0: 69 73 20 61 20 67 65 6e 65 72 69 63 20 6e 61 6d is a generic nam
1500: 65 20 6e 6f 74 20 72 65 66 65 72 72 69 6e 67 20 e not referring
1510: 74 6f 20 61 6e 79 20 73 70 65 63 69 66 69 63 20 to any specific
1520: 76 65 72 73 69 6f 6e 20 6f 66 20 46 4f 43 41 4c version of FOCAL
1530: 2e 20 59 6f 75 20 63 61 6e 20 72 65 61 64 20 69 . You can read i
1540: 74 20 61 73 20 22 44 45 43 20 46 4f 43 41 4c 20 t as "DEC FOCAL
1550: 6f 6e 20 74 68 65 20 50 44 50 2d 38 2e 22 0d 0a on the PDP-8."..
1560: 0d 0a 54 68 65 72 65 20 77 65 72 65 20 6d 61 6e ..There were man
1570: 79 20 76 61 72 69 61 6e 74 73 20 6f 66 20 46 4f y variants of FO
1580: 43 41 4c 20 62 61 63 6b 20 69 6e 20 74 68 65 20 CAL back in the
1590: 64 61 79 2c 20 73 6f 6d 65 20 66 72 6f 6d 20 44 day, some from D
15a0: 45 43 20 61 6e 64 20 73 6f 6d 65 20 66 72 6f 6d EC and some from
15b0: 20 6f 75 74 73 69 64 65 72 73 2e 20 42 65 63 61 outsiders. Beca
15c0: 75 73 65 20 74 68 65 20 6c 61 6e 67 75 61 67 65 use the language
15d0: 20 77 61 73 20 6e 65 76 65 72 20 66 6f 72 6d 61 was never forma
15e0: 6c 6c 79 20 73 74 61 6e 64 61 72 64 69 7a 65 64 lly standardized
15f0: 2c 20 61 6e 64 20 74 68 65 72 65 20 6e 65 76 65 , and there neve
1600: 72 20 77 61 73 20 6f 6e 65 20 64 6f 6d 69 6e 61 r was one domina
1610: 6e 74 20 76 65 72 73 69 6f 6e 2c 20 69 74 20 63 nt version, it c
1620: 61 6e 20 62 65 20 75 73 65 66 75 6c 20 74 6f 20 an be useful to
1630: 62 65 20 73 70 65 63 69 66 69 63 20 61 62 6f 75 be specific abou
1640: 74 20 77 68 69 63 68 20 76 61 72 69 61 6e 74 20 t which variant
1650: 79 6f 75 27 72 65 20 74 61 6c 6b 69 6e 67 20 61 you're talking a
1660: 62 6f 75 74 2e 20 47 65 6e 65 72 69 63 20 74 65 bout. Generic te
1670: 72 6d 73 20 6c 69 6b 65 20 22 46 4f 43 41 4c 22 rms like "FOCAL"
1680: 2c 20 22 46 4f 43 41 4c 20 36 39 22 2c 20 6f 72 , "FOCAL 69", or
1690: 20 22 46 4f 43 41 4c 2d 38 22 20 73 68 6f 75 6c "FOCAL-8" shoul
16a0: 64 20 62 65 20 75 73 65 64 20 6f 6e 6c 79 20 77 d be used only w
16b0: 68 65 6e 20 79 6f 75 27 72 65 20 6e 6f 74 20 74 hen you're not t
16c0: 72 79 69 6e 67 20 74 6f 20 72 65 66 65 72 20 74 rying to refer t
16d0: 6f 20 61 20 73 70 65 63 69 66 69 63 20 76 65 72 o a specific ver
16e0: 73 69 6f 6e 2e 0d 0a 0d 0a 0d 0a 0d 0a 23 20 4c sion.........# L
16f0: 69 63 65 6e 73 65 0d 0a 0d 0a 54 68 69 73 20 61 icense....This a
1700: 72 74 69 63 6c 65 20 69 73 20 c2 a9 20 32 30 31 rticle is © 201
1710: 39 20 62 79 20 57 61 72 72 65 6e 20 59 6f 75 6e 9 by Warren Youn
1720: 67 20 61 6e 64 20 69 73 20 6c 69 63 65 6e 73 65 g and is license
1730: 64 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d d under the term
1740: 73 20 6f 66 20 5b 74 68 65 20 53 49 4d 48 20 6c s of [the SIMH l
1750: 69 63 65 6e 73 65 5d 5b 73 6c 5d 2e 0d 0a 0d 0a icense][sl].....
1760: 5b 68 62 5d 3a 20 20 68 74 74 70 73 3a 2f 2f 61 [hb]: https://a
1770: 72 63 68 69 76 65 2e 6f 72 67 2f 64 65 74 61 69 rchive.org/detai
1780: 6c 73 2f 62 69 74 73 61 76 65 72 73 5f 64 65 63 ls/bitsavers_dec
1790: 70 64 70 38 6f 73 38 5f 33 39 34 31 34 37 39 32 pdp8os8_39414792
17a0: 0d 0a 5b 6f 70 74 5d 3a 20 68 74 74 70 73 3a 2f ..[opt]: https:/
17b0: 2f 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d /tangentsoft.com
17c0: 2f 70 69 64 70 38 69 2f 64 6f 63 2f 74 72 75 6e /pidp8i/doc/trun
17d0: 6b 2f 52 45 41 44 4d 45 2e 6d 64 23 6f 70 74 69 k/README.md#opti
17e0: 6f 6e 73 0d 0a 5b 73 62 69 5d 3a 20 68 74 74 70 ons..[sbi]: http
17f0: 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 s://en.wikipedia
1800: 2e 6f 72 67 2f 77 69 6b 69 2f 53 68 65 6c 6c 5f .org/wiki/Shell_
1810: 62 75 69 6c 74 69 6e 0d 0a 5b 73 6c 5d 3a 20 20 builtin..[sl]:
1820: 20 68 74 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 https://tangent
1830: 73 6f 66 74 2e 63 6f 6d 2f 70 69 64 70 38 69 2f soft.com/pidp8i/
1840: 64 6f 63 2f 74 72 75 6e 6b 2f 53 49 4d 48 2d 4c doc/trunk/SIMH-L
1850: 49 43 45 4e 53 45 2e 6d 64 0d 0a 5b 75 77 66 5d ICENSE.md..[uwf]
1860: 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 : /doc/trunk/doc
1870: 2f 75 77 66 6f 63 61 6c 2d 6d 61 6e 75 61 6c 2e /uwfocal-manual.
1880: 6d 64 0a 5a 20 64 62 31 66 31 61 62 61 32 34 63 md.Z db1f1aba24c
1890: 32 31 30 63 63 66 31 64 62 34 61 37 61 31 62 33 210ccf1db4a7a1b3
18a0: 61 33 66 63 64 0a a3fcd.