Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Filelist

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.

Note:
The Tivoli Storage Manager Client API does not support this option.

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:

   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"

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=c:\filelist.txt d:\dir\
dsmc restore -filelist=sys:u/projecta/files vol1:u/dir1/record/ -preservepath=complete

the file specification d:\dir represents the restore destination for all entries in the filelist. However, in the selective command:

selective -filelist=c:\filelist.txt d:\dir

the file specification d:\dir 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.

Note:
Tivoli Storage Manager may back up a directory twice if the following conditions exist: 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.

Supported Clients

This option is valid for all Windows clients.

Syntax

>>-FILEList- filelistspec--------------------------------------><
 
 

Parameters

filelistspec
Specifies the location and name of the file that contains the list of files to process with the command.
Note:
When you specify the filelist option on the command line, you cannot use the subdir option.

Examples

Command line:
sel -filelist=c:\avi\filelist.txt


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]