STD.File.ReplaceSuperFile( superName, oldSubFile, newSubFile )
| superName | A null-terminated string containing the logical name of the superfile. |
| oldSubFile | A null-terminated string containing the logical name of the sub-file. This may be another superfile. |
| newSubFile | 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()
);