ERROR - print an error message, then exit.

Alternate Entry Name: .ERROR

Usage:

B:
   error([format, arg1, arg2, ... ]);
/* C users use the C "error" */

Description:

The "format" string and other arguments are passed to PRINTF to create an error message. In TSS, this message is typed on the terminal. In batch, the message is written to file code P* and to the execution report. After outputting the message, ERROR calls EXIT with an argument of -1 so that EXIT will set switch bits 18-26 on. In TSS, ERROR also arranges that the program executes a DRL T.ERR. If ERROR is called with no arguments, no message will be printed.

ERROR is used to output diagnostics for "run of the mill" user errors such as bad data. For unusual "should not happen" errors, it is customary to use .ABORT.

See Also:

expl b lib .abort

expl b lib .warn

expl b lib printf

Copyright © 1996, Thinkage Ltd.