![]() |
![]() |
Use the filelist option to process a list of files. 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. With the exception 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:
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 process 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.
Use file specifications with the restore and retrieve commands to denote the destination for the restored filelist entries. For example, in the restore command:
restore -filelist=/home/dir/file3 /usr/record
dsmc restore -filelist=sys:u/projecta/files vol1:u/dir1/record/ -preservepath=complete
the file specification /usr/record represents the restore destination for all entries in the filelist. However, in the selective command:
selective -filelist=/home/dir/file3 /usr/record
the file specification /usr/record is ignored.
If you specify a directory in a filelist for the delete archive command, the directory is not deleted. Filelists that you use with the delete archive command should not include directories.
The entries in the list will be processed in the order they appear in the filelist. For optimal processing performance, pre-sort the filelist by file space name and path.
Supported Clients
This option is valid for all UNIX clients.
Syntax
>>-FILEList- filelistspec--------------------------------------><
Parameters
Examples