View source for FOCAL (programming language)

{{Short description|Programming language used on DEC PDP-series machines}}
{{For|the unrelated set of programming-related features on HP41 calculators|FOCAL (Hewlett-Packard)}}
{{Infobox programming language
| name = FOCAL
| paradigm = [[Imperative programming|imperative]]
| family = [[JOSS]]
| designer = Richard Merrill
| developer = [[Digital Equipment Corporation|DEC]]
| released = {{Start date and age|1968}}
| discontinued = Yes
| influenced by = [[JOSS]]
| influenced = [[BASIC-PLUS]]
| website = 
}}
'''FOCAL''' (acronym for '''Formulating On-line Calculations in Algebraic Language''',{{sfn|Manual|1968|p=1.1}} or '''FOrmula CALculator'''<ref>{{cite book |url=http://bitsavers.org/pdf/dec/_Books/DEC_1957_To_The_Present_1978.pdf |title=DEC, 1957 to the Present |publisher=DEC |date=1978 |page=38}}</ref>) is an interactive [[Interpreter (computing)|interpreted]] [[programming language]] based on [[JOSS]] and mostly used on [[Digital Equipment Corporation]] (DEC) [[Programmed Data Processor|PDP]] series machines.

JOSS was designed to be a simple language to allow programs to be easily written by non-programmers. FOCAL is very similar to JOSS in the commands it supports and the general [[Syntax (programming languages)|syntax]] of the language. It differs in that many of JOSS' advanced features like [[Range (computer programming)|ranges]] and [[user-defined function]]s were removed to simplify the [[parser]] and allow the system to run in less memory. Some of the [[reserved word]]s (keywords) were renamed so that they all start with a unique first letter. This allows users to type in programs using one-character statements, further reducing memory needs. This was an important consideration on the [[PDP-8]], which was often limited to a few [[kilobyte]]s (KB).

Like JOSS, and later [[BASIC]]s, FOCAL on the PDP-8 was a complete environment that included a [[line editor]], an [[Interpreter (computing)|interpreter]], and [[input/output]] routines. The package as a whole was named ''FOCAL-8'', which also ran on the [[PDP-5]] and [[PDP-12]]. When ported to the [[PDP-11]], the resulting ''FOCAL-11'' relied on the underlying [[operating system]], [[RT-11]], to provide file support and editing. The language definition was updated twice, to ''FOCAL-69'' and a very slightly modified ''FOCAL-71''. A port to the [[Intel 8080]] was also available.

FOCAL is notable as the language in which the original versions of the early [[video game]]s [[Hamurabi (video game)|''Hamurabi'']] and [[Lunar Lander (video game genre)|''Lunar Lander'']] were written. Both were later ported to BASIC, where they became much better known.<ref name="TIME">{{cite magazine |url=https://time.com/69316/basic/ |title=Fifty Years of BASIC, the Programming Language That Made Computers Personal |magazine=[[Time (magazine)|Time]] |last=McCracken |first=Harry |date=2014-04-29 |access-date=2016-02-12 |archive-url=https://web.archive.org/web/20160205214236/http://time.com/69316/basic/ |archive-date=2016-02-05 |url-status=live}}</ref> FOCAL was not popular outside the PDP platform and largely disappeared during the move to the [[VAX-11]]. It had a strong revival in the [[Soviet Union]] where PDP-11 clones were used as educational and [[home computer]]s ([[Electronika BK|BK series]]).

==History==
=== JOSS ===
{{main|JOSS}}
[[JOSS]] was released in May 1963 on the one-off [[JOHNNIAC]] computer at [[RAND Corporation]]. In RAND, use grew rapidly, and the machine, originally built in 1953, quickly ran out of capability. JOHNNIAC was decommissioned in 1966 and JOSS was reimplemented on a newly purchased [[PDP-6]], [[Digital Equipment Corporation]]'s (DEC) first "big" machine. Use continued to grow and by 1970, the system was being used by 500 to 600 users across the country and had spawned several innovations such as mobile [[computer terminal]]s that could be wheeled from room to room and plugged in for quick access.<ref name=rand>{{cite tech report |last=Marks |first=Shirley |date=December 1971 |url=https://www.rand.org/content/dam/rand/pubs/reports/2008/R918.pdf |title=The JOSS Years: Reflections on an experiment |publisher=Rand}}</ref>

JOSS was highly influential. It emerged just as [[time-sharing]] was being introduced. There was significant interest in man-machine interaction and computers were seeing wider use. Whereas most [[time-sharing]] [[operating system]]s of the era concentrated on user account and file management, leaving the users to do their own programming, JOSS provided file editing and a programming language in one package. RAND showed the system to a parade of people in the industry.<ref name=rand/>

===FOCAL===
The PDP-6 was DEC's first [[mainframe]], and JOSS took full advantage of its power and memory capacity. The DEC programmers were familiar with the system and interested in JOSS, but most of the computers DEC sold had nowhere near the power needed to run it. Written by [[Richard Merrill (computer scientist)|Richard Merrill]], FOCAL removed features from JOSS as required in order to be able to run in the much more limited memory space of the [[PDP-8]] and other [[12-bit computing|12-bit]] machines in the DEC lineup. To achieve this, a major change was made to reduce the amount of temporary data, or ''[[State (computer science)|state]]'', needed to parse the statements. One noticeable effect of this decision was that [[Conditional (computer programming)|conditionals]] could only be used for [[Branch (computer science)|branches]], in contrast to JOSS, where conditionals can be applied to any statement.

The other noticeable change was to rearrange the keywords so each started with a unique letter. This simplified the [[Parsing|parser]], which needed to read only the first letter of the command on a line of code, and could then skip forward to the next [[whitespace character]]. It would then compare that against an internal list of possible keywords, which was one character per entry. In contrast, JOSS had to continue reading until it had read the entire command word and then compared that against a list containing complete words. Not only did this change save memory in the parser, users could also save memory by typing in only that letter, reducing the size of the [[source code]].
[[File:DEC Programme auf Lochstreifen.jpg|thumb|PDP-8 [[punched tape]]s, including a FOCAL-69 tape dated 7/9/69]]
The first version of FOCAL was released in 1968 for the [[PDP-8]]. An updated version followed the next year, which was later known as FOCAL-69. The system as a whole, regardless of version, was known as FOCAL-8 when it was ported to other machines in the 12-bit series, including the [[PDP-5]] and [[PDP-12]]. It was popular as it was highly efficient in memory use, which was often severely limited on these machines to a few [[kilobyte]]s (KB). The similar FOCAL-11 ran on the [[PDP-11]] under [[RT-11]].

[[Processor Technology]] also offered a version of 8k FOCAL, complete with Lunar Lander, for the [[Intel 8080]]-based [[Altair 8800]] system. This was provided for the copying charge of the tape, while the [[source code]] was provided for free with other purchases.<ref>{{cite magazine |url=https://archive.org/details/byte-magazine-1976-04 |title=Watch Your Altair Grow! |magazine=Byte |date=April 1976 |page=[https://archive.org/details/byte-magazine-1976-04/page/n49 48]}}</ref>

===BASIC===
While FOCAL was becoming popular on DEC machines, BASIC was becoming a more popular alternative on other platforms. By the late 1960s, several companies were making inroads in DEC's [[minicomputer]] stronghold, selling similar machines running time-sharing versions of BASIC. Notable among these was the [[HP 2100]] series, running [[HP Time-Shared BASIC]].{{sfn|Szczepaniak|2014}}

[[David H. Ahl]] had recently joined DEC's PDP-8 Group, just as the company became interested in selling the machine into educational settings. Due to the popularity of BASIC in the education market, especially with the growing library of BASIC programs from the [[Minnesota Educational Computing Consortium]], Ahl found selling the machine with FOCAL was difficult despite its advantages.{{sfn|Szczepaniak|2014}} As he later noted:

{{Blockquote|text=DEC's FOCAL language was equal to BASIC in most aspects and even better in some, but it had one huge drawback: DEC was unwilling to license it to other computer manufacturers. FOCAL was fighting an uphill battle against BASIC, which was available on GE, Honeywell, HP, and other computers.<br />I think it wound up with a situation like Sony and Betamax. Sony saying, "Betamax is ours and it is a better format than VHS," which it was. But then, JVC saying, "We have VHS and Toshiba. Hey, do you want to use it? Fine, we'll license it to you for next to nothing."{{sfn|Szczepaniak|2014}}}}

Ahl took it upon himself to produce a BASIC system for the platform, hiring a company he later learned was a single programmer in Brooklyn to produce a version for the 4&nbsp;kWord PDP-8. DEC began selling packaged versions of the PDP-8 with terminals and the BASIC as the "EduSystem" lineup, with larger systems in the series having expanded versions of BASIC, and in some cases, also FOCAL and [[FORTRAN]]. Some PDP-11 based EduSystems were also created.<ref name=edu>{{cite book |url=http://bitsavers.trailing-edge.com/pdf/dec/pdp8/tss8/EduSystemHandbookJan73.pdf |title=EduSystem Handbook |page=V |publisher=Digital |date=1973}}</ref>

Ahl then began porting programs from FOCAL to BASIC, notably [[Hamurabi (video game)|''The Sumer Game'']] (which he renamed ''Hamurabi''), a version of [[Lunar Lander (video game genre)|''Lunar Lander'']], and many smaller FOCAL demos. Combining his ports with submissions from outside programmers, he managed to collect enough material to have DEC publish ''101 BASIC Computer Games'' in 1973. The book was an immediate success and ultimately ran through three printings to 1975.{{sfn|Savetz|2013}}{{sfn|Szczepaniak|2014}}

By the mid-1970s BASIC was a standard feature of all DEC machines and FOCAL use evaporated.{{sfn|Savetz|2013}}

===Rebirth in the Soviet Union===
The PDP-11 had been cloned in the [[Soviet Union]] in the 1970s for military purposes. In the 1980s, single-chip variations similar to the [[LSI-11]] were produced that gave rise to a series of PDP-11 compatible [[home computer]]s. Most notable among several models were the [[Electronika BK]] series, released in 1985. These were initially supplied with FOCAL on a [[ROM cartridge]],<ref>{{cite tech report|url=https://www.ucis.pitt.edu/nceeer/1988-802-8-Stapleton.pdf |title=The Soviet Union and the Personal Computer "Revolution" |page=8 |first1=R.A. |last1=Stapleton |first2=S.E. |last2=Goodman |date=June 1988 |publisher=University of Arizona}}</ref> while a BASIC cartridge was an optional add-on. Later models supplied BASIC by default.<ref>{{cite web |url=https://oldcomputermuseum.com/elektronika_bk0010.html |title=Elektronika BK-0010 |website=Old Computer Museum}}</ref>

==Language==
The following description is based on FOCAL-69 as seen in the FOCAL-8 language reference manual.{{sfn|Manual|1968}}

===Direct and indirect modes===
FOCAL followed the JOSS model for interaction via a [[command line interface]]. This allowed users to type in commands in "direct mode", which were performed immediately, or to prefix them with a line number, in which case they were added to the program if they were unique, or overrode existing code if the same number had previously been used.{{sfn|Manual|1968|p=2.1}}

The method of operation is similar to BASIC's "[[Direct mode|immediate mode]]" vs. "program mode". It contrasts with JOSS, in which all commands, both program and direct, were saved and loaded as part of the user's workspace. This allowed JOSS to have commands without line numbers, which they used for {{code|Form}} definitions and other tasks. FOCAL lacked this capability, so those instructions that needed to be loaded and saved became options on other program-mode commands like {{code|Type}}.{{sfn|Manual|1968|p=2.1}}

===Program statements===
Every line in a FOCAL program must start with a line number. As with JOSS, line numbers are fixed-point numbers consisting of two two-digit integers separated by a period. In FOCAL-8, valid line numbers range from 1.01 through 31.99. When printed out, using {{code|WRITE}}, the FOCAL equivalent to BASIC's {{code|LIST}}, leading zeros will be added; 1.10 will be printed as {{code|01.10}}. This makes all lines numbers five characters long when output so that all line numbers align. Statements referring to those lines do not need the leading zeros, for example, {{code|GOTO 1.10}}.{{sfn|Manual|1968|p=2.7}}

The number on the left of the period is known as the "group number". Groups provide some level of code organization that is lacking in languages like Fortran or BASIC. The primary use of these was to use a group as a [[subroutine]] which can be called with {{code|DO}}, for example, {{code|DO 5}} will jump to the subroutine written in group 5. The editor also used these during edit-time, for example, one could {{code|WRITE 2}} to produce a listing of the code in group 2, or {{code|ERASE 4}} to delete all of the lines in group 4.{{sfn|Manual|1968|p=2.7}}

Every line must start with a command keyword following the line number.{{sfn|Manual|1968|p=2.7}} There is no concept of a "default command" as is the case in BASIC with its optional {{code|LET}} statement. Multiple statements can be placed on a single line, separated by semicolons. Usually, the behavior is no different than if the statements had been on separate lines, except in the case of FOR loops.{{sfn|Manual|1968|p=3.7}}

=== Commands ===
====ASK====
The {{code|ASK}} command (abbreviation A) will take a list of strings and variables, echo the strings and store the user input in variables.{{sfn|Manual|1968|p=3.2}} Equivalent to BASIC's {{code|INPUT}}.

 01.01 ASK "NAME", NAME
 01.02 ASK "COORDINATES", X, Y
 01.03 ASK "A1",A1,"OMEGA",W,"T0",T0,"DAMPING FACTOR",DAMPINGFACTOR

If the user doesn't enter a number but enters text, the system will convert the initial character to a number with "A"=1, "B"=2, etc.

====COMMENT====
The {{code|COMMENT}} command (abbreviation C) creates a remark.{{sfn|Manual|1968|p=3.6}} Equivalent to BASIC's {{code|REM}}. The original manual lists {{code|CONTINUE}} as a synonym of COMMENT, used to mark empty lines, but this has no internal difference.{{sfn|Manual|1968|p=A.1}}
 01.01 COMMENT: THE SUMER GAME, BY RICHARD MERRILL

====DO====
The {{code|DO}} command (abbreviation D) branches execution to a subroutine. It is the equivalent of BASIC's {{code|GOSUB}}. The subroutine is referenced either by group number or line number. If a line number is provided, that single line is run and then automatically returns to continue execution at the statement after the {{code|DO}}. If no line number is provided, execution starts at the first line of the block and continues until the end of the block is reached. {{code|RETURN}} is supported, but is only required to return early from the group, it is not needed at the end of the group.{{sfn|Manual|1968|p=3.4}}
 01.15 DO 7.24
 01.16 DO 8

====FOR====
The {{code|FOR}} command (abbreviation F) implements a [[for loop]]. When three arguments are specified, the first is the initial value of the loop variable, the second is the increment, and the third value is the terminating value for the loop. If only two values are provided, the first is the initial value and the second is the terminating value, and the increment is set to 1. This is the pattern from [[FORTRAN]]'s {{code|DO}} loops, as opposed to BASIC's {{code|FOR}} where the increment is the last value, if present.

In contrast to other parts of the language where multiple statements on a line are independent, the {{code|FOR}} always runs the statements that follow it on the line before the termination has been met, and then continues to the next line. Thus, loops have to be on a single line, or alternatively, call a subroutine with {{code|DO}}. There is no equivalent of BASIC's {{code|NEXT}}.{{sfn|Manual|1968|p=3.7}}
 01.01 FOR X=1,10; TYPE X,!
 01.02 FOR X=0,10,100; DO 2

A sample FOR loop:
 01.10 ASK "HOW MUCH MONEY DO YOU WANT TO BORROW ?",PRINCIPAL
 01.20 ASK "FOR HOW MANY YEARS ?",TERM
 01.30 FOR RATE=4.0,.5,10;DO 2.0
 01.40 QUIT
 02.10 SET INTEREST=PRINCIPAL*(RATE/100)*TERM
 02.20 TYPE "RATE",RATE,"   ","INTEREST",INTEREST,!

====GOTO====
The {{code|GOTO}} command (abbreviation G) jumps program execution to the specified line number.{{sfn|Manual|1968|p=3.4}} It is identical to the same-named statement in BASIC. In FOCAL, {{code|GOTO}} is also used to begin execution, like BASIC's {{code|RUN}}, but in this use, the documentation refers to it as {{code|GO}} instead of {{code|GOTO}} in spite of the underlying command being the same.
 01.05 GOTO 1.01
 02.90 TYPE !!,"TRY AGAIN.",!!!!!;GOTO 1.1

====IF====
The {{code|IF}} command (abbreviation I) provides a conditional branch based on the sign of the expression. After the numeric expression, the IF command can take one to three line numbers. If the expression is less than zero, execution branches to the first line number;  if equal to zero, to the second line number;  if greater than zero, to the third line number. The language lacked relative operators such as greater than, equal or less than. To branch if X > 5, one must compare X - 5.{{sfn|Manual|1968|p=3.5}}
 02.20 IF (25-25) 2.4,2.3,2.4
 03.01 IF (X) 3.1,3.02,3.1

IF could be short-formed by placing a semicolon (or end of line) beyond the first line number. For example:

 02.20 IF (X)1.8; TYPE "Q"
 02.30 IF (X)1.8,2.50
 02.40 TYPE "P"

In this case the test at 2.20 will cause the program to jump to line 1.8 if the test is negative, otherwise it will continue and type "Q" to the console. Line 2.30 will jump to 1.8 or 2.5 if the value is negative or zero, and otherwise continue to type "P" to the console.{{sfn|Manual|1968|p=3.5}}

====QUIT====
The {{code|QUIT}} command (abbreviation Q) terminates execution of the program and returns control to the editing environment.{{sfn|Manual|1968|p=3.6}} Equivalent to BASIC's {{code|STOP}} or {{code|END}}.
 01.10 FOR X=-10,1,10;TYPE X
 01.20 QUIT

====RETURN====
The {{code|RETURN}} command (abbreviation R) branches execution from a subroutine back to the calling location.{{sfn|Manual|1968|p=3.6}} The use of {{code|RETURN}} is optional at the last line of a subroutine, a subroutine returns at the last line in the group anyway. The following is a sample subroutine for converting a yes/no prompt into a value.[http://www.pdp8.net/lang/focal/misc.shtml]
 22.78 COMMENT: 'YES OR NO' SUBROUTINE
 22.80 ASK "ANSWER YES OR NO ?  ",AN
 22.82 IF (AN-0YES)22.84,22.86
 22.84 IF (AN-0NO)22.8,22.88,22.8
 22.86 SET X=2;RETURN
 22.88 SET X=1;RETURN

====SET====
The {{code|SET}} command (abbreviation S) assigns the results of an expression to the specified variable.{{sfn|Manual|1968|p=3.3}} Equivalent to BASIC's {{code|LET}}.
 01.30 SET PI=3.14156
 01.60 SET INTEREST=PRINCIPAL*(RATE/100)*TERM

====TYPE ====
The {{code|TYPE}} command (abbreviation T) provides for output of one or more items separated by commas.{{sfn|Manual|1968|p=3.1}} Equivalent to BASIC's {{code|PRINT}}.

Items can be variables, literal strings surrounded by double-quotes, or a variety of control characters. The control characters include the {{code|!}} to output a carriage return and line feed, {{code|#}} for the carriage return alone, and {{code|:}} for a tab character. Control characters can be strung together, for example, {{code|!!!}} will output three CR/LFs without the need to separate them with commas.{{sfn|Manual|1968|p=3.2}}

 TYPE [NUMBERS, E1, "TEXT", !, #, :, $ OR %] ...OUTPUT
 01.10 TYPE "HI THERE, GOOD LOOKING.  HOW MUCH MONEY DO YOU WANT TO BORROW?",!
 01.50 TYPE "INTEREST",INTEREST,!
 01.80 TYPE "THE INTEREST FOR",TERM," YEARS",!,"IS",INTEREST, " DOLLARS.",!!
 01.90 TYPE "NEW YORK",!,"WASHINGTON",!,"ATLANTA",!,"DALLAS",!
 02.10 TYPE "X",X,"   ","X^2",X^2,"   ","SQRT",FSQT(X)
 03.20 TYPE ".",#
 02.20 TYPE !!!!!

{{code|TYPE}} also included an optional format specifier indicated using the format {{code|%x.yz}}, where x is the number of digits to the left of the decimal, and yz is the number of digits to the right of the period. The default format was {{code|%8.4}}, meaning a maximum of eight digits and four to the right of the period.{{sfn|Manual|1968|p=2.2}} So, for example:

 SET A=67823
 TYPE %6.01,A
 =  67823.0
 TYPE %5,A
 = 67823
 TYPE %8.03,A
 =   67823.000
 TYPE %,A
 = 6.7823E4

Note the extra leading spaces in some examples, padding out the full defined width. Using % alone caused the output to be printed in "floating point format" using the E.{{sfn|Manual|1968|p=2.3}}

A special control character was {{code|$}} which caused a table of all defined variables and their values to be printed. Only the first two letters of the name will be printed, padded with a zero if need be. Arrays elements are printed on separate lines and variables with only one element will be indexed (00). For example:{{sfn|Manual|1968|p=2.5}}

 TYPE $
 A0(00)=67823

=== Variables ===
Variable names may start with any letter except F (F is reserved for functions) and may contain any sequence of letters and numbers. However, only the first two characters are significant. For example, the following code sample from ''FOCAL: A New Conversational Language''<ref>{{cite book |title=FOCAL: A New Conversational Language |url=http://www.cs.uiowa.edu/~jones/pdp8/focal/focal69.html |publisher=Digital}}</ref> refers to the same variable as DESTINATION and then DES. Internally, both references refer to a variable designated DE:
 01.80 ASK DESTINATION
 02.30 IF (DES-14) 2.4,3.1,2.4

Any variable may be treated as an array, allowing subscripts from -2048 through 2047.[http://www.pdp8.net/lang/focal/misc.shtml]

=== Math ===
FOCAL contained five mathematical operators:{{sfn|Manual|1968|p=2.4}}
* {{code|^}} for exponents – the exponent is converted to a 12-bit integer
* {{code|*}} for multiplication
* {{code|/}} for division
* {{code|+}} for addition
* {{code|-}} for subtraction

One curiosity of the 1968 version of FOCAL was that the operators had independent precedence, as in the order above. Although this certainly applies to exponentiation, multiplication, and division, there is some ambiguity in the 1968 FOCAL manual with regards to addition and subtraction.  Specifically, examples that demonstrate operator precedence for multiplication and division are provided, but examples demonstrating operator precedence for addition and subtraction are lacking.  Nevertheless, the literal interpretation of the 1968 FOCAL manual suggests that the formula {{code|SET T{{=}}2-3+1}} would be evaluated in the order 2-(3+1) and thus produce -2. This was very different than most languages, where the + and - had equal precedence and would be evaluated (2-3)+1 to produce 0.{{sfn|Manual|1968|p=2.4}}  This can cause subtle errors when converting FOCAL source code to other systems.  

However, the + and - have the same precedence in FOCAL-69 and FOCAL-71, so {{code|SET T{{=}}2-3+1}} yields 0, as expected.

FOCAL was unusual in that mathematical expressions could use (), [], and <> interchangeably in matched pairs to establish precedence.{{sfn|Manual|1968|p=2.4}} For example, the following is a valid expression:

   01.30 SET A=<10*[5+1]*(1+5)>

All of these are the same level of precedence and read left-to-right when at the same level, so this statement will be evaluated [], then (), then <>, to produce 360.{{sfn|Manual|1968|p=2.4}}

The language contained the following built-in functions:{{sfn|Manual|1968|p=3.10}}
* {{code|FABS()}} – Absolute value
* {{code|FATN()}} – Arctangent
* {{code|FCOS()}} – Cosine of argument in radians
* {{code|FEXP()}} – Natural base to the power of the argument
* {{code|FITR()}} – Integer part of the argument
* {{code|FLOG()}} – [[Napierian_logarithm|Naperian log]]
* {{code|FRAN()}} – Random number
* {{code|FSGN()}} – Sign of the argument; FSGN(0)=1 in FOCAL-69, but FSGN(0)=0 in FOCAL-71 and later versions
* {{code|FSIN()}} – Sine of an angle given in radians
* {{code|FSQT()}} – Square root

===Character functions===
FOCAL-71 added two new functions for inputting single-character values, similar to ASK but returning ASCII values.

* {{code|FIN}} stops until the user types a character and then returns the ASCII code
* {{code|FOUT}} outputs the ASCII value as a character to the console or file

===Other functions===
FOCAL also included several special-purpose functions:{{sfn|Manual|1968|p=A.3}}

* {{code|FADC}} reads a value from the PDP-8's analog-to-digital converters, with the channel number as the parameter
* {{code|FDIS}} plots at a given Y location
* {{code|FDXS}} plots at a given X location

==Environment commands==
=== Running programs ===
FOCAL used {{code|GOTO}} in the editor to start a program. However, a rule-of-thumb was to shorten this to {{code|GO}}. This is the equivalent of {{code|RUN}} in BASIC. {{code|GOTO}} can also be used in the editor to start execution at a specified line.

=== Editing commands ===
New lines are entered into a program by simply starting the command with a line number. The editing commands were <code>ERASE</code> (abbreviation E),{{sfn|Manual|1968|p=2.4}} <code>MODIFY</code> (abbreviation M),{{sfn|Manual|1968|p=3.8}} and <code>WRITE</code> (abbreviation W):{{sfn|Manual|1968|p=3.2}}
* <code>ERASE</code> – zero out all variables; this is sometimes used in programs to reset them
* <code>ERASE ''line number''</code> – delete the statement at a specified line
* <code>ERASE ''group number''</code> – delete all statements in a specified group
* <code>ERASE ALL</code> – delete an entire program
* <code>MODIFY ''line number''</code> – allow editing a specified line
* <code>WRITE ''line number''</code> – display the statement at a specified line
* <code>WRITE ''group number''</code> – display all statements in a specified group
* <code>WRITE ALL</code> – display a specified program

=== File commands ===
The file command was OPEN (abbreviation O):
* {{code|OPEN INPUT [device:][file][,ECHO]}} – prepare to read from the start of a file
* {{code|OPEN OUTPUT [device:][file][,ECHO]}} – prepare to write from the start of a file
* {{code|OPEN RESTORE INPUT[,ECHO]}} – resume input
* {{code|OPEN RESTORE OUTPUT[,ECHO]}} – resume output
* {{code|OUTPUT CLOSE}} – output the buffer and close a file

=== Library commands ===
FOCAL included the ability to manage collections of FOCAL programs as a code library. Programs could call other programs in a chain fashion using <code>LIBRARY CALL</code>, or call a single subroutine in another program using <code>LIBRARY GOSUB</code>. Program names could be six characters long. The LIBRARY command (abbreviation L) had the following sub-commands:

* <code>LIBRARY DELETE [device:]''program name''</code> – delete a program
* <code>LIBRARY LIST [device:][file name]</code> – catalog
* <code>LIBRARY RUN [device:]''program name'' [line number]</code> – chain a program, optionally resuming at a specified line number
* <code>LIBRARY SAVE [device:]''program name''</code> – save a program
* <code>LIBRARY EXIT</code> – return to the PDP-8 monitor program
FOCAL-71 added:
* <code>LIBRARY CALL [device:]''program name''</code> – load a program
* <code>LIBRARY GOSUB [device:]''program name'' [group number]</code> – call a subroutine in an external program

==Error codes==
Since the interpreter lacked sufficient memory space to store error messages, or even a table of error numbers, FOCAL used a workaround by reporting the address of the error-detecting code as a fixed-point number. For example, the [[division by zero]] error was detected it would report {{code|?28.73 @ 01.10}}, where 28.73 represents the code checking for this error at memory page 28 plus an offset of 73 words, and 01.10 is the line number where the error occurred. Pages in the PDP-8 were 128 bytes long, so this address translates to location 3657.

==Changes between versions==
DEC released three versions of FOCAL for the PDP-8 series, the original, known simply as FOCAL, and two updated versions, 
FOCAL,1969 and FOCAL,1971. FOCAL,1969 was largely identical to the original, but FOCAL,1971 was major update that added file handling, new mathematics, and a variety of other changes. In contrast to the first two versions, which were stand-alone systems, FOCAL,1971 was based on the emerging [[OS/8]] (then still known as PS/8) and relied more heavily on that operating system for file handling and editing.

===FOCAL,1971===
One change in the new version was a 10-digit math package for added precision. The {{code|FSGN}} function now returned zero if the input expression evaluated to zero. Previously this would return one. The {{code|FRAN}} now used a better algorithm that produced more randomly distributed numbers. It also added the new {{code|FIN}} function that took a string and returned its [[ASCII]] value (akin to BASIC's {{code|ASC}}) and {{code|FOUT}} which took a number and returned a string with that ASCII character ({{code|CHR}}).

As all of these options used up limited memory, when started, FOCAL,1971 entered a dialog that asked the user what features they wanted to use.

==Comparison with JOSS==
FOCAL is, for all intents, a cleaned-up version of JOSS with changes to make the syntax terser and easier to parse. Almost all FOCAL commands have a one-to-one correspondence with JOSS and differ only in details. The most obvious change at first glance is that JOSS is case-insensitive and outputs keywords in mixed-case whereas FOCAL was upper-case only. Additionally, JOSS statements end with a period, making them look like written statements, whereas FOCAL has no required line-ending.

One major difference is that JOSS included a complete set of comparison operations and a [[boolean logic]] system that operated within {{code|if}} and {{code|for}} constructs. Furthermore, branches and loops could be applied to any statement, in contrast to FOCAL, where the only operation either could carry out was the equivalent to a goto. For example, in JOSS, one could:

  1.10 Type A if X>10.
  1.20 Type i for i=1(1)10.

The first line optionally prints A based on the value of X, and the second prints the numbers 1 to 10. In contrast, FOCAL lacked the ability to compare values, and loops were applied by skipping to the next line when they completed. The equivalent code in FOCAL would be:

 1.10 IF (X-10),,1.30
 1.20 TYPE A!
 1.30 FOR I=1,1,10;TYPE I,!

JOSS' implementation makes common constructs easier to build and more closely match a programmer's intentions, at the cost of making the runtime more complex. For example, JOSS allowed ranges in loops to be described in a flexible fashion like 1,2,3,10(5)50,75,78. This flexibility comes at a cost; in FOCAL the start, stop, and step can be written in a custom in-memory structure and easily updated as the loop is performed, whereas JOSS requires it to reevaluate an expression that may be, but often isn't, more complex.

In order to make the code terser in FOCAL, changes were relatively minor. For example, JOSS' {{code|Do part 20.}} becomes the slightly smaller FOCAL {{code|DO 20}}, while {{code|Do step 20.1}} becomes {{code|DO 20.1}}. Command keywords were also shortened where possible, so JOSS' {{code|Demand}} becomes FOCAL's {{code|ASK}}, both to make it shorter and to allow the letter D to be uniquely used for {{code|DO}}.

To simplify the parser, some JOSS constructs were removed. For example, JOSS could perform multiple assignments with {{code|Set S{{=}}P, P{{=}}Q, Q{{=}}S.}} while in FOCAL these had to be made individual statements, {{code|SET S{{=}}P; SET P{{=}}Q; SET Q{{=}}S}}. Likewise, JOSS' {{code|Form}}, used to format output, was combined into FOCAL's {{code|TYPE}} with the {{code|%}}.

==Comparison with BASIC==
Comparisons between FOCAL and BASIC were inevitable since both languages were common on [[minicomputer]]s of the same era, and the two languages have much in common in syntax and structure. In most cases, there is a direct conversion of FOCAL code to and from BASIC. For example, to ask a user to input a value, in FOCAL one would:

  ASK "What is your age?",AGE

while in BASIC the equivalent is:
{{sxhl|
 INPUT "What is your age?",AGE
|basic}}
With the exception of a few features that were missing from one or the other, and some relatively minor differences in syntax, the two languages are very similar.

One notable exception is the {{code|IF}} in BASIC, which allowed any statement to be placed after the {{code|THEN}}, making it more similar with JOSS' control structures. BASIC reversed the ordering of the code compared to JOSS, placing the conditional expression at the start of the line rather than the end; in BASIC one uses {{code|IF this THEN that}} whereas JOSS used {{code|that IF this}}. FOCAL's {{code|IF}} was more like BASIC's [[computed goto]], {{code|ON X GOTO 10,20,30|basic}}, but the {{code|ON...GOTO}} allowed any number of lines as targets, as opposed to only three for negative, zero and positive as in FOCAL.

Another major difference between the two is that FOCAL lacked inherent support for [[String (computer science)|strings]] as data elements that could be assigned to variables. As was the case in early BASICs or FORTRAN versions before the addition of strings (in F77), this limitation was generally avoided through the use of literal strings in input and output commands. It was only when manipulating individual strings, or characters in them, that this became a significant problem.

As string variables were not supported, inputting a string used a [[kludge]] that converted any characters typed in by a user to their numeric character value. For example, if one typed {{kbd|HELLO}} at an input statement, FOCAL would convert the H to "8", the numeric value of "H" in the PDP-8's [[six-bit character code]]s ("H" is the eighth letter). It would then interpret the "E" as starting an exponent, then it would try to compute "8" to the "LLO" power, which would take several seconds of CPU time and result in a value of 0.76593020E+103, not a helpful response. Nevertheless, by asking questions that would be responded to using single-letter responses, like "<samp>Do you need instructions, Y or N</samp>", programmers could test the result against known character values to produce what looked like character input.

Prepending a zero to a string would coerce it to numeric, so programs could test for specific multicharacter strings using IF statements such as {{code| I (A-0BROWN) 1.00,2.00,1.00}} which will branch to 2.00 if A = "BROWN" or 1.00 otherwise.  However the program would throw an overflow error if the user entered text with unfortunately-placed 'E' characters.  For instance, one could test for "BROWN" or "RED" but not "GREEN" or "YELLOW".

FOCAL's PDP-8 implementation used a [[Floating-point arithmetic|floating point]] representation that represented numbers as four 12-bit words, forty-eight bits in total, with thirty-six bits of mantissa and twelve bits of exponent. This allowed for both significantly higher precision and a significantly wider range of values than most contemporary interpreters, making FOCAL a reasonable choice for serious numerical work. This high precision, and good choices for default decimal output formatting, meant that difficulties with binary-to-decimal rounding were not evident to beginning users. For comparison, [[Microsoft BASIC]] initially used a [[Microsoft Binary Format|32-bit format]], while later versions expanded this to 40-bits. Most BASICs had problems with rounding that led to simple equations resulting in tiny non-zero remainders.

It is generally agreed that FOCAL was more efficient in its use of resources than comparable BASIC systems. On a typical machine of the day, often with 6 to 24 kilobytes of [[magnetic-core memory]], FOCAL could handle larger and more complex programming tasks than BASIC.

== Versions and spinoffs ==
The Coca-Cola Corporation used a customized version of FOCAL called COKE.{{Citation needed|date=October 2020}}

FOCAL was later implemented on the PDP-7, PDP-9, PDP-10, PDP-11, PDP-12, PDP-5 and LINC-8.

The FOCAL manual showed how to add commands to the FOCAL parser, so many sites added specialized commands for operating custom hardware.

The [[DECUS|Digital Equipment Computer Users' Society]] collected many patches and enhancements for FOCAL. There were even major enhanced offshoots of FOCAL, such as FOCAL-W, which added many features, including better mass storage file I/O and even virtual variable memory.

In the mid-1970s DELTA was a more sophisticated version of FOCAL. Program line numbers went from 00 to 99 "parts" and 000000 to 999999 "steps" executed in alphanumeric order. DELTA had some specialized commands for the Tektronix 4010/14 display scope.

In [[Russia]], it saw use as late as the early 1990s in mass-produced home computers of the [[Electronika BK]] series.

[[Microsoft]] sold a version of FOCAL supplied on paper-tape.<ref>{{Cite web |title=What happened to the Microsoft FOCAL interpreter? | website=[[YouTube]] |url=https://www.youtube.com/watch?v=2BV9kdfKeqo |access-date=2022-09-18}}</ref> According to Raymond Chen, the master tape is missing and FOCAL is no longer available.

==Example code==
The original Lunar Lander makes an excellent example for examining FOCAL code, as it uses most of the features of the language. This code is from the original, found on [https://www.cs.brandeis.edu/~storer/LunarLander/LunarLander.html Jim Storer's Lunar Lander page].<ref>{{cite web |title=Lunar Lander |url=https://www.cs.brandeis.edu/~storer/LunarLander/LunarLander/LunarLanderListing.jpg |website= Lunar Landing Game Related Documents}}</ref>
 
 {{vanchor|01.04}} T "CONTROL CALLING LUNAR MODULE. MANUAL CONTROL IS NECESSARY"!
 {{vanchor|01.06}} T "YOU MAY RESET FUEL RATE K EACH 10 SECS TO 0 OR ANY VALUE"!
 {{vanchor|01.08}} T "BETWEEN 8 & 200 LBS/SEC. YOU'VE 16000 LBS FUEL. ESTIMATED"!
 {{vanchor|01.11}} T "FREE FALL IMPACT TIME-120 SECS. CAPSULE WEIGHT-32500 LBS"!
 {{vanchor|01.20}} T "FIRST RADAR CHECK COMING UP"!!!;E
 {{vanchor|01.30}} T "COMMENCE LANDING PROCEDURE"!"TIME,SECS   ALTITUDE,"
 {{vanchor|01.40}} T "MILES+FEET   VELOCITY,MPH   FUEL,LBS   FUEL RATE"!
 {{vanchor|01.50}} S A=120;S V=1;S M=32500;S N=16500;S G=.001;S Z=1.8
 
 {{vanchor|02.10}} T "    ",%3,L,"       ",FITR(A),"  ",%4,5280*(A-FITR(A))
 {{vanchor|02.20}} T %6.02,"       ",3600*V,"    ",%6.01,M-N,"      K=";A K;S T=10
 {{vanchor|02.70}} T %7.02;I (200-K)2.72;I (8-K)3.1,3.1;I (K)2.72,3.1
 {{vanchor|02.72}} T "NOT POSSIBLE";F X=1,51;T "."
 {{vanchor|02.73}} T "K=";A K;G 2.7
 
 {{vanchor|03.10}} I (M-N-.001)4.1;I (T-.001)2.1;S S=T
 {{vanchor|03.40}} I ((N+S*K)-M)3.5,3.5;S S=(M-N)/K
 {{vanchor|03.50}} D 9;I (I)7.1,7.1;I (V)3.8,3.8;I (J)8.1
 {{vanchor|03.80}} D 6;G 3.1
 
 {{vanchor|04.10}} T "FUEL OUT AT",L," SECS"!
 {{vanchor|04.40}} S S=(FSQT(V*V+2*A*G)-V)/G;S V=V+G*S;S L=L+S
 
 {{vanchor|05.10}} T "ON THE MOON AT",L," SECS"!;S W=3600*V
 {{vanchor|05.20}} T "IMPACT VELOCITY OF",W,"M.P.H."!,"FUEL LEFT:"M-N," LBS"!
 {{vanchor|05.40}} I (1-W)5.5,5.5;T "PERFECT LANDING !-(LUCKY)"!;G 5.9
 {{vanchor|05.50}} I (10-W)5.6,5.6;T "GOOD LANDING-(COULD BE BETTER)"!;G 5.9
 {{vanchor|05.60}} I (22-W)5.7,5.7;T "CONGRATULATIONS ON A POOR LANDING"!;G 5.9
 {{vanchor|05.70}} I (40-W)5.81,5.81;T "CRAFT DAMAGE. GOOD LUCK"!;G 5.9
 {{vanchor|05.81}} I (60-W)5.82,5.82;T "CRASH LANDING-YOU'VE 5 HRS OXYGEN"!;G 5.9
 {{vanchor|05.82}} T "SORRY,BUT THERE WERE NO SURVIVORS-YOU BLEW IT!"!"IN "
 {{vanchor|05.83}} T "FACT YOU BLASTED A NEW LUNAR CRATER",W*.277777," FT.DEEP."
 {{vanchor|05.90}} T !!!!"TRY AGAIN?"!
 {{vanchor|05.92}} A "(ANS. YES OR NO)"P;I (P-0NO)5.94,5.98
 {{vanchor|05.94}} I (P-0YES)5.92,1.2,5.92 
 {{vanchor|05.98}} T "CONTROL OUT"!!!;Q
 
 {{vanchor|06.10}} S L=L+S;S T=T-S;S M=M-S*K;S A=I;S V=J
 
 {{vanchor|07.10}} I (S-.005)5.1;S S=2*A/(V+FSQT(V*V+2*A*(G-Z*K/M)))
 {{vanchor|07.30}} D 9;D 6;G 7.1
 
 {{vanchor|08.10}} S W=(1-M*G/(Z*K))/2;S S=M*V/(Z*K*(W+FSQT(W*W+V/Z)))+.05;D 9
 {{vanchor|08.30}} I (I)7.1,7.1;D 6;I (-J)3.1,3.1;I (V)3.1,3.1,8.1
 
 {{vanchor|09.10}} S Q=S*K/M;S J=V+G*S+Z*(-Q-Q^2/2-Q^3/3-Q^4/4-Q^5/5)
 {{vanchor|09.40}} S I=A-G*S*S/2-V*S+Z*S*(Q/2+Q^2/6+Q^3/12+Q^4/20+Q^5/30)

The program is cleanly separated into many subroutines. This was almost universal in FOCAL programs (and JOSS), as the line number scheme made such constructs easy to use. This program uses nine routines. The first, group 1, simply prints out the instructions using the {{code|T}}ype statement and sets the initial values for the run. The mass of fuel is not recorded directly, instead, it uses the current {{code|M}}ass and empty mass, {{code|N}}, so the remaining fuel is {{code|M-N}} and the lander runs out of fuel when {{code|M-N}} is 0. Also note the {{code|E}}rase at the end of line {{pslink|01.20}}, which resets all the variable values.

The main game loop is driven by group 2. As the code "falls" through group 1 into group 2 during the first run, the initial values are printed out in the first two lines. Near the end of line {{pslink|02.20}}, the user is {{code|A}}sked to input the burn rate as {{code|K}}, and then the loop timer is reset using {{code|S T{{=}}10}}. Line {{pslink|02.70}} tests the user's input against several possibilities, if it is over 200 or below 8 it types "<samp>NOT POSSIBLE</samp>" and a row of periods, and then loops back to ask the user to try again. If the value is between these values, it jumps forward to group 3. Note that the limited capabilities of FOCAL's {{code|IF}} command are evident here, in BASIC this could be reduced to a single {{code|IF K>200 OR K<8 THEN...|basic}}

Group 3 first tests to see if the fuel has run out, and jumps to group 4 if it has. Then it tests if the 10-second period in {{code|T}} has expired and, if so, loops back to {{pslink|02.10}} print everything out again, which has the side-effect of resetting {{mono|T}} and {{mono|S}} to 10. Line {{pslink|03.40}} tests to see if the amount of fuel burned this period, {{code|S*K}}, will reduce the mass of the vehicle as a whole, {{code|S*K-M}}, beyond the empty weight, N. If not, it moves on, if it will, it instead sets the loop timer to the amount of time the remaining fuel will burn, thus ending the loop early. In either case, it calls group 9 to update the velocity and position. It then loops over groups 7, 8 and 9 until the value of I converges.

When the 10-second timer runs out, or it reaches the end due to the fuel test in line {{pslink|03.10}} or the altitude test in {{pslink|07.10}}. In the latter cases, it will jump to group 4 and fall through to group 5, or jump to group 5 directly. Group 5 types the end-of-game results and then asks the user if they'd like to try again. If so, it jumps to {{pslink|01.20}} to clear out all values and print the headers again, if not if falls through to {{pslink|05.98}} and {{code|Q}}uits.

==See also==
*[[JOSS]], the Rand language that inspired FOCAL
*[[MUMPS]], a data-manipulation language based on JOSS and FOCAL concepts

==References==
{{Reflist}}

===Bibliography===
* {{cite book
 |title=FOCAL Programming Manual 
 |publisher=Digital Equipment Corporation 
 |date=1968 
 |url=http://www.bitsavers.org/www.computer.museum.uq.edu.au/pdf/DEC-08-AJAB-D%20PDP-8-I%20FOCAL%20Programming%20Manual.pdf 
|ref=CITEREFManual1968
}}
* {{cite web
 |url=https://www.gamedeveloper.com/business/a-basic-history-of-basic-on-its-50th-birthday
 |title=A basic history of BASIC on its 50th birthday
 |website=Gamasutra
 |date=1 May 2014
 |first=John |last=Szczepaniak
 }}
* {{cite interview
 |first=Kevin |last=Savetz
 |date=April 2013
 |title=Dave Ahl and Betsy Ahl
 |url=https://computingpioneers.com/index.php?title=Dave_Ahl_and_Betsy_Ahl
 }}

==External links==
*[ftp://ftp.pdp8.net/software/games/focal/ FOCAL source code]{{dead link|date=May 2025|bot=medic}}{{cbignore|bot=medic}}, FOCAL source for several programs, including Lunar Lander, Sumer Game, and others
*[http://www.cs.uiowa.edu/~jones/pdp8/focal/ DEC's FOCAL 1969 Promotional Booklet]
*[http://simh.trailing-edge.com/ The Computer History Simulation Project (Focal is available as a free download here)]
*{{Cite FTP |url=ftp://www.cozx.com/pub/langs/focal.tar.gz |server=www.cozx.com |url-status=dead |title=FTP link }}C-source version that runs under several operating systems, including Linux
*[http://www.catb.org/retro the C-source for a modern DOS version suitable for teaching]  
*[https://web.archive.org/web/20110525101809/http://www.libex.ru/detail/book91959.html Abramov V.A. Dialogue language FOCAL] (in Russian) {{ISBN|5-06-001785-0}}
*[https://web.archive.org/web/20080626062957/http://www.vntb.ru/kniga255.html Osetinsky L.G. FOCAL for mini-computers] (in Russian) {{ISBN|5-217-00323-5}}
*[http://samlib.ru/u/uirh/kn_o_foc.shtml Фокал снаружи и изнутри. (пишется)] – FOCAL outside and inside. (in progress) (in Russian)
*[http://samlib.ru/editors/u/uirh/foc_hlp.shtml Файл справки к фокалу-1б] – Help file for FOCAL-1B (in Russian)

{{Digital Equipment Corporation}}

[[Category:JOSS programming language family]]
[[Category:Digital Equipment Corporation]]