Administrator's Reference

AUDIT VOLUME (Verify Database Information for a Storage Pool Volume)

Use this command to check for inconsistencies between database information and a storage pool volume. During the audit, the server sends processing information to the activity log and the server console.

While an audit process is active, clients cannot restore data from the specified volume or store new data to that volume.

If the server detects a file with errors, handling of the file will depend on the type of storage pool to which the volume belongs, whether the FIX option is specified on this command, and whether the file is also stored on a volume assigned to other pools.

You cannot audit a volume if it is being deleted from a primary or copy storage pool.

If TSM does not detect errors for a file that was marked as damaged, the state of the file is reset so that the file can be used.

This command creates a background process that can be canceled with the CANCEL PROCESS command. To display information on background processes, use the QUERY PROCESS command.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to which the volume is defined.

Syntax

                                .-Fix--=--No------.
>>-AUDit Volume--volume_name----+-----------------+------------->
                                '-Fix--=--+-No--+-'
                                          '-Yes-'
 
      .-SKIPPartial--=--No------.   .-Quiet--=--No------.
>-----+-------------------------+---+-------------------+------><
      '-SKIPPartial--=--+-No--+-'   '-Quiet--=--+-No--+-'
                        '-Yes-'                 '-Yes-'
 

Parameters

volume_name (Required)
Specifies the name of the storage pool volume you want to audit.

Fix
Specifies how TSM resolves inconsistencies between the database inventory and the specified storage pool volume. This parameter is optional. The default is NO.

The actions TSM performs depend on whether the volume is assigned to a primary or a copy storage pool.

Primary Storage Pool:

Fix=No
TSM reports, but does not delete, database records that refer to files with inconsistencies:

  • TSM marks the file as damaged in the database. If a backup copy is stored in a copy storage pool, you can restore the file using the RESTORE VOLUME or RESTORE STGPOOL command.

  • If the file is a cached copy, you must delete references to the file on this volume by issuing the AUDIT VOLUME command and specifying FIX=YES. If the physical file is not a cached copy, and a duplicate is stored in a copy storage pool, it can be restored by using the RESTORE VOLUME or RESTORE STGPOOL command.

If the AUDIT VOLUME command does not detect an error in a file that had previously been marked as damaged, the state of the file is reset so that the file can be used. This provides a means for resetting the state of damaged files if it is determined that the errors were caused by correctable hardware problems such as a dirty tape head.

Fix=Yes
TSM fixes any inconsistencies as they are detected:

  • If the physical file is a cached copy, TSM deletes the database records that refer to the cached file. The primary file is stored on another volume.

  • If the physical file is not a cached copy, and the file is also stored in one or more copy storage pools, the error will be reported and the physical file marked as damaged in the database. You can restore the physical file by using the RESTORE VOLUME or RESTORE STGPOOL command.

  • If the physical file is not a cached copy, and the physical file is not stored in a copy storage pool, each logical file for which inconsistencies are detected are deleted from the database.

If the AUDIT VOLUME command does not detect an error in a file that was previously marked as damaged, TSM resets the state of the file so that it can be used. This provides a means for resetting the state of damaged files if it is determined that the errors were caused by correctable hardware problems such as a dirty tape head.

Note:Do not use the AUDIT VOLUME command with FIX=YES if a restore process (RESTORE STGPOOL or RESTORE VOLUME) is running. The AUDIT VOLUME command could cause the restore to be incomplete.

Copy Storage Pool:

Fix=No
TSM reports the error and marks the physical file copy as damaged in the database.

Fix=Yes
TSM deletes any references to the physical file and any database records that point to a physical file that does not exist.

SKIPPartial
Specifies whether TSM ignores skipped files, which are files that span multiple storage pool volumes. This parameter is optional. The default value is NO. When performing an audit operation on a sequential access media volume, this parameter prevents additional sequential access media mounts that may be necessary to audit any skipped files. Possible values are:

No
TSM audits files that span multiple volumes.

Unless you specify SKIPPARTIAL=YES, TSM attempts to process each file stored on the volume, including files that span into and out of other volumes. To audit files that span multiple volumes, the following conditions must be true:

  • For sequential access volumes, the additional sequential access volumes must have an access mode of read/write or read-only.

  • For random access volumes, the additional volumes must be online.

Yes
TSM audits only files that are stored on the volume to be audited. The status of any skipped files is unknown.

Quiet
Specifies whether 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
Specifies that TSM sends detailed informational messages and a summary. Each message contains the node, file space, and client name for the file.

Yes
Specifies that TSM sends only a summary report.

Examples

Task

Verify that the database information for storage pool volume PROG2 is consistent with the data stored on the volume. TSM fixes any inconsistencies.

Command:
audit volume prog2 fix=yes

Related Commands

Table 17. Commands Related to AUDIT VOLUME

Command Description
CANCEL PROCESS Cancels a background server process.
QUERY CONTENT Displays information about files in a storage pool volume.
QUERY PROCESS Displays information about background processes.
QUERY VOLUME Displays information about storage pool volumes.


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