AmigaOS Manual: ARexx Error Messages - Revision history

Janne Peräaho at 02:58, 24 June 2020

2020-06-24T02:58:00Z

← Older revision		Revision as of 02:58, 24 June 2020
Line 11:		Line 11:
	\| 1 \|\| 5 \|\| Program not found \|\| The named program could not be found or was not an ARexx program. ARexx program are expected to start with a comment (/.../). This error is detected by the external interface and cannot be trapped by the SYNTAX interrupt.		\| 1 \|\| 5 \|\| Program not found \|\| The named program could not be found or was not an ARexx program. ARexx program are expected to start with a comment (/.../). This error is detected by the external interface and cannot be trapped by the SYNTAX interrupt.
	\|-		\|-
			\| 2 \|\| 10 \|\| Execution halted \|\| A <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">C</kbd> break or an external halt request was received and the program terminated. This error will be trapped if the HALT interrupt has been enabled.
	\| 2 \|\| 10 \|\| Execution halted \|\| A Ctrl+C break or an external halt request was received and the program terminated. This error will be trapped if the HALT interrupt has been enabled.
	\|-		\|-
	\| 3 \|\| 20 \|\| Insufficient memory \|\| The interpreter was unable to allocate enough memory for an operation. Since memory space is required for all parsing and execution operations, this error cannot usually be trapped by the SYNTAX interrupt.		\| 3 \|\| 20 \|\| Insufficient memory \|\| The interpreter was unable to allocate enough memory for an operation. Since memory space is required for all parsing and execution operations, this error cannot usually be trapped by the SYNTAX interrupt.

Janne Peräaho: Marked errors 4, 7, and 38 as deprecated

2017-07-11T20:15:25Z

Marked errors 4, 7, and 38 as deprecated

← Older revision		Revision as of 20:15, 11 July 2017
Line 15:		Line 15:
	\| 3 \|\| 20 \|\| Insufficient memory \|\| The interpreter was unable to allocate enough memory for an operation. Since memory space is required for all parsing and execution operations, this error cannot usually be trapped by the SYNTAX interrupt.		\| 3 \|\| 20 \|\| Insufficient memory \|\| The interpreter was unable to allocate enough memory for an operation. Since memory space is required for all parsing and execution operations, this error cannot usually be trapped by the SYNTAX interrupt.
	\|-		\|-
	\| 4 \|\| 10 \|\| Invalid character \|\| A non-ASCII character was found in the program. Control codes and other non-ASCII characters may be used in a program by defining them as hex or binary strings. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.		\| 4 \|\| 10 \|\| Invalid character \|\| A non-ASCII character was found in the program. Control codes and other non-ASCII characters may be used in a program by defining them as hex or binary strings. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt. <span style="color: red;">DEPRECATED</span>
	\|-		\|-
	\| 5 \|\| 10 \|\| Unmatched quote \|\| A closing single or double quote was missing. Check that each string is properly delimited. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.		\| 5 \|\| 10 \|\| Unmatched quote \|\| A closing single or double quote was missing. Check that each string is properly delimited. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.
Line 21:		Line 21:
	\| 6 \|\| 10 \|\| Unterminated comment \|\| The closing / of a comment was not found. Remember that comments may be nested, so each / must be matched by a */. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.		\| 6 \|\| 10 \|\| Unterminated comment \|\| The closing / of a comment was not found. Remember that comments may be nested, so each / must be matched by a */. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.
	\|-		\|-
	\| 7 \|\| 10 \|\| Clause too long \|\| A clause was too long for the internal buffer. The source line should be broken into smaller parts. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.		\| 7 \|\| 10 \|\| Clause too long \|\| A clause was too long for the internal buffer. The source line should be broken into smaller parts. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt. <span style="color: red;">DEPRECATED</span>
	\|-		\|-
	\| 8 \|\| 10 \|\| Invalid token \|\| An unrecognized lexical token was found, or a clause could not be properly classified. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.		\| 8 \|\| 10 \|\| Invalid token \|\| An unrecognized lexical token was found, or a clause could not be properly classified. This is a scan-phase error and cannot be trapped by the SYNTAX interrupt.
Line 83:		Line 83:
	\| 37 \|\| 10 \|\| Invalid template \|\| The template provided with an ARG, PARSE or PULL instruction was not properly constructed.		\| 37 \|\| 10 \|\| Invalid template \|\| The template provided with an ARG, PARSE or PULL instruction was not properly constructed.
	\|-		\|-
	\| 38 \|\| 10 \|\| Invalid TRACE request \|\| The alphabetic keyword supplied with a TRACE instruction or as the argument to the TRACE() built-in function was not valid.		\| 38 \|\| 10 \|\| Invalid TRACE request \|\| The alphabetic keyword supplied with a TRACE instruction or as the argument to the TRACE() built-in function was not valid. <span style="color: red;">DEPRECATED</span>
	\|-		\|-
	\| 39 \|\| 10 \|\| Uninitialized variable \|\| An attempt was made to use an uninitialized variable while the NOVALUE interrupt was enabled.		\| 39 \|\| 10 \|\| Uninitialized variable \|\| An attempt was made to use an uninitialized variable while the NOVALUE interrupt was enabled.

Tony Wyatt: More typos

2014-01-28T00:28:29Z

More typos

← Older revision		Revision as of 00:28, 28 January 2014
Line 67:		Line 67:
	\| 29 \|\| 10 \|\| Incomplete IF or SELECT \|\| An IF or SELECT range ended before all of the required statements were found. Check whether the conditional statement following a THEN, ELSE or OTHERWISE clause was omitted.		\| 29 \|\| 10 \|\| Incomplete IF or SELECT \|\| An IF or SELECT range ended before all of the required statements were found. Check whether the conditional statement following a THEN, ELSE or OTHERWISE clause was omitted.
	\|-		\|-
	\| 30 \|\| 10 \|\| Label not found \|\| A label specified by a SIGNAL instruction or implicitly referenced by a enabled interrupt could not be found in the program source. Labels defined dynamically by an INTERPRET instruction or by interactive input are not included in the search.		\| 30 \|\| 10 \|\| Label not found \|\| A label specified by a SIGNAL instruction or implicitly referenced by an enabled interrupt could not be found in the program source. Labels defined dynamically by an INTERPRET instruction or by interactive input are not included in the search.
	\|-		\|-
	\| 31 \|\| 10 \|\| Symbol expected \|\| A non-symbol token was found where only a symbol token is valid. The DROP, END, LEAVE, ITERATE and UPPER instructions may only be followed by a symbol token. This message will also be issued if a required symbol is missing.		\| 31 \|\| 10 \|\| Symbol expected \|\| A non-symbol token was found where only a symbol token is valid. The DROP, END, LEAVE, ITERATE and UPPER instructions may only be followed by a symbol token. This message will also be issued if a required symbol is missing.

Tony Wyatt: Fixed typos

2014-01-28T00:25:56Z

Fixed typos

Steven Solie at 23:24, 23 January 2014

2014-01-23T23:24:27Z

@@ Line 10: / Line 10: @@
 |-
 | 1 || 5 || Program not found || The named program could not be found or was not an ARexx program. ARexx program are expected to start with a comment (/*...*/). This error is detected by the external interface and cannot be trapped by the SYNTAX interrupt.
 |}

Steven Solie: Created page with "When the ARexx interpreter detects an error in a program, it returns an error code to indicate the nature of the problem. Errors are normally handled by displaying the error c..."

2014-01-23T23:13:48Z

Created page with "When the ARexx interpreter detects an error in a program, it returns an error code to indicate the nature of the problem. Errors are normally handled by displaying the error c..."

New page

When the ARexx interpreter detects an error in a program, it returns an error code to indicate the nature of the problem. Errors are normally handled by displaying the error code, the source line number where the error occurred and a brief message explaining the error condition. Unless the SYNTAX interrupt has been previously enabled (using the SIGNAL instruction), the program then terminates and control returns to the caller. Most syntax and execution errors can be trapped by the SYNTAX interrupt, allowing the user to retain and perform whatever special error processing is required. Certain errors are generated outside of the context of an ARexx program and therefore cannot be trapped by this mechanism. Refer to Chapter 6 for further information on error trapping and processing.

Each error code is associated with a severity level that is reported to the calling program as the primary result code. The values of these results codes are 5 (least serious), 10 (moderately serious), and 20 (very serious). The error code itself is returned as the secondary result. The subsequent propagation or reporting of these codes is dependent on the external (calling) program.

The following pages list all of the currently-defined error codes, along with the associated result code and message strings.

{| class="wikitable"
|+ Table A-1. Error Codes and Messages
! Error !! Result Code !! Message !! Explanation
|-
| 1 || 5 || Program not found || The named program could not be found or was not an ARexx program. ARexx program are expected to start with a comment (/*...*/). This error is detected by the external interface and cannot be trapped by the SYNTAX interrupt.
|}

← Older revision		Revision as of 00:25, 28 January 2014
Line 39:		Line 39:
	\| 15 \|\| 10 \|\| Function not found \|\| A function was called that could not be found in any of the currently accessible libraries and could not be located as an external program. Check that the appropriate function libraries have been added to the Libraries List.		\| 15 \|\| 10 \|\| Function not found \|\| A function was called that could not be found in any of the currently accessible libraries and could not be located as an external program. Check that the appropriate function libraries have been added to the Libraries List.
	\|-		\|-
	\| 16 \|\| 10 \|\| Function did not return value \|\| A function was called which failed to return a result string, but did not otherwise report an error. Check that the function was programmed correctly or invoke it using the CALL instruction.		\| 16 \|\| 10 \|\| Function did not return a value \|\| A function was called which failed to return a result string, but did not otherwise report an error. Check that the function was programmed correctly or invoke it using the CALL instruction.
	\|-		\|-
	\| 17 \|\| 10 \|\| Wrong number of arguments \|\| A call was made to a function which expected a different number of arguments. This error will be generated if a built-in or external function is called with more arguments than can be accommodated in the message packet used for external communications.		\| 17 \|\| 10 \|\| Wrong number of arguments \|\| A call was made to a function which expected a different number of arguments. This error will be generated if a built-in or external function is called with more arguments than can be accommodated in the message packet used for external communications.
Line 51:		Line 51:
	\| 21 \|\| 10 \|\| Unexpected ELSE or OTHERWISE \|\| An ELSE or OTHERWISE was found outside of a valid context. The OTHERWISE instruction is valid only within a SELECT range. ELSE is valid only following the THEN branch of an IF range.		\| 21 \|\| 10 \|\| Unexpected ELSE or OTHERWISE \|\| An ELSE or OTHERWISE was found outside of a valid context. The OTHERWISE instruction is valid only within a SELECT range. ELSE is valid only following the THEN branch of an IF range.
	\|-		\|-
	\| 22 \|\| 10 \|\| Unexpected BREAK, LEAVE or ITERATE \|\| The BREAK instruction ~~invalid~~ only within a DO range or inside an INTERPRETed string. The LEAVE and ITERATE instructions are valid only within an iterative DO range.		\| 22 \|\| 10 \|\| Unexpected BREAK, LEAVE or ITERATE \|\| The BREAK instruction is valid only within a DO range or inside an INTERPRETed string. The LEAVE and ITERATE instructions are valid only within an iterative DO range.
	\|-		\|-
	\| 23 \|\| 10 \|\| Invalid statement in SELECT \|\| An invalid statement was encountered within a SELECT range. Only WHEN, THEN and OTHERWISE statements are valid within a SELECT range, except for the conditional statements following THEN or OTHERWISE clauses.		\| 23 \|\| 10 \|\| Invalid statement in SELECT \|\| An invalid statement was encountered within a SELECT range. Only WHEN, THEN and OTHERWISE statements are valid within a SELECT range, except for the conditional statements following THEN or OTHERWISE clauses.
Line 63:		Line 63:
	\| 27 \|\| 10 \|\| Symbol mismatch \|\| The symbol specified on an END, ITERATE or LEAVE instruction did not match the index variable for the DO range. Check that the active loops have been nested properly.		\| 27 \|\| 10 \|\| Symbol mismatch \|\| The symbol specified on an END, ITERATE or LEAVE instruction did not match the index variable for the DO range. Check that the active loops have been nested properly.
	\|-		\|-
	\| 28 \|\| 10 \|\| Invalid DO syntax \|\| An invalid DO instruction was executed. An initializer expression must be given if a TO or BY expression is specified. A FOR expression must yield a non-negative integer result		\| 28 \|\| 10 \|\| Invalid DO syntax \|\| An invalid DO instruction was executed. An initializer expression must be given if a TO or BY expression is specified. A FOR expression must yield a non-negative integer result.
	\|-		\|-
	\| 29 \|\| 10 \|\| Incomplete IF or SELECT \|\| An IF or SELECT range ended before all of the required statements were found. Check whether the conditional statement following a THEN, ELSE or OTHERWISE clause was omitted.		\| 29 \|\| 10 \|\| Incomplete IF or SELECT \|\| An IF or SELECT range ended before all of the required statements were found. Check whether the conditional statement following a THEN, ELSE or OTHERWISE clause was omitted.
	\|-		\|-
	\| 30 \|\| 10 \|\| Label not found \|\| A label specified by a SIGNAL instruction or implicitly referenced by a enabled interrupt could not be found in the program source. Labels defined by dynamically by an INTERPRET instruction or by interactive input are not included in the search.		\| 30 \|\| 10 \|\| Label not found \|\| A label specified by a SIGNAL instruction or implicitly referenced by a enabled interrupt could not be found in the program source. Labels defined dynamically by an INTERPRET instruction or by interactive input are not included in the search.
	\|-		\|-
	\| 31 \|\| 10 \|\| Symbol expected \|\| A non-symbol token was found where only a symbol token is valid. The DROP, END, LEAVE, ITERATE and UPPER instructions may only be followed by a symbol token. This message will also be issued if a required symbol is missing.		\| 31 \|\| 10 \|\| Symbol expected \|\| A non-symbol token was found where only a symbol token is valid. The DROP, END, LEAVE, ITERATE and UPPER instructions may only be followed by a symbol token. This message will also be issued if a required symbol is missing.
Line 99:		Line 99:
	\| 45 \|\| 10 \|\| Expression required \|\| An expression was omitted in a context where one is required. For example, the SIGNAL instruction, if not followed by the keywords ON or OFF, must be followed by an expression.		\| 45 \|\| 10 \|\| Expression required \|\| An expression was omitted in a context where one is required. For example, the SIGNAL instruction, if not followed by the keywords ON or OFF, must be followed by an expression.
	\|-		\|-
	\| 46 \|\| 10 \|\| Boolean value not 10 or 1 \|\| An expression result was expected to yield a Boolean result, but evaluated to something other ~~tan~~ 0 or 1.		\| 46 \|\| 10 \|\| Boolean value not 0 or 1 \|\| An expression result was expected to yield a Boolean result, but evaluated to something other than 0 or 1.
	\|-		\|-
	\| 47 \|\| 10 \|\| Arithmetic conversion error \|\| A non-numeric operand was used in an operation requiring numeric operands. This message will also be generated by an invalid hex or binary string.		\| 47 \|\| 10 \|\| Arithmetic conversion error \|\| A non-numeric operand was used in an operation requiring numeric operands. This message will also be generated by an invalid hex or binary string.