Administering the Error List

This objective of providing a user-specified error list is to offer an error administration capability in the CATDUA V5 tool.

As a CATDUA V5 administrator, you can declare in an external file a specific list of errors to be processed. Once defined, the errors listed in the file are processed and if needed, you can also select or deselect these errors. For example, a CATDUA V5 administrator can restrict or permit any users to check/clean a certain error.

To do so, you must create an error administration file (in .txt format) in which you declare the list of errors which can be processed or excluded.

Then, you need to run the following command:

export the CATDUA_ERROR_LIST= path/File.txt

where "path" is the path of the file containing the list of authorized errors.

The CATDUA_ERROR_LIST variable is ignored if the error administration file:

  • does not exist or has no read access.
  • is empty.
  • does not contain any valid CATDUA V5 error code or contains an error code which cannot be executed in the current configuration/document type (PDM support). In this case, all errors available on the site and depending on the PDM configuration are available.
By default, the .txt file works as a NONE PLUS mechanism. That means that only the errors declared in the file are taken into account during the CATDUA V5 process. From V5R15 onwards, the file can also work in a AllBut mode.

To switch to this new mode, the first line of the .txt file must be AllBut. In that case, all errors declared on the site, except those defined in the .txt file are taken into account. This functionality allows you to keep the highest level of CATDUA V5, and excludes the list of errors you do not want to apply in your environment.

When upgrading to a upper V5 level, the list of available errors is enriched with the errors introduced in this upper level. Whereas in a standard mode (NONEPLUS), the list of errors processed is defined once and for all with the contents of the file, based on the errors integrated in the latest V5 version.
The syntax in the file must be a list of CATDUA V5 error codes (ERR_xx). Below is an example with a valid administration file with two different syntaxes:
 
File_NONEPLUS.txt (NONEPLUS mode) File_AllBut.txt (AllBut mode)
Only these three errors will be processed All but these three errors will be processed
  For an exhaustive list of the available error codes, refer to Table of Detected Return Codes.
The list of available errors takes into account the error administration file, if any. The Error Selection Options dialog box gives a quick view of the impact of this administration file by displaying the limited errors through a dedicated interface. You can thus easily validate your administration file.
When launching CATDUA V5, you are not informed that the CATDUA V5 reports give partial results, and that errors have been excluded from the process. The document is partially analyzed/cleaned.

Running a full CATDUA V5 may detect errors which were not detected during the partial replay.