Before you can use the Dynamic File Services File System Inventory tool, you must create a text file (referred to as the command file) where you specify the path to be inventoried, the type of reports to create, the filenames to use for the output reports, and the inventory options to use. You can create multiple command files to generate different inventory reports that meet the criteria that are specified in the different command files.
In a command file, specify the following information about the inventory report that you want to create. Put each command on a separate line in the following order:
inventory_path report_type [inventory_option]
IMPORTANT:If there are errors in any parameter that you specify, the generated report files are empty.
The syntax for each of the required and optional elements is described in more detail in the following sections:
Specify the path that you want to inventory for this report. The inventory path can be the primary path for the pair or for any path in the pair.
inventory_path
Specify the full path, including the drive letter. For example:
C:\DATA\dir1\dir2
A command file can contain multiple paths. Place each path on a separate line. The combined output is written to the same report file. To write the inventory for each path to separate output files, create a separate command file for each path.
You can generate a summary report, a detailed report, or both reports. The summary report contains the statistics about the files, but does not contain the filenames. The detailed report includes both statistics and the matching filenames.
Specify a different filename for each report. The output files are in the .xml format.
|
Report Option |
Description |
|---|---|
/summary=summary_report_filename.xml
|
After an inventory is performed, creates a summary report file with the specified filename. |
/detailed=detailed_report_filename.xml
|
After an inventory is performed, creates a detailed report file with the specified filename. |
For example:
/summary=DATA_summary.xml /detailed=DATA_detailed.xml
You can request that a list of the filtered files be written to a separate file by using the /actionlist parameter. Specify a filename for a file where a list of files will be written.
|
Action List Option |
Description |
|---|---|
/actionlist=filename
|
Requests a list of files to be generated in the specified file. |
/actionlistappend |
Append the list of files to the specified action list file instead of overwriting its existing content. |
Specify one inventory option per line. If no inventory options are specified, then all options are enabled for the report. The inventory results are written to the report files that you requested.
You can specify none, one, or multiple general inventory options in any combination:
|
Inventory Option |
Description |
|---|---|
/create |
Inventories files by creation time. |
/modify |
Inventories files by modification time. |
/owner |
Inventories files by owner name. |
/size |
Inventories files by file length. |
/extension |
Inventories files by file extension. |
/empty |
Tracks empty files and folders and adds the list to the report. |
If you want to specify constraints for any one of the inventory options, you must specify constraints for each of the inventory options that you use in the same command file. For each parameter type, you can specify only one of its constraints.
In the following commands, the time duration notation ddd.hh:mm:ss indicates days (0 to 999), hours (0 to 24), minutes (0 to 60), and seconds (0 to 60). You can also specify days (ddd) alone.
|
Inventory Option |
Description |
|---|---|
/create>ddd.hh:mm:ss
|
Inventories files by creation times that are greater than the specified time duration. |
/create<ddd.hh:mm:ss
|
Inventories files by creation times that are less than the specified time duration. |
/modify>ddd.hh:mm:ss
|
Inventories files by modification times that are greater than the specified time duration. |
/modify<ddd.hh:mm:ss
|
Inventories files by modification times that are less than the specified time duration. |
/owner=name[,nextName...] |
Inventories files by the specified owner name or names. Delimit multiple names with a comma and no spaces. |
/size>amount |
Inventories files by file length that is greater than the amount specified. Specify the amount in bytes. For example, to inventory files greater than 1 MB, specify: /size>1024 |
/size<amount |
Inventories files by file length that is less than the amount specified. Specify the amount in bytes. For example, to inventory files less than 1 MB, specify: /size<1024 |
/extension=*.extension[,*.extension2...] |
Inventories files with the specified file extension. Separate entries with a comma and no spaces. |