R. T. RUSSELL

BBC BASIC (Z80) Manual

Error Messages and Codes

Annex C to
BBC BASIC (Z80)

Summary

Trappable - Program

No	Error	No	Error
1	Out of range	2	*
3	*	4	Mistake
5	Missing ,	6	Type mismatch
7	No FN	8	*
9	Missing "	10	Bad DIM
11	DIM space	12	Not LOCAL
13	No PROC	14	Array
15	Subscript	16	Syntax error
17	Escape	18	Division by zero
19	String too long	20	Too big
21	-ve root	22	Log range
23	Accuracy lost	24	Exp range
25	*	26	No such variable
27	Missing )	28	Bad HEX
29	No such FN/PROC	30	Bad call
31	Arguments	32	No FOR
33	Can't match FOR	34	FOR variable
35	*	36	No TO
37	*	38	No GOSUB
39	ON syntax	40	ON range
41	No such line	42	Out of DATA
43	No REPEAT	44	*
45	Missing #

Trappable - Operating System

No	Error	No	Error
190	Directory full	192	Too many open files
196	File exists	198	Disk full
200	Close error	204	Bad name
214	File not found	222	Channel
253	Bad string	254	Bad command
255	CP/M error

Untrappable - Error Code 0

No room	RENUMBER space
Silly	LINE space
Sorry	Bad program
Failed at nnn

Details

Accuracy lost

23

Before BBC BASIC (Z80) calculates trigonometric functions (sin, cos, etc) of very large angles the angles are reduced to +/- PI radians. The larger the angle, the greater the inaccuracy of the reduction, and hence the result. When this inaccuracy becomes unacceptable, BBC BASIC (Z80) will issue an 'Accuracy lost' error message.

Arguments

31

This error indicates that too many or too few arguments have been passed to a procedure or function or an invalid formal parameter has been used. See the sub-section on Procedures and Functions.

Array

14

This error occurs when BBC BASIC (Z80) thinks it should be accessing an array, but does not know which one.

Bad call

30

This error indicates that a procedure or function has been incorrectly called.

Bad command

254

This error occurs when a command name is not recognized as a valid BBC BASIC (Z80) command. Star commands which are unknown to BBC BASIC (Z80) are passed to CP/M-80. If the command is unrecognised by CP/M-80, an untrappable 'Bad command or file name' error occurs.

Bad DIM

10

Arrays must be positively dimensioned. In other words, the numbers within the brackets must not be negative. This error would be produced by the following example.

DIM table(20,-10)

Bad HEX

28

Hexadecimal numbers can only include the numbers 0 to 9 and A to F. If you try to form a hex number with other characters this error will occur. For example:

&OF instead of &0F

Bad name

204

This error is generated if a path name exceeds 64 characters in length.

Bad program

Bad string

253

File names in 'star' commands may optionally be enclosed in quotes. This error will occur if the quotes are unmatched. The following example would give rise to this error.

*SAVE "GRAPHS

Channel

222

This error is generated by the disk filing system. It occurs if you try to use a channel which has not been opened, possibly because you are using the wrong channel number.

Close error

200

This error will occur if the file(s) specified cannot be closed because the disk has been changed while the file(s) were open.

DIM space

11

This error will be generated if:

• There is insufficient room for an array when you try to dimension it.

• An attempt has been made to reserve a negative amount of memory. For example,

  DIM A% -2
  

Disk full

198

This error will occur if there is insufficient room on the disk for the data/program being written to it.

Division by zero

18

Mathematically, dividing by zero gives an infinitely large answer. The computer is unable to understand the concept of infinity (it's not alone) and this error is generated. If there is any possibility that the divisor might be zero, you should test for this condition before carrying out the division. For example:

200 IF divisor=0 THEN PROC_error ELSE...

Exp range

24

The EXP function is unable to cope with powers greater than 88. If you try to use a larger power, this error will be generated.

Failed at nnn

The following example:

100 REM Demonstration renumber fail program
110 GOTO 250
120 END

10 REM Demonstration renumber fail program
20 GOTO 250
30 END

File exists

196

This error will be generated if you try to rename a file and a file with the new name already exists.

File not found

214

This error will occur if you try to LOAD, *LOAD or CHAIN a file which does not exist.

FOR variable

34

The variable in a FOR...NEXT loop must be a numeric variable. If you use a constant or a string variable this error message will be generated. For example, the following statements are not legal.

20 FOR name$=1 TO 20

20 FOR 10=1 TO 20

LINE space

Log range

22

Logarithms for zero and negative numbers do not exist. This error message will be generated if you try to calculate the log of zero or a negative number or raise a negative number to a non-integer power.

Missing ,

5

This error message is generated if BBC BASIC (Z80) was unable to find a comma where one was expected. The following example would give rise to this error.

20 PRINT TAB(10 5)

10 name$="Douglas

10 PRINT SQR(num

CLOSE 7

-ve root

21

This error message will occur if BBC BASIC (Z80) attempted to calculate the square root of a negative number. It is possible for this error to occur with ASN and ACS as well as SQR.

 90 num=-20
100 root=SQR(num)

No FN

7

If BBC BASIC (Z80) encounters an end of function without calling a function definition, this error message will be issued. If you forget to put multi-line function definitions out of harm's way at the end of the program you are very likely to get this error message. (See the sub-section on Procedures and Functions.)

No FOR

32

This error message indicates that BBC BASIC (Z80) has found a NEXT statement without first encountering a FOR statement.

No PROC

13

If BBC BASIC (Z80) encounters an ENDPROC without performing (calling) a procedure definition, this error message will be issued. If you forget to put multi-line procedure definitions out of harm's way at the end of the program you are very likely to get this error message. (See the sub-section on Procedures and Functions.)

No REPEAT

43

This error message indicates that BBC BASIC (Z80) has found an UNTIL statement without first encountering a REPEAT statement.

No room

No such FN/PROC

29

When BBC BASIC (Z80) encounters a name beginning with FN or PROC it expects to be able to find a corresponding function or procedure definition. This error will occur if such a definition does not exist.

No such line

41

This error will occur if BBC BASIC (Z80) tries to GOTO, GOSUB, TRACE or RESTORE to a non-existent line number.

No such variable

26

Variables are brought into existence by assigning a value to them or making them LOCAL in a function or procedure definition. This error message will be generated if you try to use a variable on the right-hand side of an assignment or access it in a PRINT statement before it has been created. As shown below, you can create variables very simply.

10 count=0
20 name$=""

Not LOCAL

12

If you try to define a variable as LOCAL outside a procedure or function, this error message will be generated. If you forget to put multi-line function definitions out of harm's way at the end of the program you are very likely to get this error message. (See the sub-section on Procedures and Functions.)

ON range

40

This error will be generated if, in a simple ON GOTO/GOSUB/PROC statement, the control variable was less than 1 or greater than the number of entries in the ON list. These exceptions can be trapped in ON GOTO/GOSUB/PROC statements by using the ELSE option. The first example below will generate an 'ON range' error, whilst the second is correct.

10 num=4
20 ON num GOTO 100,200,300

10 num=4
20 ON num GOTO 100,200,300 ELSE 1000

ON syntax

39

This error will be reported if the ON...GOTO statement was misformed. For example, the following statement is not legal. (Refer to the keyword ON for details of legal statements.)

20 ON x TIME=0

Out of DATA

42

If your program tried to read more items of data than there were in the data list, this error will be generated. You can use RESTORE to return the data pointer to the first data statement (or to a particular line with a data statement) if you wish.

Out of range

1

This assembly language error will be reported if you tried to perform a relative jump of more than +127 or -128 bytes or you used a 16 bit port address when only an 8 bit address is allowed.

RENUMBER space

Silly

String too long

19

You will get this error message if your program tries to generate a string which is longer than 255 characters.

Subscript

15

If you try to access an element of an array less than zero or greater than the size of the array you will generate this error. Both lines 20 and 30 of the following example would give rise to this error message.

10 DIM test(10)
20 test(-4)=20
30 test(30)=10

Syntax error

16

A command was terminated incorrectly. In other words, the first part of the command was recognized, but the rest of it was meaningless or incomplete. Unlike Mistake, BBC BASIC (Z80) was able to recognise the start of the command.

Too big

20

This error will occur if a number is entered or calculated which is too big for BBC BASIC (Z80) to cope with.

Too many open files

192

This error will occur if you try to open more than seven files at any one time.

Type mismatch

6

This error indicates that a number was encountered when a string was expected and vice-versa. Don't forget that this can occur if the actual parameters and the formal parameters for a function or procedure do not correspond. (See sub-section on Procedures and Functions for details of parameter passing to functions and procedures.)

CONTENTS

CONTINUE