Query Inclexcl
The query inclexcl command displays a list of include-exclude statements in the order in which they are processed during backup and archive operations. The list displays the type of option, the scope of the option (archive, all, and so on), and the name of the source file.
Tivoli® Storage Manager excludes some files from file system backup and restore operations. You can use the query inclexcl command to display a list of these files. In the output of the command, these files have Operating System next to the path.
You can test the validity of patterns you want to use in your include-exclude list before you actually insert them in your options file. See the test pattern explanation.
Use the detail option to display the management class that is associated with an include-exclude statement.
Use the display option to display the files that are included or excluded from a file system back up operation.
Supported Clients
This command is valid for all clients.
Syntax
>>-Query INCLexcl--+--------------+--+----------+--+-----------------------+->< '-test pattern-' '- -DETail-' | .-basic---. | '--DISPLAY=-+-vssexcl-+-' '-all-----'
Parameters
- test pattern
- Use for testing the validity of patterns you want to use in your
include-exclude list. When you use a test pattern with this command,
the following occurs:
- The internal include-exclude list is not displayed
- The pattern is processed as if it came from an include-exclude statement, including all the usual error checking
- The pattern is displayed as it would appear in the include-exclude list
- -DETail
- Displays the management class that is associated with the include-exclude statement.
- -DISPLAY=basic | vssexcl | all
- -DISPLAY=basic displays the files and directories
that have been included or excluded by one of the following methods:
- The objects were included or excluded in the client options file.
- The objects were included or excluded in a server-side client option set.
- The objects were excluded by the operating system because they are contained in the HKEY_LOCAL_MACHINES\SYSTEM\CurrentControlSet\BackupRestore\FilesNotToBackup registry key.
- The objects were explicitly excluded by IBM® Tivoli Storage Manager.
- -DISPLAY=vssexcl displays a list of files that are excluded from a file system backup, because they are included when a system state backup is performed. Files that are backed up by a backup systemstate operation are protected by the VSS writer; you cannot include these files in a file system backup by adding them to an include statement in the dsm.opt file, or client option set.
- -DISPLAY=all displays all files that are included or excluded during a file system backup.
Examples
- Task
- Exclude a file from deduplication by excluding it in the client
options file:
Exclude Dedup *\...\file2
- Task
- Display a basic list of include-exclude statements. Command:
query inclexcl
- Task
- Display a list of files that are excluded from file system backups
because the VSS writer includes them in system state backups.
query inclexcl -display=vssexcl
- Task
- Display a list of include-exclude statements. Display the management
class that is associated with each statement.
query inclexcl -detail
- Task
- Test the validity of this pattern: /.../?x?/*.log
query inclexcl /.../?x?/*.log
- Task
- Test the validity of this pattern: ..\?x?\*.log
query inclexcl ..\?x?\*.log