RENAME

LANSA Integrator

RENAME


RENAMEコマンドを使用して、指定したローカル・ファイルの名前を新しい名前に変更できます。

TO値に指定したファイルは、FROM値に指定したファイルと同じディレクトリ内になければなりません。

                                                           必須

 RENAME ------- FROM ---------ファイル・パス------------------------->

            >-- TO -----------ファイル・パス------------------------->

                                                           任意

            >-- REPLACE ------ *NO -------------------------------|

                               *YES

キーワード

FROM

このキーワードは、名前変更するファイルの名前とパスを指定します。

パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。

パスの形式は以下のようにします。

Windowsの場合、以下のように指定できます。

·         絶対パス
例:
/orders/order.xml
C:/orders/order.xml
C:\orders\order.xml

または

·         相対パス
orders/order.xmlなど(先頭が「/」にならないように注意)。この場合、order.xmlドキュメントは、サーバー上のJSMインスタンス・ディレクトリのordersディレクトリにあるファイルになります。

IBM i の場合、以下のように指定できます。

·         絶対パス
例:
/orders/order.xml

または

·         相対パス
orders/order.xmlなど(先頭が「/」にならないように注意)。この場合、order.xmlドキュメントは、サーバー上のJSMインスタンス・ディレクトリのordersディレクトリにあるファイルになります。

このキーワードは必須です。

TO

このキーワードは、変更後のファイルの名前とパスを指定します。パスは、FROMキーワードに指定したものと同じにします。

パスの区切り文字にはフォワード・スラッシュを使用し、DOSドライブ指定子を使用しないことをお勧めします。

パスの形式は以下のようにします。

Windowsの場合、以下のように指定できます。

·         絶対パス
例:
/orders/order2.xml
C:/orders/order2.xml
C:\orders\order2.xml

または

·         相対パス
orders/order2.xmlなど(先頭が「/」にならないように注意)。この場合、order2.xmlドキュメントは、サーバー上のJSMインスタンス・ディレクトリのordersディレクトリに配置されます。

IBM i の場合、以下のように指定できます。

·         絶対パス
例:
/orders/order2.xml

または

·         相対パス
orders/order2.xmlなど(先頭が「/」にならないように注意)。この場合、order2.xmlドキュメントは、サーバー上のJSMインスタンス・ディレクトリのordersディレクトリに配置されます。

このキーワードは必須です。

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)