$ErrMsg

From m204wiki
Revision as of 23:01, 26 April 2014 by Dme (talk | contribs) (→‎See also)
Jump to navigation Jump to search

The $ErrMsg function returns a string 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 SOUL 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

The maximum length of the returned string is determined by the setting of the ERRMSGL parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but ERRMSGL can be set as high as 256 which means up to 255 characters would be returned.

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.