Functions and CALL Routines |
Category: | SAS File I/O |
Syntax | |
Details | |
Examples |
Syntax |
IORCMSG() |
Details |
If the IORCMSG function returns a value to a variable that has not yet been assigned a length, then by default the variable is assigned a length of 200.
The IORCMSG function returns the formatted error message that is associated with the current value of the automatic variable _IORC_. The _IORC_ variable is created when you use the MODIFY statement, or when you use the SET statement with the KEY= option. The value of the _IORC_ variable is internal and is meant to be read in conjunction with the SYSRC autocall macro. If you try to set _IORC_ to a specific value, you might get unexpected results.
Examples |
In the following program, observations are either rewritten or added to the updated master file that contains bank accounts and current bank balance. The program queries the _IORC_ variable and returns a formatted error message if the _IORC_ value is unexpected.
libname bank 'SAS-library'; data bank.master(index=(AccountNum)); infile 'external-file-1'; format balance dollar8.; input @ 1 AccountNum $ 1-3 @ 5 balance 5-9; run; data bank.trans(index=(AccountNum)); infile 'external-file-2'; format deposit dollar8.; input @ 1 AccountNum $ 1-3 @ 5 deposit 5-9; run; data bank.master; set bank.trans; modify bank.master key=AccountNum; if (_IORC_ EQ %sysrc(_SOK)) then do; balance=balance+deposit; replace; end; else if (_IORC_ = %sysrc(_DSENOM)) then do; balance=deposit; output; _error_=0; end; else do; errmsg=IORCMSG(); put 'Unknown error condition:' errmsg; end; run;
Copyright © 2011 by SAS Institute Inc., Cary, NC, USA. All rights reserved.