IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive ...

use this Preview command to make sure that you include and exclude the correctfiles. The following is a sample scenario for using the include-exclude previewfunction.Assume that you want to back up the files on your /Users/home file space. Youbring up the Tivoli Storage Manager Client Java GUI and open the Backup tree.You can see all of the directories and files that have been excluded by your optionsfile and other sources. You scroll down the tree and notice that all of the *.o filesin your /Volumes/home/mary/myobjdir will be backed up. You don’t want to backup these files, so you right click on a .o file, and choose ″View File Details″ fromthe popup menu. The dialog shows that these files are included. Click on the″Advanced″ button and create a rule to exclude all .o files from the /home filespace. A rule is created at the bottom of your options file. The current directory isrefreshed in the Backup tree, and the .o files have the red ’X’, meaning they areexcluded. When you look at other directories, they show the new excludes thatyou have added. Press ″Backup″ and back up the files on your /home file space.See “Preview” on page 439 for more information about the Preview command.Processing include and exclude optionsThe Tivoli Storage Manager server can define include-exclude options using theinclexcl parameter in a client option set. The include-exclude statements specifiedby the server are evaluated along with those in the dsm.sys file. The serverinclude-exclude statements are always enforced and placed at the bottom of theinclude-exclude list and evaluated before the client include-exclude statements.If the dsm.sys file include-exclude list contains one or more inclexcl options thatspecify include-exclude files, the include-exclude statements in these files areplaced in the list position occupied by the inclexcl option and processedaccordingly.When performing an incremental backup, Tivoli Storage Manager evaluates allexclude.fs and exclude.dir statements first, and removes the excluded file spaces,directories, and files from the list of objects available for processing. See“Excluding file spaces and directories” on page 60 and “Exclude options” on page246 for more information about the exclude.fs and exclude.dir options.After evaluating all exclude.fs and exclude.dir statements, Tivoli Storage Managerevaluates the include-exclude statements for controlling symbolic link processing(exclude.attribute.symlink and include.attribute.symlink) from the bottom up andstops if it finds an include or exclude statement that matches the file it isprocessing. After the include-exclude statements for controlling symbolic linkprocessing are processed, Tivoli Storage Manager evaluates the remaininginclude-exclude list from the bottom up and stops when it finds an include orexclude statement that matches the file it is processing. The order in which theinclude and exclude options are entered therefore affects which files are includedand excluded. See Chapter 9, “Using processing options,” on page 169 for moreinformation about the order in which all options are processed.To display a list of all include-exclude statements in effect on your clientworkstation in the actual order they are processed, use the query inclexclcommand. See “Query Inclexcl” on page 455 for more information.The client program processes the list of include-exclude statements according tothe following rules:Chapter 2. Configuring Tivoli Storage Manager 65