V11 SP8

Performing an IBM i File System Agent Restore to a New Computer

Use this procedure to restore files and folders to:

  • A different computer
  • A different computer with a different UNIX version from the source computer
  • A different computer that is a NFS-mounted file system

When you restore the data from an IBM i File System Agent client to a UNIX client, you can only restored the data from the Integrated File System (IFS). The library, and library files are not restored.

If you want to find and restore specific data, see Find.

Before You Begin

Add the destination computer as a client in the source computer CommCell Console.


  1. From the CommCell Browser, expand Client Computers > client > Proxy Client File System > backup_set.
  2. Right-click the subclient, point to All Tasks and then click Browse and Restore.
  3. On the Browse and Restore Options dialog box, select Latest Backup and then click View Content.
  4. Optional: Use non-default Browse and Restore options. See Browse and Restore.
  5. From the Browse window, select the data to restore in the right pane and then click Recover All Selected.

    The Restore Options dialog box is displayed.

  6. On the General tab:
    1. Select the destination computer from the Destination Client list.
    2. Specify the destination folder.
      • To restore the file to the same folder as the source computer, select the  Restore to same folder check box.

        Note: When you select this option, existing file are overwritten.

      • To restore the files to a new location, clear the Restore to same folder check box and then type new path in the Specify destination path box.
    3. Optional: Specify when to restore the files.

      The restored data overwrites the existing data when the restored data is newer than the existing data.

      • To restore the data when the data you want to restore is older than the destination data, select the Overwrite Files check box and then select Unconditional Overwrite.
      • To only restore files that exist in the specified restore directory, select the Overwrite Files check box and then select the Restore only if target exists check box.
  7. Optional: Select the advanced restore options.
    1. Click Advanced.

      The Advanced Restore dialog box is displayed.

      Option Parameter
      Restore the private authority with the object On the General tab, select the Restore Private authority (PVTAUT) check box.
      Restore the spool files. On the General tab, select the Restore Spooled file data (SPLFDTA) check box.
      Allow object differences On the General tab, select the Allow object differences (ALLOWOBJDIF) check box and one of the following options:


      There can be no difference between the saved data and the restored data.


      Allow all differences between the saved data and the restored data.

      Note: This option does not guarantee compatibility with the existing databases, so you may need to correct the database after the restore.


      Allow differences that are compatible with the existing databases.

      Note: This option is available only when the operating system is version V7Rx or later.

      Best Practice: Use this option instead of *ALL because it guarantees compatibility with the existing databases.


      Allow a combination of the following parameter differences:


      Allow authorization list differences.


      Allow file level ID and member level ID differences.


      Allow file ownership differences.


      Allow primary group differences.

       Convert the user objects to the format that the current operating system version requires or to be compatible with the current machine. On the General tab, from the Force Object Conversion list, select one of the options.
      • *SYSVAL

        Converts the objects by using the QFRCCVNRST system value.

      • *NO

        Prevents the user options from being converted.

      • *YES*RQD

        Converts the user objects that must be converted to be compatible with the current machine.

      • *YES*ALL

        Converts all the user objects.

      Restore the deleted items On the Browse Options tab:
      1. Select the Restore deleted items check box.
      2. Select the Specify Time Range check box.
      3. Select the Start Time and End Time check boxes and then enter the time range for the deleted files.
      Exclude files and directories from the restore On the Paths/Filters Options tab, in the Filter Item section:
      1. Click the Add button.
      2. Enter the file or directory that you want to exclude. You can use wildcards to specify the directory or file.

        For information on the supported wildcards, see Supported Wildcards for the IBM i File System Agent Agent.

      3. Click OK.
      Add a suffix to each file that you restore On the Maps tab, select the Rename all restore files with suffix check box.

      Note: This option is only supported for IBM i IFS. It is not supported with IBM i LFS.

      On Windows, the suffix is added before the file type extension.

      On UNIX and Macintosh, the suffix is added after the file type extension.

      If you selected the "Library/Libraries" option, and you want to defer the restore of objects that depend on objects that are not yet available. Specify the identifier.

      On the General tab, in the Defer ID (DFRID) box, type the identifier to use.

      To complete a restore of the deferred objects, first restore the objects that they depend on, and specify the same Defer ID value. If any objects remain deferred when the other objects are available, use the Restore Deferred Objects (RSTDFROBJ) command, and specify the same Defer ID value. Use this parameter to restore all objects in a set of libraries when you restore the libraries with dependent objects before the libraries with the objects they depend on. Deferred objects can be logical files, or SQL materialized query tables (MQTs). A deferred logical file is not created until the restore completes. A deferred MQT is created, but until the restore completes, any functions that are performed on the MQT and that require access to the based-on files fail.


      If either of the following conditions are true, then the restore of a deferred object may be automatically completed when you restore the objects that it depends on.

      • You restore the deferred object to the library from which it was saved.
      • You specify the same Defer ID value for the restore operations for both the deferred object, and the objects that it depends on.

      The default value ,*NONE, means that objects are not restored or deferred if they depend on objects that are not available.

      If you selected to restore a security object, select the authority information to restore On the General tab, from the Security data (SECDTA) list, select the authority information to restore.
      • *USRPRF: Restore the user profiles and their private authorities.
      • *PVTAUT: Restore the private authorities for the specified user profiles, and the auxiliary storage pools. The Restore Authority (RSTAUT) command uses this information to restore the authorities to the referenced objects.
      • *PWDGRP: Restore the specified user profiles, their private authorities, and their passwords and group linkages.
      • *DCM: Only restore the internal objects that the Digital Certificate Manager requires. The software does not restore any user profiles. If you select this value, then you must specify *NONE for the USRPRF parameter.
    2. Click OK to close the Advanced Restore Options dialog box.
  8. Click OK to close the Restore Options dialog box.

To monitor the progress of the restore job, see Job Controller.

To view the job history, see Job History.