Use the filelist option to process a list of files.
You can use the filelist option with the following commands:
The Tivoli® Storage Manager client opens the file you specify with this option and processes the list of files within according to the specific command. Except for 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:
If a path contains one or more single quotation marks ('), enclose the entire entry in quotation marks ("). If a path contains one or more quotation marks, enclose the entire path in single quotation marks. File list processing does not support paths that include a mix of quotation marks and single quotation marks.
The following examples illustrate the correct and incorrect use of quotation marks and single quotation marks in paths.
"/home/gatzby/mydir/gatzby's_report.out"
This
path example contains quotation marks, so it must be enclosed in single
quotation marks:'/home/gatzby/mydir/"top10".out'
This
path example contains a space character, so it must be enclosed in
either quotation marks or single quotation marks: "/home/gatzby/mydir/top 10.out"
or '/home/gatzby/mydir/top 10.out'
/home/gatzby/mydir/andy's_"top 10" report.out
These
paths are not supported for filelist processing because they contain
wildcard characters:/home/gatzby*
/home/*/20??.txt
The following are examples of valid paths in a filelist:
/home/dir/file1
/usr/tivoli/file2
/usr/avi/dir1
/fs1/dir2/file3
"/fs2/Ha Ha Ha/file.txt"
"/fs3/file.txt"
c:\myfiles\directory\file1
c:\tivoli\mydir\yourfile.doc
..\notes\avi\dir1
..\fs1\dir2\file3
"d:\fs2\Ha Ha Ha\file.txt"
"d:\fs3\file.txt"
To override standard processing of quotation marks and wildcard characters, see Quotesareliteral and Wildcardsareliteral.
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 volume instead of the real volume.
If an entry in the filelist indicates a directory, only that directory is processed and not the files within the directory.
If the file name (the filelistspec) you specify with the filelist option does not exist, the command fails. Tivoli Storage Manager skips any entries in the filelist that are not valid files or directories. Tivoli Storage Manager logs errors and processing continues to the next entry.
restore -filelist=/home/dir/file3 /usr/record/
selective -filelist=/home/dir/file3 /usr/record/
restore -filelist=c:\filelist.txt d:\dir\
selective -filelist=c:\filelist.txt d:\dir\
If you specify a directory in a filelist for the delete archive or delete backup command, the directory is not deleted. filelists that you use with the delete archive or delete backup command should not include directories.
The entries in the list are processed in the order they appear in the filelist. For optimal processing performance, pre-sort the filelist by file space name and path.
For example, your filelist includes the entries /home/dir/file1 and /home/dir. If the /dir directory does not exist on the server, the /home/dir directory is sent to the server a second time.
For example, your filelist includes the entries c:\dir0\myfile and c:\dir0. If the \dir0 directory does not exist on the server, the c:\dir0 directory is sent to the server a second time.
This option is valid for all clients. The Tivoli Storage Manager client API does not support this option.