$ErrMsg: Difference between revisions
No edit summary |
|||
| Line 32: | Line 32: | ||
<li>the [[IFGERR IFAM function]] | <li>the [[IFGERR IFAM function]] | ||
<li><var>[[$FSTERR]]</var>, which returns the <b>first</b> counting error message. | <li><var>[[$FSTERR]]</var>, which returns the <b>first</b> counting error message. | ||
<li>The [[ERRMSGL parameter]], which determines the length of errors returned by <var>[[$ERRMSG]]</var> and <var>[[$FSTERR]]</var>. | |||
</ul> | </ul> | ||
[[Category:SOUL $functions]] | [[Category:SOUL $functions]] | ||
Revision as of 23:29, 25 April 2014
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.