$ErrMsg

The $ERRMSG function returns a variable length string of up to 79 characters containing the prefix and text of the last counting error message or request cancellation message received by the user.

A null value is returned if no counting error or request cancellation message has been received since:

• The beginning of the user's Model 204 session
• The last call to the $ERRCLR function.
• Processing a User Language OPEN statement

Refer to the Rocket Model 204 Messages Manual for more information on counting messages. This function takes no arguments.

Example

A sample $ERRMSG function with an ON ERROR unit follows. To learn about ON ERROR units, see ON units.

BEGIN ERROR.PROC: ON ERROR PRINT 'THE REQUEST IS ENDING' PRINT 'THE LAST ERROR MESSAGE RECEIVED WAS:' PRINT $ERRMSG END ON GET.RECS: FIND ALL RECORDS FOR WHICH AGENT = CASOLA END FIND FOR EACH RECORD IN GET.RECS . . . END FOR END

See also

• the IFGERR IFAM function
• $FSTERR, which returns the first counting error message.
• The ERRMSGL parameter, which determines the length of errors returned by $ERRMSG and $FSTERR.