FUNCTION_BLOCK Rename EXTENDS CBM.ETrig
This function block modifies the file name and is optional for the different targets.
Contrary to the original CAA specification the file may be renamed even if it is opened via ”FILE.Open”.
This behavior is dependent of the underlying operating system and file system.
Whether this function block is implemented or not is explicitly stated and encoded in the return value of the function ”FILE.GetProperty”.
The function block cannot be used to move directories!
|
InOut:
|
|
Scope
|
Name
|
Type
|
Comment
|
Inherited from
|
|
Input
|
xExecute
|
BOOL
|
Rising edge: Action starts
Falling edge: Resets outputs
If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError) are present at the outputs for exactly one cycle.
|
ETrig
|
|
Output
|
xDone
|
BOOL
|
TRUE: Action successfully completed
|
ETrig
|
|
xBusy
|
BOOL
|
TRUE: Function block active
|
ETrig
|
|
xError
|
BOOL
|
TRUE: Error occurred, function block aborts action
FALSE: No error
|
ETrig
|
|
Input
|
sFileNameOld
|
CAA.FILENAME
|
Old file name
|
|
|
sFileNameNew
|
CAA.FILENAME
|
New file name
|
|
|
Output
|
eError
|
ERROR
|
Local library error ID (0: no error; 5101: time out)
|
|
|