IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive ...

vvvrestoreretrieveselectiveThe Tivoli Storage Manager client opens the file you specify with this option andprocesses the list of files within according to the specific command. With theexception of the restore and retrieve commands, when you use the filelist option,Tivoli Storage Manager ignores all other file specifications on the command line.The files (entries) listed in the filelist must adhere to the following rules:v Each entry must be a fully or partially qualified path to a file or directory or arelative path.v Each entry must be on a new line.v Do not use wildcard characters.v Each entry results in the processing of only one object (file or directory).v If the file name contains any spaces, enclose the file name with quotes.v The filelist can be an MBCS file or a Unicode file with all Unicode entries. ForMac OS X, the filelist can be encoded in the current operating system languageor UTF-16.v Tivoli Storage Manager ignores any entry that is not valid.The following is an example of a list of files within a filelist:/home/dir/file1/usr/tivoli/file2/usr/avi/dir1/fs1/dir2/file3"/fs2/Ha Ha Ha/file.txt""/fs3/file.txt"If an entry in the filelist indicates a directory, only that directory will be processedand not the files within the directory.If the file name (the filelistspec) you specify with the filelist option does notexist, the command fails. Tivoli Storage Manager skips any entries in the filelistthat are not valid files or directories. Tivoli Storage Manager logs errors andprocessing continues to the next entry.Use file specifications with the restore and retrieve commands to denote thedestination for the restored filelist entries. For example, in the following restorecommand, the file specification /user/record/ represents the restore destination forall entries in the filelist.restore -filelist=/home/dir/file3 /usr/record/However, in the following selective command, the file specification /usr/record/is ignored.selective -filelist=/home/dir/file3 /usr/record/However, in the following selective command, the file specification d:\dir\ isignored.selective -filelist=c:\filelist.txt d:\dir\If you specify a directory in a filelist for the delete archive or delete backupcommand, the directory is not deleted. Filelists that you use with the deletearchive or delete backup command should not include directories.Chapter 10. Using processing options 317