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

106 | Command Line Interface Reference
release
Explicitly releases a migrated file, leaving a stub file on the file server.
Synopsis
FMACLI rel[ease]
[--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]
[{--minimum-copies | -n} mc]
[{--changed-retention-time | -t} crtd|h|m|s]
[{--read-retention-time | -T} rrtd|h|m|s]
[{--low-watermark | -U} nn]
[{--high-watermark | -u} nn]
[-F outlist]
Description
The release command gains space on a managed volume by converting already migrated files to stub files. If
the command detects that not enough archived copies exist, the release operation is not performed. For
releasing a file both retention times (crt and rrt) and the number of copies (mc) must be fulfilled.
A file smaller than 1024 bytes are not released because replacing it with a stub file does not increase
available space on the file server.
Note Excluded files are excluded from statistical summaries.
Also, if a file was released and migrated to multiple archives, it is restored from the last archive to
which it was migrated when recalled.