Script Function: Supplies the variable message part of the last error
Syntax
SYS_LAST_ERR_INS ()
|
Return codes |
|---|
|
Variable message part of the last error |
Comments
Some script elements facilitate continued script processing in the case of occurring errors when :ON_ERROR is used. The script function then retrieves the variable part of the error message .
Most error messages do not only consist of a pre-determined text. Parts of the message refer to object names or script lines, for example. These variable parts of error messages are put in inverted commas.
Example of an error message:
U0020645 - Runtime error in object '&01', line '&02'.: There is no object '&04'.
The variable parts are replaced by values when the above error message is output:
U0020645 - Runtime error in object 'MOVE_OBJECT', line '0003'. There is no object 'MM.CLOSING.2005'.
Example
The example shown below intends to check a hard drive's memory. An error occurs if this hard drive is not available or cannot be accessed. The corresponding error number and variable message parts are read and the entire AE error message is retrieved and sent to a user.
:SET &CHECK# =
GET_FILESYSTEM("WIN21G", "Z:\", FILESYSTEM_SPACE_TOTAL)
:SET &ERRINS# = SYS_LAST_ERR_INS()
:IF &ERRINS# NE ""
: SET &ERRNR# =
SYS_LAST_ERR_NR()
: SET &MESSAGE# = GET_MSG_TXT (&ERRNR#,&ERRINS#)
: SEND_MSG BU,BU,&MESSAGE#
:ENDIF
See also:
| Script element | Description |
|---|---|
|
Retrieves the message text of the last error |
|
|
Retrieves the type of a message number |
|
|
Returns the number of the last error |
|
|
Retrieves the last error message of the OS |
Script Elements - Error Handling and Messages
Sample Collection:
Retrieving Error Message and Number
About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function