A-Shell Consolidated Reference

ERR(0)

Returns the last ASB error code. See sys:errmsg.xxx for the description of all the ASB error codes. Also see ERRMSG 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 ASB 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 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 an ASB 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 an ASB 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.