FairCom Database Restore Guide

!CONVERT_PATHSEP

The dynamic dump restore script option !CONVERT_PATHSEP instructs ctrdmp to convert path separators to the native path separator. ctrdmp applies this conversion to:

• filenames read from the dump stream file,
• filenames read from the transaction logs that are included in the dynamic dump, and
• data and index filenames in the IFIL resources of all data files restored by ctrdmp.

If the file name begins with a drive letter (for example, C: or a UNC reference (for example, \\machinename\sharename), it is not changed. In these cases, we recommend using the !REDIRECT option in the dynamic dump restore script to replace these references with the desired target directory names.

The dynamic dump restore script option !REDIRECT_IFIL instructs ctrdmp to apply the !REDIRECT rules that are specified in the dump restore script to the data and index filenames in the IFIL resources of the data files restored by ctrdmp.

Note: An alternative to the !REDIRECT_IFIL option is to run the ctredirect utility after ctrdmp completes.

Example 1

As an example, consider a backup made on a Windows system of the data and index files accounts.dat and accounts.idx that are stored in the directory E:\mydata. In this example, the data file name in the IFIL resource is E:\mydata\accounts.

!DUMP backup.fcd

!FILES

E:\mydata\accounts.*

!END

Example 2

Here, a dynamic dump restore script to run on a Unix system that uses a !REDIRECT option to redirect E:\mydata to myrestoredir which is a subdirectory in the directory where ctrdmp is being run, and that uses the !REDIRECT_IFIL option to update the IFIL resource in accounts.dat based on the redirect rule.

!DUMP backup.fcd

!REDIRECT E:\mydata myrestoredir

!REDIRECT_IFIL

!CONVERT_PATHSEP

!FILES

E:\mydata\accounts.*

!END

In this example, accounts.dat and accounts.idx are restored to the myrestoredir directory, and then the data file name E:\mydata\accounts in accounts.dat is changed to myrestoredir/accounts. If the !REDIRECT_IFIL option had not been used, only the path separators would have been changed, so the data file name in the IFIL resource would have been changed to E:/mydata/accounts.

Limitations

The byte ordering of the two systems must still be the same in order for ctrdmp to be able to restore the dump.

See Also

!REDIRECT_IFIL