Tivoli Header

Tivoli Storage Manager for NetWare Backup-Archive Client 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 and directories within a filelist:

   serverb\sys:/proj/dir/file1
   serverb\sys:/public/tivoli/file2
   serva\sys:/acctng/avi/dir1
   serva\sys:/books/dir2/file3
   "e\sys:/dir/Ha Ha Ha/file.txt"
   "e\sys:/messages/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:

dsmc restore -filelist=sys:u/projecta/files vol1:u/dir1/record/ -preservepath=complete

the file specification vol1:u/dir1/record/ represents the restore destination for all entries in the filelist. However, in the selective command:

dsmc selective -filelist=sys:u/projecta/files vol1:u/dir1/record/

the file specification vol1:u/dir1/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.

Note:
Tivoli Storage Manager may back up a directory twice if the following conditions exist: For example, your filelist includes the entries sys:proj/myfile and sys:proj. If the proj directory does not exist on the server, the sys:proj directory is sent to the server a second time.

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:
dsmc sel -filelist=serva\sys:avi/filelist.txt


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