dsmreconcile

Parameters

options

–Detail

Prints progress messages.

–ERRORLOGName=file_path

Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the space management client creates it.

–FILEINFO

Expires and deletes obsolete copies from the IBM Spectrum Protect server. This option is the basic reconciliation task and is the default option.

–FILELIST=file_path

Specifies the path of a file that contains a list of files to be processed by this command.

–Help

Displays syntax and options for the command. Do not specify other options when you specify the help option.

–ORPHANCHECK

Checks for orphaned files in the local file system.

The HSM client verifies that valid objects for each local stub file exist in the space management pool of the IBM Spectrum Protect server. The dsmreconcile process determines all migrated and premigrated files, and checks that corresponding objects exist on the server. When orphans are located, their names are recorded in the file_system_name/.SpaceMan/orphan.stubs file. This command option overrides the value of the checkfororphans option in the dsm.sys file.

If you previously ran the dsmreconcile command with the preptwo option, IBM Spectrum Protect reconciles with a two-way orphan check.

The two-way orphan check processing identifies orphans on the file system and on the IBM Spectrum Protect server. The two-way check is done in a single pass and the orphan identification process uses parallel processing.

Tip: If reconciliation is controlled by the space management client space monitor daemon, the scout daemon must be running when you specify this option. If reconciliation is controlled by the GPFS™ policy engine, the scout daemon is not necessary.

When the reconciliation process is running in orphan-check mode, metadata information is updated on the server. Obsolete copies of files are not expired or deleted on the server.

–PREPTWO

This option prepares a file system for a two-way orphan check. Use this option when reconciliation is controlled by the GPFS policy engine.

When reconciliation is controlled by the GPFS policy engine, migrated and premigrated files are associated with DMAPI attribute extObjId. If you set hsmextobjidattr=YES, the DMAPI attribute extObjId is associated with the files when they are migrated or premigrated. The preptwo option makes the association for any files that were not associated with the extObjId attribute when the files were migrated or premigrated.

The preptwo option is valid only if hsmextobjidattr=YES.

When you specify the preptwo option, do not specify any of the following options:

• fileinfo
• filelist
• orphancheck

–SErver=server_name

Specify the target server for the task. This option is valid only in a multiple-server environment. If the file system is managed by multiple servers and you do not specify server, the task is attempted with the default migration server.

If a file is coupled with a server, the value of this option must be that coupled server. If you specify another IBM Spectrum Protect server, the task fails.

filesystemspec

The name of the file system to reconcile. If you do not specify a file system name, the space management client reconciles all file systems on your workstation for which space management is active. If you enter more than one file system name, separate each name with at least one blank space.