RENAME
RENAMEコマンドを使用して、指定したローカル・ファイルの名前を新しい名前に変更できます。
TO値に指定したファイルは、FROM値に指定したファイルと同じディレクトリ内になければなりません。
必須
RENAME ------- FROM ---------ファイル・パス------------------------->
>-- TO -----------ファイル・パス------------------------->
任意
>-- REPLACE ------ *NO -------------------------------|
*YES
キーワード
FROM |
このキーワードは、名前変更するファイルの名前とパスを指定します。 パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。 パスの形式は以下のようにします。 Windowsの場合、以下のように指定できます。 · 絶対パス · 相対パス IBM i の場合、以下のように指定できます。 · 絶対パス · 相対パス このキーワードは必須です。 |
TO |
このキーワードは、変更後のファイルの名前とパスを指定します。パスは、FROMキーワードに指定したものと同じにします。 パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。 パスの形式は以下のようにします。 Windowsの場合、以下のように指定できます。 · 絶対パス · 相対パス IBM i の場合、以下のように指定できます。 · 絶対パス · 相対パス このキーワードは必須です。 |
REPLACE |
このキーワードは、TOキーワードに指定した名前と同じ名前の既存ファイルを上書きするかどうかを指定する場合に使用されます。 以下の2つの値が可能です。 · *YES - この値を指定すると、指定したディレクトリ内の同じ名前の既存ファイルが上書きされます。 · *NO - この値を設定すると、ディレクトリに同じ名前のファイルがすでにある場合は例外が発生します。この例外を取得すると、ユーザーにその例外を報告できます。 · 省略値は*NOです。 · このキーワードは任意です。 |
コメント/警告
ファイルを別のディレクトリに配置する場合、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 XML
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 XML
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)