ReplaceSuperFile

STD.File.ReplaceSuperFile( superfile, subfile1 , subfile2 )

superfileA null-terminated string containing the logical name of the superfile.
subfile1A null-terminated string containing the logical name of the sub-file. This may be another superfile.
subfile2A 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()
);