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.

The backup-archive client 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.

Windows operating systemsUse 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

Mac OS X operating systemsOracle Solaris operating systemsLinux operating systemsAIX operating systems
Read syntax diagramSkip visual syntax diagram Query INCLexcl   test pattern -DETail
Windows operating systems
Read syntax diagramSkip visual syntax diagram Query INCLexcl test pattern -DETail -DISPLAY=basicvssexclall

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.
Windows operating systems-DISPLAY=basic | vssexcl | all
Windows operating systems-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 the client.
This is the default if a display value is not specified.
Windows operating systems-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.
Windows operating systems-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
Windows operating systemsTask
Windows operating systemsDisplay 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
Mac OS X operating systemsOracle Solaris operating systemsLinux operating systemsAIX operating systemsTask
Mac OS X operating systemsOracle Solaris operating systemsLinux operating systemsAIX operating systemsTest the validity of this pattern: /.../?x?/*.log 
query inclexcl /.../?x?/*.log
Windows operating systemsTask
Windows operating systemsTest the validity of this pattern: ..\?x?\*.log 
query inclexcl ..\?x?\*.log