前のページ|次のページ

RENAME関数

SASライブラリのメンバ、SASカタログ内のエントリ、外部ファイル、ディレクトリのいずれかの名前を変更します。

カテゴリ: 外部ファイル
SASファイルI/O
制限事項: FILEEXIST関数を指定中のSASセッションがロックダウン状態で、その関数で指定されているパス名がロックダウンパスリストに追加されていない場合、その関数は失敗し、そのロックダウンデータに関連するファイルアクセスエラーは、SYSMSG関数を指定しない限り、SASログに生成されません。

構文

必須引数

old-name

SASライブラリのメンバ、SASカタログ内のエントリ、外部ファイル、外部ディレクトリのいずれかの現在の名前である文字定数、変数または式を指定します。

データセットの場合、old-nameは1レベルまたは2レベルの名前にできます。カタログエントリの場合、old-nameは1レベル、2レベルまたは4レベルの名前にできます。外部ファイルまたはディレクトリの場合、old-nameはファイルまたはディレクトリの完全パス名にする必要があります。old-nameの値を指定しない場合は、現在のディレクトリが使用されます。

new-name

ライブラリメンバ、カタログエントリ、外部ファイル、ディレクトリのいずれかの新しい1レベルの名前である文字定数、変数また式を指定します。

オプション引数

type

名前を変更する要素の種類を指定する文字定数、変数または式です。TypeはNULL文字列にするか、次のいずれかの値を使用できます。

ACCESS SAS/ACCESSソフトウェアで作成されたSAS/ACCESSディスクリプタを指定します。
CATALOG SASカタログまたはカタログエントリを指定します。
DATA SASデータセットを指定します。
VIEW SASデータセットビューを指定します。
FILE 外部ファイルまたはディレクトリを指定します。
デフォルト 'DATA'

description

カタログエントリの説明である文字定数、変数または式を指定します。descriptionは、typeの値がCATALOGである場合にのみ指定できます。DescriptionはNULL引数にできます。

password

名前を変更するデータセットのパスワードを指定する文字定数、変数または式です。PasswordはNULL引数にできます。

generation

名前を変更するデータセットの世代番号を指定する数値定数、変数または式です。GenerationはNULL引数にできます。

詳細

RENAME関数を使用して、SASライブラリのメンバまたはSASカタログ内のエントリの名前を変更できます。SASは操作が成功した場合は0、失敗した場合は0以外の値を返します。
カタログ内のエントリの名前を変更するには、old-nameの4レベルの名前を指定し、new-nameに1レベルの名前を指定します。カタログ内のエントリの名前を変更するには、typeにCATALOGを指定する必要があります。
動作環境の情報: RENAMEはディレクトリベースの動作環境でのみ使用します。メインフレーム動作環境でRENAMEを使用すると、エラーが生成されます。

例1: データセットとカタログエントリの名前の変更

次の例では、SASデータセットの名前をData1からData2に変更し、カタログエントリの名前をA.SCLからB.SCLに変更します。
rc1=rename('mylib.data1', 'data2');
rc2=rename('mylib.mycat.a.scl', 'b', 'catalog');

例2: 外部ファイルの名前変更

次の例では、外部ファイルの名前を変更します。
   /* Rename a file that is located in another directory. */
rc=rename('/local/u/testdir/first',
          '/local/u/second', 'file');
   /* Rename a PC file. */
rc=rename('d:\temp', 'd:\testfile', 'file');

例3: ディレクトリの名前変更

次の例では、UNIX動作環境のディレクトリの名前を変更します。
rc=rename('/local/u/testdir/', '/local/u/oldtestdir', 'file');

例4: 世代データセット名の変更

次の例では、世代データセットの名前をWork.OneからWork.Twoに変更します。Work.One#003のパスワードはmy-passwordです。
rc=rename('work.one', 'two',,, 3,'my-password');

関連項目:

前のページ|次のページ|ページの先頭へ