FILERENAME
Usage
TIBCO iProcess Workspace (Browser)
TIBCO iProcess Workspace (Windows)
Rename a file.
Syntax
FILERENAME (source, dest)
where:
| • | source is a text string specifying the name of the file to be renamed (which must exist). |
| • | dest is a text string specifying the new filename (which will be overwritten of it already exists) as a simple filename or full pathname. |
The following environment variables may be used in a pathname:
| — | TEMP, the temporary directory on the iProcess Workspace client. |
| — | HOME, the user’s queue directory on the server, SWDIR\queues\username. |
Note: This directory is not created automatically. This means that before using this environment variable you should check that it exists, otherwise the function will fail.
Note: You may rename a file to be in another directory, provided that directory exists. If you rename it to be on a different physical device, it is first copied, then the original deleted.
Returns
One of the following numeric values:
|
Value |
Description |
|
1 |
Success |
|
-4 |
Failed to open either file. |
Examples
TIBCO iProcess Modeler:
This command renames a file in the current directory.
FILERENAME ("names.txt","names_old.txt")
TIBCO Business Studio:
IPEFileUtil.FILERENAME("name.txt","name_old.txt");