ERNUM

Syntax ERNUM
Location QL ROM (post JM version)

This function returns the error number of the last error which occurred. An error number is negative and can be returned by any program (SuperBASIC, jobs, M/C Toolkits,…). The equivalent error messages are the same on all of the implementations of SuperBASIC, although they are also supported in different languages (see the Appendix for other languages):

Error English message
-1 Not Complete
-2 Invalid Job
-3 Out of Memory
-4 Out of Range
-5 Buffer Full
-6 Channel not Open
-7 Not Found
-8 Already Exists
-9 In Use
-10 End of File
-11 Drive Full
-12 Bad Name
-13 Xmit Error
-14 Format Failed
-15 Bad Parameter
-16 Bad or Changed Medium
-17 Error in Expression
-18 Overflow
-19 Not Implemented Yet
-20 Read Only
-21 Bad Line

NOTE

Jobs may return a positive error number. The meaning of such a number depends on the job. No error message will be reported.

SMS NOTE

The error messages have been redefined to try to make them more intelligent, they are now:

Error English message
-1 Incomplete
-2 Invalid Job ID
-3 Insufficient memory
-4 Value out of range
-5 Buffer full
-6 Invalid channel ID
-7 Not found
-8 Already exists
-9 Is in use
-10 End of file
-11 Medium is full
-12 Invalid name
-13 Transmission error
-14 Format failed
-15 Invalid parameter
-16 Medium check failed
-17 Error in expression
-18 Arithmetic overflow
-19 Not implemented
-20 Write protected
-21 Invalid syntax
-22 Unknown message
-23 Access denied

Other errors are reported by the SBASIC interpreter, but these are not covered by ERNUM.

CROSS-REFERENCE

ERLIN returns the line number where the error occurred. ERNUM% is the same as this function. REPORT invokes an error message and WHEN ERRor can be used to trap errors. The ERR_XX functions are alternatives to ERNUM.