FEXERR: Retrieving an Error Message

How to:

Available Languages: reporting, Maintain

The FEXERR function retrieves an Information Builders error message. It is especially useful in a procedure using a command that suppresses the display of output messages.

An error message consists of up to four lines of text; the first line contains the message and the remaining three contain a detailed explanation, if one exists. FEXERR retrieves the first line of the error message.
Top of page
x
Syntax: How to Retrieve an Error Message
FEXERR(error, 'A72')

where:

error

Numeric

Is the error number, up to 5 digits long.

'A72'

Is the format of the output value enclosed in single quotation marks. The format is A72 because the maximum length of an Information Builders error message is 72 characters.
Example: Retrieving an Error Message

FEXERR retrieves the error message whose number is contained in the &ERR variable, in this case 650. The result is returned to the variable &&MSGVAR and has the format A72. 

-SET &ERR = 650;
-SET &&MSGVAR = FEXERR(&ERR, 'A72');
-TYPE &&MSGVAR

The output is: 

(FOC650) THE DISK IS NOT ACCESSED
WebFOCUS