16.3.9 FC/SFC 214 - FILE_REN - Rename file
Using FILE_REN you may alter the file name defined in OLDNAME to the file name that
you type in NEWNAME.
CAUTION!
Please regard that you may only rename files that you've closed before
with FILE_CLO. Nonobservance may cause data loss at the memory
card!
Parameters
Parameter Declaration Data type Description
REQ IN BOOL Activate function
MEDIA IN INT 0 = MMC
OLDNAME IN STRING[254] Old name of file (must be in 8.3 format)
NEWNAME IN STRING[254] New name of file (must be in 8.3 format)
RETVAL OUT WORD Return value (0 = OK)
BUSY OUT BOOL Function is busy.
Codes that are returned by RETVAL:
Code Description
0000h OK, file has been renamed
7000h REQ = 0, BUSY = 0 (nothing present)
7001h REQ = 1, 1. call
7002h Block is executed
8010h Parameter OLDNAME is not present (e.g. DB not loaded)
8011h Error OLDNAME
(not conform with 8.3 format or special character)
8020h Parameter NEWNAME is not present (e.g. DB not loaded)
Description
RETVAL (Return value)
VIPA SPEED7
System Blocks
File Functions SPEED7 CPUs > FC/SFC 214 - FILE_REN - Rename file
HB00 | OPL_SP7 | Operation list | en | 18-30 919