Error Processing

Overview

The EUS Toolkit provides a method for reporting errors and warnings to the user. The developer has the flexibility to either store error messages for display at a later time or to handle them immediately.

Message Processing

Using the _warn.utl utility, messages can be stacked in an orderly fashion and displayed later using the _saywarn.utl utility. Messages are maintained using a global string stack with the keyword (#Warn). Refer to the _warn.utl section for an example of this process.

The _saywarn.utl utility normally relies on the ("#Warn") global string stack to process and display messages. However, by passing it a MESSAGE$ value, the utility processes this message immediately, regardless of any values in the global string stack.

Unexpected Errors

_warn.utl and _saywarn.utl are used for situations the developer anticipates. Unexpected errors, such as a full disk, can be handled with _unerr.utl. This utility reports the error with a look and feel compatible with _saywarn.utl.