Difference between revisions of "SAVE ERROR"

From Recital Documentation Wiki
Jump to: navigation, search
Line 35: Line 35:
 
<code lang="recital">
 
<code lang="recital">
 
procedure errproc
 
procedure errproc
on error
+
  on error
lerrflag = .T.
+
  lerrflag = .T.
save error to errlog
+
  save error to errlog
 
return
 
return
  
Line 56: Line 56:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Error Handling and Debugging]]
 +
[[Category:Error Handling and Debugging Commands]]

Revision as of 16:11, 1 June 2009

Class

Error Handling and Debugging


Purpose

Save error.mem information to a specified file when an error occurs


Syntax

SAVE ERROR TO <mem filename>


See Also

ERRNO(), ERROR(), MESSAGE(), ON ERROR, PROCLINE(), PROCNAME(), SET ERRORVERSION


Description

The SAVE ERROR command saves the error.mem information to a specified file <mem filename> when an error occurs. This includes the following information:


  • Recital Software version, patch release and compilation date
  • Date and time file created
  • Machine and user names
  • Stack trace
  • Active public and private procedures and functions
  • Public and private memory variables
  • Active status of workareas
  • Settings as per DISPLAY STATUS


The SAVE ERROR command should be used in conjunction with the ON ERROR command. NOTE: multiple numbered error.mem files can be created automatically if SET ERRORVERSION is ON.


Example

procedure errproc
  on error
  lerrflag = .T.
  save error to errlog
return
 
// Attempt to open non-existent table
lerrflag = .F.
on error do errproc
use nontable
if not lerrflag
    // Continue processing
else
    dialog box "Error has occurred"
endif


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer