Installation and User's Guide

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 quotation marks.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:c:\myfiles\directory\file1c:\tivoli\mydir\yourfile.doc..\notes\avi\dir1..\fs1\dir2\file3"d:\fs2\Ha Ha Ha\file.txt""d:\fs3\file.txt"You can use the filelist option during an open file support operation. In this case,Tivoli Storage Manager processes the entries in the filelist from the virtual volumeinstead of the real volume.If an entry in the filelist indicates a directory, only that directory is processed andnot 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, d:\dir\ represents the restore destination for all entries in the filelist.restore -filelist=c:\filelist.txt d:\dir\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.The entries in the list are processed in the order they appear in the filelist. Foroptimal processing performance, pre-sort the filelist by file space name and path.Note: Tivoli Storage Manager might back up a directory twice if the followingconditions exist:v The filelist contains an entry for the directoryv The filelist contains one or more entries for files within that directoryv No backup of the directory existsFor example, your filelist includes the entries c:\dir0\myfile and c:\dir0. Ifthe\dir0 directory does not exist on the server, the c:\dir0 directory is sent to theserver a second time.380 IBM Tivoli Storage Manager for Windows Backup-Archive Clients: Installation and User's Guide