Enable8dot3namesupport

The enable8dot3namesupport option specifies whether the client backs up and restores short 8.3 names for files that have long names on NTFS file systems.

Supported Clients

This option is valid for all Windows clients.

A file with a long file name might not have a short 8.3 name if short name generation is disabled on the Windows system. This option is effective only for NTFS file systems.

Options File

Place this option in the client options file (dsm.opt). You can set this option on the General tab of the Preferences editor.

Syntax


                           .-No--.   
>>-ENABLE8DOT3NAMESupport--+-----+-----------------------------><
                           '-Yes-'

Parameters

No: Short 8.3 names for files with long file names are not backed up or restored. This is the default.
Yes: Short 8.3 names for files with long file names are backed up and restored.
Each short name uses up to 14 additional bytes in the server database. Although this is a small number, if there are many files with short 8.3 names on many Windows systems, this can increase the size of the Tivoli® Storage Manager server database.

Important: Consult with your Tivoli Storage Manager server administrator before you use this option.

The first backup that runs with this option causes all files that have short 8.3 names to be updated on the Tivoli Storage Manager server, even if the files have not otherwise changed. This is because the client is adding the short 8.3 names to the active backup versions.

If this option is enabled for restore, the client attempts to set the short 8.3 name for restored files, even if short name generation is disabled on the Windows system. The client must run under a Windows account that possesses the SE_RESTORE_NAME privilege in order for this option to be effective. See your system administrator if you have questions about account privileges.

During restore, the short 8.3 name of a file is not restored if another object in the same directory already has the same short 8.3 name. In this case, the file is restored and an informational message is logged indicating that the short name could not be set. If the file must be restored with its original short name, you must resolve the conflict with the existing file, and then try the restore again.

Important: This parameter can cause unexpected results in some cases. For example, if the short name of a file changes between the last time the file was backed up and the time it is restored, and there is a link or registry entry that refers to the newer short name, then restoring the file with the older short name invalidates the references to the newer short name.

Examples

Options file:: enable8dot3namesupport yes
Command line:: -enable8dot3namesupport=yes