$Fsterr: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
Line 32: Line 32:
<li>the [[IFGERR IFAM function]]
<li>the [[IFGERR IFAM function]]
<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.
<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</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 $FSTERR function returns a variable length string of up to 79 characters that contains the prefix and the first counting error message or request cancellation message you received since the last time that the count was reset to zero. $FSTERR returns a null value, if Model 204 has not received a counting error or request cancellation message since:

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

For more information about counting errors or request cancellation messages, refer to the Rocket Model 204 Messages Manual. To return the most recent error message, refer to the $ERRMSG function. $FSTERR is not available for Host Language Interface applications. The $FSTERR function takes no arguments.

The $FSTERR function requires an additional 88 bytes in the fixed portion of the server.

Example

An example of the $FSTERR function with an ON ERROR unit follows. For more information, refer to ON units.

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

See also