You can create an include-exclude list to exclude a specific file or groups of files from backup services, and to assign specific management classes to files. TSM backs up any file that is not explicitly excluded. TSM client directories should be excluded from backup services.
To create an include-exclude list, you can use the TSM preference editor as follows:
You can also create an include-exclude list by selecting Utilities> Setup Wizard from the TSM GUI.
You can also create an include-exclude list, by performing the following steps:
Table 6 provides brief descriptions of the include and
exclude options that you can specify in your client options
file. See table references for more information about each
option.
Table 6. Include-Exclude Options
Option | Description | Page |
---|---|---|
exclude | Excludes a file or group of files from backup services. Any file in your client domain that is not specifically excluded with this option is considered for backup. | Exclude Options |
exclude.archive | Excludes a file or group of files from archive services. | Exclude Options |
exclude.backup | Excludes a file or a group of files from backup services only. | Exclude Options |
exclude.dir | Locates matching directory names. If a matching directory is found, that directory, its files, and all its subdirectories and their files are excluded from backup services. | Exclude Options |
exclude.file | Excludes files, but not directories, that match a pattern. | Exclude Options |
exclude.file.backup | Excludes a file from normal backup services. | Exclude Options |
include | Includes files or management classes for backup or archive processing. | Include Options |
include.file | Includes a file for backup services, or assigns a management class to a file. | Include Options |
We recommend that you have the following minimum include-exclude list in your client options file:
exclude ?:\...\*.swp exclude ?:\...\win386.swp exclude c:\ibmbio.com exclude ?:\ibmdos.com exclude ?:\msdos.sys exclude ?:\msdos.com exclude ?:\msbio.com exclude ?:\...\386spart.par exclude ?:\...\*.par exclude ?:\...\dblspace.*
These are system files that cannot be recovered without possibly corrupting the operating system. If you are using a disk compression program, you might want to exclude the dblspace.* files. It is not necessary to back up these hidden files because TSM backs them up in the file spaces that these programs use. If you do back up these large files, your communication session might time out before TSM sends the files. Consult your disk compression documentation for the file names, or enter the following command to look for hidden files:
dir /a:h
To specify groups of files that you want to include or exclude, use the
wildcard characters listed in Table 7. This table applies to include and
exclude statements only. For information about
using wildcard characters in TSM commands, see "Using Wildcard Characters".
Table 7. Wildcard and Other Special Characters
Character | Function |
---|---|
? | The match-one character matches any single character except
the directory separator; it does not match the end of the string.
You cannot use the match-all character (or any wildcard character) when
specifying the high-level qualifier of an object, only use it for the
low-level qualifier. . For example:
|
* | The match-all character. You cannot use the match-all character
(or any wildcard character) when specifying the high-level qualifier of an
object, only use it for the low-level qualifier. For example:
|
\... | The match-n character matches zero or more directories. |
\ |
The directory separator character limits the scope of the search for the matching n characters and directories. If a pattern does not begin with a directory separator (or one does not follow the drive specification), a match all directories is appended to the pattern. For example, these patterns are equivalent: c:* c:\...\* |
[ | The open character-class character begins the enumeration of a character
class. For example:
xxx[abc] matches xxxa, xxxb, or xxxc. |
- | The character-class range includes characters from the first character to
the last character specified. For example:
xxx[a-z] matches xxxa, xxxb, xxxc, ... xxxz. |
\ | The literal escape character. When used within a character class, it treats the next character literally. When used outside of a character class, it is not treated in this way. |
] | The close character-class character ends the enumeration of a character class. |
: | The drive separator character separates a file specification. The
characters before the colon identify a drive name. The
characters after the colon identify either a directory name or a
file name. For example:
d:\direct\file.nam |
Table 8 contains examples of ways you might use wildcard characters with
include and exclude patterns.
Table 8. Using Wildcard Characters with Include and Exclude Patterns
Task | Pattern |
---|---|
Exclude all files with an extension of bak, except those found on the d: drive in the dev directory. |
exclude ?:*.bak include d:\dev\*.bak |
Exclude all files and directories under any tmp directory that might exist, except for the file, d:\tmp\save.fil. Include this file. |
exclude ?:\...\tmp\...\* include d:\tmp\save.fil |
Match any .obj file in any directory on the c: e: f: and g: drives. |
exclude [ce-g]:\...\*.obj |
Match the .obj files found in the root directory in the d: drive only. |
exclude d:\*.obj |
Match any file that resides under the tmp directory found on any drive. |
exclude ?:tmp\...\* |
The TSM client program processes the include and exclude options as follows:
You can use the exclude.dir option in your options file to exclude directories and subdirectories from backup. See Exclude Options for more information.
If a match is found, the processing stops and checks whether the option is include or exclude. If the option is include, the file is backed up. If the option is exclude, the file is not backed up.
The following examples demonstrate bottom up processing.
exclude ?:\*.obj include c:\foo\...\*.obj exclude c:\foo\junk\*.obj
The file that processes is: c:\foo\dev\test.obj. Processing follows these steps:
exclude ?:\*.obj include c:\foo\...\*.obj exclude c:\foo\junk\*.obj
The file that processes is: c:\widg\copyit.bat. Processing follows these steps:
exclude ?:\...\*.obj include c:\foo\...\*.obj exclude c:\foo\junk\*.obj
The current file that processes is: c:\lib\objs\printf.obj. Processing follows these steps: