[Next Section] [Previous Section] [Table of Contents]

Full Equations Utilities (FEQUTL) Model for the Approximation of Hydraulic Characteristics of Open Channels and Control Structures During Unsteady Flow

U.S. GEOLOGICAL SURVEY WATER-RESOURCES INVESTIGATIONS REPORT 97-4037


APPENDIX 3:Full Equations Utilities Model Error Messages and Warnings: Version 4.0


Messages are issued to the user in three categories in FEQUTL computations. The first category consists of error messages describing some condition in the input that makes it impossible for the instructions entered by the user to be done in FEQUTL. In many cases of FEQUTL computations, the execution of the current command will stop, the input for the current command will be skipped, and execution of the following command will be attempted. Thus, each command in the input will be processed, but only those without detected errors will be completed. Therefore, the user must always check for detected errors before assuming that all the commands have been processed correctly.

The second category of messages consists of warning messages reporting conditions that might indicate a user error or which highlight the possibility of some later computational problem. Usually, when warnings are issued, some assumption is made in the FEQUTL computations to circumvent the problem and allow the computations to continue. The user should always check the warning messages to make sure that the default action taken in FEQUTL computations has not affected the results.

The third category of messages consists of bug messages reporting conditions that should not occur. Bug messages are usually indicative of some problem in the computer code and should not be seen often. However, conditions not yet tested may be present in an application and a bug may be revealed. The messages concerning bugs are not reported here. Users should contact Linsley, Kraeger, Associates in Mountain View, Calif., to resolve any problems with bug messages.

Some parts of the software in FEQUTL are taken from FEQ. The parts of FEQUTL that are taken from FEQ also contain the same error, warning, and bug messages as in FEQ. A message with a number less than 500 is from the FEQ software copied in FEQUTL and is described in the FEQ message summary given in appendix 4 of the FEQ documentation report (Franz and Melching, 1997). The description of the message may not refer directly to FEQUTL, but the nature of the error is the same. The principal operations copied from FEQ involve the storage of, and the look up from, function tables. Thus, errors of argument out of range or missing tables will be issued utilizing messages from FEQ. All messages with numbers greater than 500 are described here.

A message that is common in both FEQ and FEQUTL is error 500. It appears in both descriptions because it commonly occurs and is the boundary for the messages for the two codes. All messages given in FEQUTL are of the form *ERR:nn*, *WRN:mm*, or *BUG:kk* where nn, mm, and kk are the respective message numbers. Error messages in any other form originate from the computer operating system and not in FEQUTL.

*ERR:nn* MESSAGES
*WRN:nn*MESSAGES

[Next Section] [Previous Section] [Table of Contents]