Re-create stub files by using the dsmmigundelete command

The dsmmigundelete command uses the migrated files on the Tivoli® Storage Manager server to re-create stub files.

If your stub files are erased or corrupted, you can use the dsmmigundelete command to re-create stub files for all eligible migrated files.

Note:

You cannot use the dsmmigundelete command to re-create stub files for individual files or specific groups of files.
You can create stub files for any premigrated files for which an original file does not exist on your local file system.
If backup versions of your stub files are available on the Tivoli Storage Manager server, use the backup-archive client to restore your stub files.
The dsmmigundelete command does not support hard linked files. To re-create a stub file for a hard linked file, all files that are hard linked together must be deleted from your local file system. When one file in a set of hard linked files is migrated, all of the hard linked files in the set become stub files. When the dsmmigundelete command re-creates a stub file for a hard linked file, the stub file has the same name as the file that was originally migrated. Stub files are not re-created for any other files that were previously in the hard linked set of files.

The dsmmigundelete command has the following limitations:

The dsmmigundelete command creates a stub file that contains the necessary information to recall the corresponding file from storage. The stub file does not contain any leading bytes of data from the file.
The recall mode that you previously set for a migrated file is not stored in a re-created stub file. The recall mode for the file is set to normal.
The space management client does not create a stub file if a directory path does not exist in your local file system for a migrated file.
The space management client creates a stub file with the name of the file at the time it was migrated. If you rename a file after it is migrated, the file name is not updated on the server.
If you have more than one migrated file in storage with the same name that is marked for expiration, the space management client creates a stub file again for the file with the most recent modification time (mtime).
The space management client creates a stub file only if the modification time for the migrated file is newer than file on your local file system. If a file is renamed after it is migrated, the space management client creates a stub file regardless of the modification time.
If you move files after they are migrated or premigrated and then the files are backed up, you can use the dsmmigundelete command to re-create stub files. The stub files are created at the location to which the files were moved.

The dsmmigundelete command re-creates a stub file for a migrated file or creates a stub file for a premigrated file even in the following situations:

The file was never backed up.
The migrated or premigrated file is on a different server other than the server that contains the backup copies of the file.
The file was migrated or premigrated after the last incremental backup.

Issue the dsmmigundelete command without the expiring option if reconciliation was not run since the files were deleted. The space management client completes the following action for the file system that you specify:

Table 1. dsmmigundelete command actions without the expiring option
File	Description
Migrated files	Re-creates a stub file for a migrated file if a corresponding stub file does not exist on your local file system, and the migrated file was not marked for expiration. The migrated file is unexpired at the server after the dsmmigundelete command is finished.
Premigrated files	Creates a stub file for a premigrated file if a corresponding original file does not exist on your local file system, and the premigrated file was not marked for expiration. The premigrated file is unexpired at the server after the dsmmigundelete command is finished.

If you issue the dsmmigundelete command with the expiring option, the space management client completes the following action for the file system that you specify:

Table 2. dsmmigundelete command actions with the expiring option
File	Description
Migrated files	Re-creates a stub file for a migrated file if a corresponding stub file does not exist on your local file system. The stub is created whether the migrated file was marked for expiration or not.
Premigrated files	Creates a stub file for a premigrated file if a corresponding original file does not exist on your local file system. The stub is created whether the premigrated file was marked for expiration or not.