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
The actions TSM performs depend on whether the volume is assigned to a primary or a copy storage pool.
Primary Storage Pool:
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.
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:
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:
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.
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. |