Chapter Contents

Previous

Next

ERROR

Valid:	in a DATA step
Category:	Action
Type:	Executable

Without Arguments

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

Arguments

message

writes a message to the log.

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

Details

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.

Examples

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;

Statement: PUT

Chapter Contents

Previous

Next

Top of Page

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