Administrator's Reference

RECONCILE VOLUMES (Reconcile Differences in the Virtual Volume Definitions)

Issue this command from the source server to reconcile differences between virtual volume definitions on the source server and archive files on the target server. TSM finds all volumes of the specified device class on the source server and all corresponding archive files on the target server. The target server inventory is also compared to the local definition for virtual volumes to see if inconsistencies exist.

Privilege Class

To issue this command, you must have system privilege.

Syntax

                        .-*-----------------.
>>-REConcile Volumes----+-------------------+------------------->
                        '-device_class_name-'
 
      .-Fix--=--No------.   .-SKIPPartial--=--No------.
>-----+-----------------+---+-------------------------+--------->
      '-Fix--=--+-No--+-'   '-SKIPPartial--=--+-No--+-'
                '-Yes-'                       '-Yes-'
 
      .-Quiet--=--No------.
>-----+-------------------+------------------------------------><
      '-Quiet--=--+-No--+-'
                  '-Yes-'
 

Parameters

device_class_name
Specifies the device class name of the virtual volumes. If you do not specify a name, TSM reconciles all virtual volumes. This parameter is optional.

FIX
Specifies whether or not TSM attempts to correct any identified inconsistencies. This parameter is optional. The default is NO. Possible values are:

No
Specifies that TSM does not fix any inconsistencies.

Yes
Specifies that TSM makes the following corrections:

  • TSM marks as unavailable storage pool volumes on the source server that cannot be located on the target server. Volumes that are only found in the volume history, such as database backups and import and export volumes, are reported as being inconsistent.

  • Archive files on the target server that do not correspond to any virtual volumes on the source server are marked for deletion from the target server.

The following table shows the details of the actions taken:

FIX= At the Source Server At the Target Server Action
NO Volumes exist No files exist Report error
Files exist but are marked for deletion
Active files exist but attributes do not match
Volumes do not exist Active files exist Report error
Files exist but are marked for deletion None
YES Volumes exist No files exist Report error

Storage pool volumes: Marked as unavailable

Files exist but marked for deletion Report error

Storage pool volumes: If attributes match, mark files on the target server as active again, mark volumes on the source server as unavailable, and recommend that an AUDIT VOLUME be done to verify the data. If attributes do not match, mark volumes as unavailable.

Active files exist but attributes do not match Report error

Storage pool volumes: Mark as unavailable and recommend that an AUDIT VOLUME be done to verify the data.

Volumes do not exist Active files exist Mark files for deletion on the target server.
Files exist but marked for deletion None

SKIPPartial
Specifies whether TSM does not audit files that span multiple sequential access storage pool volumes (skipped files) This parameter is optional. The default is NO. Possible values are:

No
Specifies that TSM audits files that span multiple volumes.

Yes
Specifies that TSM does not audit files that span multiple volumes. This option prevents additional media mounts to audit any skipped files. The status of skipped files is unknown.

Quiet
Specifies whether or not TSM sends detailed informational messages to the activity log and the server console about irretrievable files on the volume. This parameter is optional. The default is NO. Possible values are:

No
TSM sends detailed informational messages and a summary report. Each message contains the node, file space, and client name for the file.

Yes
TSM only sends a summary report.

Examples

Task

Reconcile the differences between all virtual volumes definitions on the source server and archive files on the target server to correct any inconsistencies.

Command:
reconcile volumes remote1 fix=yes

Related Commands

Table 200. Commands Related to RECONCILE VOLUMES

Command Description
DEFINE DEVCLASS Defines a device class.
DEFINE SERVER Defines a server for server-to-server communications.
DELETE SERVER Deletes the definition of a server.
QUERY SERVER Displays information about servers.
UPDATE SERVER Updates information about a server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]