Installation and User's Guide

If the client options file include-exclude list contains one or more inclexcl optionsthat specify include-exclude files, the include-exclude statements in these files areplaced in the list position occupied by the inclexcl option and processedaccordingly.A very large include-exclude list can decrease backup performance. Use wildcardsand eliminate unnecessary include statements to keep the list as short as possible.When performing an incremental backup, Tivoli Storage Manager evaluates allexclude.dir statements first, and removes the excluded directories and files fromthe list of objects available for processing.After evaluating all exclude.dir statements, Tivoli Storage Manager evaluates theinclude-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.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.The client program processes the list of include-exclude statements according tothe following rules:1. Files are checked; directories are only checked if the exclude.dir option isspecified.2. File names are compared to the patterns in the include-exclude list from thebottom up. When a match is found, the processing stops and checks whetherthe option is include or exclude. If the option is include, the file is backed up. Ifthe option is exclude, the file is not backed up.Note:3. If a match is not found, files are implicitly included and backed up.4. When a file is backed up, it is bound to the default management class unless itmatched an include statement that specified a different management classname, in which case the file is bound to that management class.The following examples demonstrate bottom up processing.Example 1Assume that you defined the following statements for the include andexclude options:exclude ?:\*.objinclude c:\foo\...\*.objexclude c:\foo\junk\*.objThe file being processed is: c:\foo\dev\test.obj. Processing follows thesesteps:1. Rule 3 (the last statement defined) is checked first because of bottom-upprocessing. The pattern c:\foo\junk\*.obj does not match the filename that is being processed.2. Processing moves to Rule 2 and checks. This time, patternc:\foo\...\*.obj matches the file name that is being processed.Processing stops, the option is checked, and it is included.3. File c:\foo\dev\test.obj is backed up.Chapter 2. Configure the Tivoli Storage Manager client 77