![]() |
![]() |
You might want to keep certain files, such as system files or files that the HSM client creates and uses, on your local file system at all times. Or, you might want to include certain files for backup or migration. Set the statements in your include-exclude options file to exclude or include specific files from space management and assign specific management classes to these files. If you do not create an include-exclude options file, all files are considered for backup services and the default management class is used.
For AIX GPFS file systems only: Do not use the inclexcl option with the AIX GPFS failover environment. Unlike dsm.opt and dsm.sys files, include-exclude options files are not shared between different nodes of a failover group. Add the include-exclude list directly to the dsm.sys file, or verify that the include-exclude list files match on all nodes participating in the local failover group or node set.
For all other file systems: Use the inclexcl option in your dsm.sys file to specify the name of your include-exclude options file. You can create an include-exclude options file for each TSM server that your client node contacts for services. For example, if your dsm.sys file contains two stanzas with options for two servers, you can include an inclexcl option in each stanza. Each inclexcl option can point to a different include-exclude options file. The files that you create must reside in a directory to which all users on your workstation have read access.
Follow these rules when you use the options in Table 9 to include or exclude files from either backup or migration:
Table 9. Include and Exclude Statements
Option | Description |
---|---|
exclude.backup | Excludes a file from backup. |
exclude.file.spacemgmt | Excludes a file from HSM services only. Use this option when you have both the backup-archive client and the HSM client installed. |
exclude.spacemgmt | Excludes files and directories from HSM backup only. Use this option when you have both the backup-archive client and the HSM client installed. |
include | Includes files for backup. |
include.file | Includes a file for backup. |
The following example displays a sample include-exclude options file:
exclude /.../core include /home/.../* personal_files include /home/davehil/dsnew/.../* include /home/davehil/driver5/.../* source_code exclude.spacemgmt /home/jones/proj1/status/.../* exclude /home/root/cron.log
In the sample include-exclude options file, personal_files and source_code identify management classes that are assigned to specific files. If you do not assign a management class to your files, the default management class is used.
Include-exclude options are processed from the bottom up. For example, when you build a migration candidates list for a file system, and the files that you included in that list migrate, each file is tested against the options in the include-exclude options file beginning with the last option that you specified and working up. If a match is found, it does not test the file against any additional options. It either excludes or includes the file as the option specifies. If a match is not found, the file is implicitly included for space management and backup services.
If you exclude a file from space management after it migrates to storage, it remains migrated until it is automatically or selectively recalled. After it is recalled, it is no longer eligible for migration. To prevent a file migrating to storage from a local file system, assign the file to a management class without automatic or selective migration.
To create an include-exclude list from the graphical user interface:
To create an include-exclude list from the command line: