ERR(0)

Returns the last Basic error code. See sys:errmsg.xxx for the description of all the Basic error codes. Also see ERRMSG.SBR for info on displaying and/or logging the error text under application control, as well as .LINENO in the Dot Variables table.

ERR(1)

Returns the last line number processed. Note that since A-Shell Basic doesn't require line numbers on every line, the last line number processed might be a long way from where the error occurred (or it may be 0 if the program has no line numbers). See ERR(8) to get the precise location of the error.

ERR(2)

Returns the last file channel processed. See FILNAM.SBR for info on retrieving the name of the file associated with the channel.

ERR(7)

(A-Shell Extension) Reports the location of the last error within the current stack frame/scope. This would differ from ERR(8) if the error occurred within a function or procedure and was allowed to percolate up to a higher level, where ERR(7) would indicate the line that called the function or procedure. Also see .LOCATION in the Dot Variables table to retrieve the current location counter outside the context of a BASIC error.

ERR(8)

(A-Shell Extension) Returns the internal location counter where the error occurred. Note that by convention, location counter values are usually displayed in hex, but the Basic PRINT statement has no way to know (or support) this. So if you are going to print the value of err(8), you may want to use MIAMEX, MX_OCVT, or the Fn'Dec2Hex$() function (in the SOSLIB). To match the location with a line of source code, you'll need to compile your program with the /L switch to create a LSX file, which lists the location counter (in hex) for each statement. Also see .LOCATION in the Dot Variables table to retrieve the current location counter outside the context of a BASIC error.

ERR(9)

(A-Shell Extension) Returns the function or procedure nesting level at the time of the error (equivalent to the dot variable .NEST_LEVEL). This might be helpful in debugging.