HP Software File Migration Agent Installation and Administration Guide (September 2009)

Command Line Interface Reference | 83
activate
Sets the file ID in the metadata to the current ID of the file.
Syntax
FMACLI act[ivate]
[--help | -h]
[{--logfile | -L} logfile]
[--log-info-messages | -V]]
[--verbose | -v]
[file] | [{--filelist] | -f} filelist]
[{--recursive | -r} path]
[--oem-file-format | --unicode-file-format | --ansi-file-format |
--utf8-file-format]
[{--minimum-file-size | -S} nb|k|m|g]
[{--minimum-access-time | -A} nd|h|m|s]
[{--minimum-write-time | -W} nd|h|m|s]
[--exclude-system]
[--exclude-hidden]
[--exclude-read-only]
[--exclude-archive]
[--exclude-compressed]
[--ignore-files ignorefile]
[--off]
[-F outlist]
Description
The activate command sets the file ID in the metadata to the current ID of the file. Use this function under
the following conditions:
• When the file ID of the file changes.
• After metadata is restored.
• When moving FMA metadata from one computer to another.
• When file has been restored from a backup application. File stubs must be activated after a restore from
backup for it to operate correctly.
Do not try to activate files that have an unknown status.
Files must be active in order to be recalled.
Disabling files ensures that no entry is written to the FMA garbage collection container when files are
deleted. As a result, the corresponding archive copy is not deleted during an FMA cleanup run.
Note Excluded files are excluded from statistical summaries.