Chapter Contents

ERROR

ERROR

Sets _ERROR_ to 1 and, optionally, writes a message to the SAS log

Valid: in a DATA step

Category: Action

Type: Executable

Syntax
Without Arguments
Arguments
Details
Examples
See Also

Syntax

ERROR <message>;

Without Arguments

Using ERROR without an argument sets the automatic variable _ERROR_ to 1 without printing any message in the log.

writes a message to the log.

Tip:

Message can include character literals (enclosed in quotation marks), variable names, formats, and pointer controls.

The ERROR statement sets the automatic variable _ERROR_ to 1 and, optionally, writes a message that you specify to the SAS log. When _ERROR_ = 1, SAS writes the data lines that correspond to the current observation in the SAS log.

Using ERROR is equivalent to using these statements in combination:

an assignment statement setting _ERROR_ to 1
a FILE LOG statement
a PUT statement (if you specify a message)
another FILE statement resetting FILE to any previously specified setting.

In the following examples, SAS writes the error message and the variable name and value to the log for each observation that satisfies the condition in the IF-THEN statement.

In this example, the ERROR statement automatically resets the FILE statement specification to the previously specified setting.
```
file file-specification;
   if type='teen' & age > 19 then
      error 'type and age don"t match ' age=;
```

This example uses a series of statements to produce the same results.

file file-specification;
   if type='teen' & age > 19 then
      do;
         file log;
         put 'type and age don"t match ' age=;
         _error_=1;
         file file-specification;
      end;

See Also

Statement:

PUT

Chapter Contents
Previous
Next
Top of Page

Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.