RENAMEコマンドを使用して、指定したローカル・ファイルの名前を新しい名前に変更できます。
TO値に指定したファイルは、FROM値に指定したファイルと同じディレクトリ内になければなりません。
必須
RENAME ------- FROM ---------ファイル・パス------------------------->
>-- TO -----------ファイル・パス------------------------->
任意
>-- REPLACE ------ *NO -----------------------------------|
*YES
キーワード
FROM |
このキーワードは、名前変更するファイルの名前とパスを指定します。 パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。 パスの形式は以下のようにします。 Windowsの場合、以下のように指定できます。
IBM i の場合、以下のように指定できます。
このキーワードは必須です。 |
TO |
このキーワードは、変更後のファイルの名前とパスを指定します。パスは、FROMキーワードに指定したものと同じにします。 パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。 パスの形式は以下のようにします。 Windowsの場合、以下のように指定できます。
IBM i の場合、以下のように指定できます。
このキーワードは必須です。 |
REPLACE |
このキーワードは、TOキーワードに指定した名前と同じ名前の既存ファイルを上書きするかどうかを指定する場合に使用されます。 以下の2つの値が可能です。
|
コメント/警告
ファイルを別のディレクトリに配置する場合、READコマンドでARCHIVEキーワードを使用することを検討します。このキーワードは、現在読み込み中のファイルを移動し、そのファイルに名前を付けて(どのような名前でも可)新しい指定のディレクトリに配置します。
例
RDML
* Define JSM fields
DEFINE FIELD(#JSMSTS) TYPE(*CHAR) LENGTH(020)
DEFINE FIELD(#JSMMSG) TYPE(*CHAR) LENGTH(256)
DEFINE FIELD(#JSMCMD) TYPE(*CHAR) LENGTH(256)
* Rename
CHANGE FIELD(#JSMCMD) TO('''RENAME FROM(/orders/test.xml) TO(/orders/rename.xml) REPLACE(*YES)''')
USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG)
RDMLX
* Define the fields used by the JSM Commands
Define Field(#JSMSTS) Type(*CHAR) Length(020)
Define Field(#JSMMSG) Type(*CHAR) Length(256)
Define Field(#JSMCMD) Type(*CHAR) Length(256)
Define Field(#JSMHND) Type(*CHAR) Length(4)
* Rename
Change Field(#JSMCMD) To('''RENAME FROM(/orders/test.xml) TO(/orders/rename.xml) REPLACE(*YES)''')
Use Builtin(JSMX_COMMAND) With_Args(#JSMCMD) To_Get(#JSMSTS #JSMMSG #JSMHND)