STD.File.ReplaceSuperFile( superfile, subfile1 , subfile2 )
| superfile | A null-terminated string containing the logical name of the superfile. |
| subfile1 | A null-terminated string containing the logical name of the sub-file. This may be another superfile. |
| subfile2 | A null-terminated string containing the logical name of the sub-file. This may be another superfile. |
| Return: | Null. |
The ReplaceSuperFile function removes the subfile1 from the list of files comprising the superfile and replaces it with subfile2.
This function may be included in a superfile transaction.
Example:
SEQUENTIAL(
STD.File.StartSuperFileTransaction(),
STD.File.ReplaceSuperFile('MySuperFile',
'MyOldSubFile',
'MyNewSubFile'),
STD.File.FinishSuperFileTransaction()
);