Renames one or more SAS files in the same SAS data
- changes the name of a SAS file in the input data library.
old-name must be the name of an existing SAS file in the input
- provides the alter password for any alter-protected SAS
files named in the CHANGE statement. Because a CHANGE statement changes the
names of SAS files, you need alter access to use the CHANGE statement. You
can use the ALTER= option in parentheses after new-name or after
a forward slash.
- restricts processing to a single generation file or to the
entire generation group. Valid values for GENNUM= are
- refers to the base name and all generation files of a generation
- postive integer
- refers to an explicit generation file.
- negative integer
- refers to a relative generation file.
The following statements change the name of A(GENNUM=3) to B:
change A=B / gennum=3;
The following CHANGE statement produces an error:
- restricts processing to one member type (mtype).
- The CHANGE statement changes names by the order that the old-names occur in the directory listing, not
in the order that you
list the changes in the CHANGE statement.
- If the old-name SAS file does not exist in the SAS
data library, PROC DATASETS stops processing the RUN group containing the
CHANGE statement and issues an error message. To override this behavior,
use the NOWARN option in the PROC DATASETS statement.
- If you change the name of a data set that has an index, the index
continues to correspond to the data set.
- The CHANGE statement can reference only a specific generation
file or the entire generation group. Therefore, you cannot use HIST or REVERT
with the GENNUM= option.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.