ESAVE: Save Machine Imperfections and read back from file

Writing errors to a file:
This command saves a table of errors assigned to elements on a file, using a format which can be read in again to obtain the same results. This allows dumping the errors and reloading them after a new USE command. The range for these elements has to be specified. An error save is requested by the statement

ESAVE,FILE=string;

Example: 

SELECT,FLAG=ERROR,RANGE=range,CLASS=name,PATTERN=string;
ESAVE,FILE=err.file;

and elements selected by the SELECT command are saved to the file.

To save the errors of all elements to a file, one can use:

SELECT,FLAG=ERROR,FULL;                                    
ESAVE,FILE=err.file;

Please note: in case of field errors, the absolute errors are saved and not relative errors.

Setting errors from a table or file:
To assign errors from a file is not a priori straightforward. It may be required to re-assign existing errors after a USE command was executed (which deletes all errors attached to a sequence).
Errors stored in the form of an internal table (errtab) can be directly attached to the appropriate positions in the sequence with the command:

SETERR,TABLE=errtab;

The table errtab can be generated internally or from an external file (errfile) with the generic command READMYTABLE.
The command sequence:

READMYTABLE,file=errfile,table=errtab;
SETERR,TABLE=errtab;

reads the file errfile into the table errtab and the command SETERR attaches the errors to the elements in the active sequence.
The file errfile can be produced by a preceding ESAVE command or any other utility. It should follow the format of a file generated with ESAVE (see example program).
Please note:
1. To assign correctly the errors from the file to the elements in the sequence, all elements must have individual names, otherwise an identification is not possible. Elements in the file not identified in the active sequence are ignored.
2. Errors are assigned to ALL elements found in the file and the FLAG=ERROR is set. Therefore the number of elements selected corresponding to a command like:
SELECT, FLAG=ERROR,...;
can be different after the execution of SETERR.

Werner Herr 18.6.2002