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-'
>>-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
If the test pattern has no errors, the compiled pattern result
is the same as the test pattern.
- -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.
This is the default if a display value is not specified.
- -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.
- 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