FOCAL (programming language)
FOCAL is an interactive interpreted programming language based on JOSS and primarily used on Digital Equipment Corporation PDP-series machines. The name is an acronym, alternately for Formulating On-Line Calculations in Algebraic Language, or FOrmula CALculator.
FOCAL is very similar to JOSS in terms of the commands it supports and the general syntax of the language. It differs in that many of JOSS' advanced features like ranges and user-defined functions were removed to simplify the parser. Some of the keywords were renamed so that they all start with a unique first letter. This allows users to type in programs using single-character statements, further reducing memory needs. This was an important consideration on the PDP-8, which was often limited to a few kilobytes.
Like JOSS, and later BASICs, FOCAL on the PDP-8 was a complete environment that included a line editor, the interpreter, and input/output routines. The package as a whole was called 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 historically notable as the language for the original versions of the early video games Hamurabi and Lunar Lander. Both were later ported to BASIC where they became much more famous. 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 computers.
History
JOSS
was released in May 1963 on the one-off JOHNNIAC computer at RAND Corporation. Within RAND, use grew rapidly, and the machine, originally constructed in 1953, quickly ran out of capability. JOHNNIAC retired in 1966 and JOSS moved to a newly purchased PDP-6, Digital Equipment Corporation's first "big" machine. Usage continued to grow and by 1970 the system was being used by 500 to 600 users across the country and had spawned a number of innovations such as mobile computer terminals that could be wheeled from room to room and plugged in for instant access.JOSS was extremely influential in the computer field. It emerged just as the time-sharing concept was being introduced and there was significant interest in man-machine interaction and computers were seeing more widespread use. Whereas most timeshare operating systems of the era concentrated on user account and file management, leaving the users on their own when it came to programming, JOSS provided these functions and an easily used programming language in a single package. RAND showed the system to a parade of people in the industry.
FOCAL
Written by 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 machines in the DEC lineup. To achieve this, a major change was made to reduce the amount of temporary data, or "state", needed to parse the statements. One noticeable effect of this decision was that conditionals could only be used for 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 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 blank. In contrast, JOSS had to continue reading until it had read the entire command word, and then compare that against a list containing complete words. Users could save memory by typing in only that letter, reducing the size of the source code.
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 terms of memory use, which was often severely limited on these machines to a few kilobytes. 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.
BASIC
While FOCAL was becoming popular on DEC machines, BASIC was becoming a more popular alternative on other platforms. By the late 1960s, a number of companies were making inroads in DEC's minicomputer stronghold selling similar machines running timeshared versions of BASIC. Notable among these was the HP 2100 series, running HP Time-Shared BASIC.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 educational market, especially with the growing library of BASIC programs from the Minnesota Educational Computing Consortium, Ahl found selling the machine with FOCAL was difficult in spite of its advantages. As he later noted:
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 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, FOCAL and FORTRAN as well. Some PDP-11 based EduSystems were also created.
Ahl then began porting programs from FOCAL to BASIC, notably The Sumer Game, a version of Lunar Lander, and a number of 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.
By the mid-1970s BASIC was a standard feature of all DEC machines and FOCAL use evaporated.
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 computers. Most notable among several models were the Electronika BK series, released in 1985. These were initially supplied with FOCAL on a ROM cartridge, while a BASIC cartridge was an optional add-on. Later models supplied BASIC by default.Language
The following description is based on FOCAL-69 as seen in the FOCAL-8 language reference manual.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.The method of operation is similar to BASIC's "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 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.
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, the FOCAL equivalent to BASIC's, leading zeros will be added so that all line numbers. This means all line numbers will be a total of five characters including the period; 1.10 will be printed as. Statements referring to those lines do not need the leading zeros, for instance,.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, for instance, which will jump to the subroutine written in group 5. The editor also used these during edit-time, for instance, one could to produce a listing of the code in group 2, or to delete all of the lines in group 4.
Every line must start with a command keyword following the line number. There is no concept of a "default command" as is the case in BASIC with its optional 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.
Commands
ASK
The command will take a list of strings and variables, echo the strings and store the user input in variables. Equivalent to BASIC's.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 command creates a remark. Equivalent to BASIC's.01.01 COMMENT: THE SUMER GAME, BY RICHARD MERRILL
DO
The command branches execution to a subroutine. It is the equivalent of BASIC's. The subroutine is referenced either by group number or line number. If a line number is provided, that single line is run and then returns to the statement after the. 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 or a is encountered. is only required to return early from the group, it is not needed at the end of the group.01.15 DO 7.24
01.16 DO 8
FOR
The command 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 two values are provided, the first is the initial value and the second is the terminating value, and the increment is set to 1.In contrast to other parts of the language where multiple statements on a line are independent, the 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 alternately, call a subroutine with. There is no equivalent of BASIC's.
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**TERM
02.20 TYPE "RATE",RATE," ","INTEREST",INTEREST,!
GOTO
The command jumps program execution to the specified line number. It is identical to the same-named statement in BASIC. In FOCAL, is also used to begin execution, like BASIC's, but in this usage, the documentation refers to it as instead of in spite of the underlying command being the same.01.05 GOTO 1.01
02.90 TYPE !!,"TRY AGAIN.",!!!!!;GOTO 1.1
IF
The command 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.02.20 IF 2.4,2.3,2.4
03.01 IF 3.1,3.02,3.1
IF could be short-formed by placing a semicolon beyond the first line number. For instance:
02.20 IF 1.8; TYPE "Q"
02.30 IF 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.
QUIT
The command terminates execution of the program and returns control to the editing environment. Equivalent to BASIC's or.01.10 FOR X=-10,1,10;TYPE X
01.20 QUIT
RETURN
The command branches execution from a subroutine back to the calling location. The use of 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.22.78 COMMENT: 'YES OR NO' SUBROUTINE
22.80 ASK "ANSWER YES OR NO ? ",AN
22.82 IF 22.84,22.86
22.84 IF 22.8,22.88,22.8
22.86 SET X=2;RETURN
22.88 SET X=1;RETURN
SET
The command assigns the results of an expression to the specified variable. Equivalent to BASIC's.01.30 SET PI=3.14156
01.60 SET INTEREST=PRINCIPAL**TERM
TYPE
The command provides for output of one or more items separated by commas. Equivalent to BASIC's.Items can be variables, literal strings surrounded by double-quotes, or a variety of control characters. The control characters include the to output a carriage return and line feed, for the carriage return alone, and for a tab character. Control characters can be strung together, for instance, will output three CR/LFs without the need to separate them with commas.
TYPE ...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
03.20 TYPE ".",#
02.20 TYPE !!!!!
also included an optional format specifier indicated using the format, 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, meaning a maximum of eight digits and four to the right of the period. So, for instance:
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.
A special control character was 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. For example:
TYPE $
A0=67823
Variables
Variable names may start with any letter except F and may contain any sequence of letters and numbers. However, only the first two characters are significant. For instance, the following code sample from FOCAL: A New Conversational Language 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 2.4,3.1,2.4
Any variable may be treated as an array, allowing subscripts from -2048 through 2047.
Math
FOCAL-69 contained only five mathematical operators:- for exponents - the exponent is converted to a 12-bit integer
- for multiplication
- for division
- for addition
- for subtraction
FOCAL was unusual in that mathematical expressions could use, and <> interchangeably in matched pairs to establish precedence. For instance, the following is a valid expression:
01.30 SET A=<10**>
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.
The language contained the following built-in functions:
- - Absolute value
- - Arctangent
- - Cosine of argument in radians
- - Natural base to the power of the argument
- - Integer part of the argument
- - Naperian log
- - Random number
- - Sign of the argument; FSGN=1 in FOCAL-69, but FSGN=0 in FOCAL-71 as well as later versions
- - Sine of an angle given in radians
- - Square root
Other functions
- took two values and plotted a dot on the screen of graphical terminals
- read a value from a numbered analog input and returned an integer value
Environment commands
Running programs
FOCAL used in the editor to start a program. However, a rule-of-thumb was to shorten this to. This is the equivalent of in BASIC. can also be used in the editor to start execution at a specified line.Editing commands
New lines are entered into the program by simply beginning the command with a line number. The editing commands were ERASE, MODIFY and WRITE :-
ERASE
- zeroes out all variables. this is sometimes found within programs to reset them -
ERASE line number
- deletes the statement at the specified line -
ERASE group number
- deletes all statements in the specified group -
ERASE ALL
- deletes the entire program -
MODIFY line number
- allows the programmer to edit the specified line -
WRITE line number
- display the statement at the specified line -
WRITE group number
- display all statements in the specified group -
WRITE ALL
- display the specified programFile commands
- - prepare to read from the start of a file
- - prepare to write from the start of a file
- - resume input
- - resume output
- - output the buffer and close the file
Library commands
-
LIBRARY DELETE program name
- delete a program -
LIBRARY LIST
- catalog -
LIBRARY RUN program name
- chain the program, optionally resuming at the specified line number -
LIBRARY SAVE program name
- save the program -
LIBRARY EXIT
- return to the PDP-8 monitor program
-
LIBRARY CALL program name
- load a program -
LIBRARY GOSUB program name''
- call a subroutine in an external programError codes
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 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 function now returned zero if the input expression evaluated to zero. Previously this would return one. The now used a better algorithm that produced more randomly distributed numbers. It also added the new function that took a string and returned its ASCII value and which took a number and returned a string with that ASCII character (.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. A few features of JOSS were missing in FOCAL.One major difference is that JOSS included a complete set of comparison operations and a boolean logic system that operated within if and for constructs. Furthermore, the ifs 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 instance, in JOSS, one could:
1.10 Type A if X>10.
1.20 Type i for i=110.
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 ,,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 the programmer's intentions, at the cost of making the runtime more complex. For instance, JOSS allowed ranges in loops to be described in a flexible fashion like 1,2,3,1050,75,78. This flexibility comes at a cost; in FOCAL the start, stop and step can be written down 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 terms of making the code terser, changes were relatively minor. For instance, JOSS' becomes the slightly smaller FOCAL, while becomes. Command keywords were also shortened where possible, so JOSS' becomes FOCAL's, both to make it shorter as well as allow the letter D to be uniquely used for. The period needed to indicate the end of a line in JOSS was removed.
To simplify the parser, some FOCAL options were removed. For instance, JOSS could perform multiple assignments with while in FOCAL these had to be made individual statements,. Likewise, JOSS', used to format output, was combined into FOCAL's with the.
Comparison with BASIC
Comparisons between FOCAL and BASIC were inevitable since both languages were common on minicomputers of the same era, and the two languages have much in common in terms of syntax and structure. In most cases, there is a direct conversion of FOCAL code to and from BASIC. For instance, to ask the user to input a value, in FOCAL one would:ASK "What is your age?",AGE
while in BASIC the equivalent is:
INPUT "What is your age?",AGE
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 in BASIC, which allowed any statement to be placed after the, 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 whereas FOCAL used, as in JOSS. BASIC's version has the advantage that the runtime could immediately abort reading the rest of the statement if the expression was not true. In contrast, FOCAL's was more like BASIC's computed goto,, but the allowed any number of lines as targets, as opposed to only three for negative, zero and positive as in JOSS and FOCAL.
Another major difference between the two is that FOCAL lacked inherent support for 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, this limitation was generally avoided through the use of literal strings in input and output commands. It was only when one had to manipulate individual strings or characters within 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 the user to their numeric character value. For example, if one typed "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 codes. 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 particularly helpful response. Nevertheless, by asking questions that would be responded to using single-letter responses, like, programmers could test the result against known character values to produce what looked like character input.
FOCAL's PDP-8 implementation used a 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 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.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 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 Russia, it saw use as late as the early 1990s in mass-produced home computers of the Electronika BK series.
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 .01.04 T "CONTROL CALLING LUNAR MODULE. MANUAL CONTROL IS NECESSARY"!
01.06 T "YOU MAY RESET FUEL RATE K EACH 10 SECS TO 0 OR ANY VALUE"!
01.08 T "BETWEEN 8 & 200 LBS/SEC. YOU'VE 16000 LBS FUEL. ESTIMATED"!
01.11 T "FREE FALL IMPACT TIME-120 SECS. CAPSULE WEIGHT-32500 LBS"!
01.20 T "FIRST RADAR CHECK COMING UP"!!!;E
01.30 T "COMMENCE LANDING PROCEDURE"!"TIME,SECS ALTITUDE,"
01.40 T "MILES+FEET VELOCITY,MPH FUEL,LBS FUEL RATE"!
01.50 S A=120;S V=1;S M=32500;S N=16500;S G=.001;S Z=1.8
02.10 T " ",%3,L," ",FITR," ",%4,5280*
02.20 T %6.02," ",3600*V," ",%6.01,M-N," K=";A K;S T=10
02.70 T %7.02;I 2.72;I 3.1,3.1;I 2.72,3.1
02.72 T "NOT POSSIBLE";F X=1,51;T "."
02.73 T "K=";A K;G 2.7
03.10 I 4.1;I 2.1;S S=T
03.40 I 3.5,3.5;S S=/K
03.50 D 9;I 7.1,7.1;I 3.8,3.8;I 8.1
03.80 D 6;G 3.1
04.10 T "FUEL OUT AT",L," SECS"!
04.40 S S=/G;S V=V+G*S;S L=L+S
05.10 T "ON THE MOON AT",L," SECS"!;S W=3600*V
05.20 T "IMPACT VELOCITY OF",W,"M.P.H."!,"FUEL LEFT:"M-N," LBS"!
05.40 I 5.5,5.5:T "PERFECT LANDING !-"!;G 5.9
05.50 I 5.6,5.6;T "GOOD LANDING-"!;G 5.9
05.60 I 5.7,5.7;T "CONGRATULATIONS ON A POOR LANDING"!;G 5.9
05.70 I 5.81,5.81;T "CRAFT DAMAGE. GOOD LUCK"!;G 5.9
05.81 I 5.82,5.82;T "CRASH LANDING-YOU'VE 5 HRS OXYGEN"!;G 5.9
05.82 T "SORRY,BUT THERE WERE NO SURVIVORS-YOU BLEW IT!"!"IN "
05.83 T "FACT YOU BLASTED A NEW LUNAR CRATER",W*.277777," FT.DEEP.
05.90 T !!!!"TRY AGAIN?"!
05.92 A ""P;I 5.94,5.98
05.94 I 5.92,1.2,5.92
05.98 T "CONTROL OUT"!!!;Q
06.10 S L=L+S;S T=T-S;S M=M-S*K;S A=I;S V=J
07.10 I 5.1;S S=2*A/
07.30 D 9;D 6;G 7.1
08.10 S W=/2;S S=M*V/+.05;D 9
08.30 I 7.1,7.1;D 6;I 3.1,3.1;I 3.1,3.1,8.1
09.10 S Q=S*K/M;S J=V+G*S+Z*
09.40 S I=A-G*S*S/2-V*S+Z*S*
The program is cleanly separated into a number of subroutines. This was almost universal in FOCAL programs, 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 ype statement and sets the initial values for the run. The mass of fuel is not recorded directly, instead, it uses the current ass and empty mass,, so the remaining fuel is M-N and the lander runs out of fuel when M-N is 0. Also note the rase at the end of line 1.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 2.20, the user is sked to input the burn rate as, and then the loop timer is reset using. Line 2.70 tests the user's input against several possibilities, if it is over 200 or below 8 it types "NOT POSSIBLE" 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 command are evident here, in BASIC this could be reduced to a single
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 has expired and, if so, loops back to print everything out again, which has the side-effect of resetting T and S to 10. Line 3.40 tests to see if the amount of fuel burned this period, S*K, will reduce the mass of the vehicle as a whole, 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 3.10 or the altitude test in 7.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 1.20 to clear out all values and print the headers again, if not if falls through to 5.98 and uits.