Recalling files corresponding to placeholders

Article:HOWTO57569  |  Created: 2011-08-01  |  Updated: 2013-07-12  |  Article URL
Article Type
How To


Recalling files corresponding to placeholders

You can use FSAUtility with the -b parameter to recall files corresponding to placeholders present in a folder. This facility recalls the placeholders in a given source folder, irrespective of the volume and archive in which the files are located. It also works with placeholders that you have copied into the source folder from another folder.

You can choose to recall files recursively from the subfolders of the source folder, if required.


Before you use this option with Celerra/VNX placeholders, ensure that FSAUtility is configured to use a suitable method for identifying the placeholders.

See About using FSAUtility with EMC Celerra/VNX placeholders.

By default, FSAUtility recalls the files in asynchronous mode. You can choose instead to recall files synchronously if you want. With a synchronous recall you can set a timeout for file recalls, and see the progress of each file recall operation. To recall files synchronously and to set a timeout for file recalls, create a DWORD registry entry called FileDownloadTimeOut under the following key on the Enterprise Vault server:

    \Enterprise Vault

If FileDownloadTimeOut is set to 0, FSAUtility recalls files asynchronously. Any value greater than 0 denotes the timeout, in minutes, for each file recall.


FSAUtility -b -s UNC_path [-D mm-dd-yyyy] [-e ext_list] [-recurse] [-r]


  • -s UNC_path specifies the path to the required folder, volume, or file server.

  • -D mm-dd-yyyy specifies the date after which items must be archived before you can recall them.

  • [-e ext_list] specifies the file types to recall as a comma-separated list of file name extensions. For example:


    By default, the utility recalls all file types.

  • -recurse recalls files recursively from subfolders. If not specified, the utility recalls files only from the parent folder.

  • -r specifies report mode. FSAUtility generates a report that outlines the activities that it would perform if you were to run it in normal mode, but without performing those activities.

    FSAUtility generates a report named EV_FILESYSTEM_UTILITY_REPORT_DateTime.txt, in the folder installpath\Reports\FSAUtility.

    If you run -b in normal mode, FSAUtility generates a report named EV_FILESYSTEM_UTILITY_REPORT_DateTime.xml.


The following command recalls the Word and Excel files that have placeholders in the folder \\myserver\users. It also recalls files within subfolders, if any.

FSAUtility -b -s \\myserver\users -e *.doc,*.xls -recurse

The following command recalls all the files that have placeholders that were archived after May 26 2009 in the folder \\myserver\users. It only recalls files from the parent folder.

FSAUtility -b -s \\myserver\users -D 05-26-2009


  • If you halt an FSAUtility operation to recall placeholders before it has finished then, when you next start the utility, it prompts you to resume the operation.

  • When you recall files to an EMC Celerra/VNX device, FSAUtility applies only the folder permissions to the files. If there are placeholders with file-specific permissions, the file permissions are lost and you must reapply them manually.

See also

See Restoring archived files.

See FSAUtility options

See About FSAUtility

Legacy ID


Article URL

Terms of use for this information are found in Legal Notices