Auditing Storage Pool Volumes

To check for any inconsistencies between database information and storage pool volumes, first complete the following fields and then click Finish, or click Cancel to end the task.

Note: You can only audit volumes that belong to storage pools with  DATAFORMAT=NATIVE.

Automatically Fix Problems Found

Select whether the server resolves any inconsistencies between the database information and the specified storage pool volume.

Primary Storage Pools
Yes Tivoli Storage Manager fixes any inconsistencies as they are detected.
  • If the physical file is a cached copy, Tivoli Storage Manager 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 is deleted from the database.
  • 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.

No Tivoli Storage Manager reports, but does not delete, database records that refer to files found with inconsistencies. The default is No.
  • Tivoli Storage Manager 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.
Copy Storage Pools
Yes Tivoli Storage Manager deletes any references to the physical file and any database records that point to a physical file that does not exist.
No Tivoli Storage Manager reports the error and marks the physical file copy as damaged in the database.

Skip Partial Files

Select whether Tivoli Storage Manager ignores files that span multiple storage pool volumes (skipped files), when performing the audit for the specified storage pool volume.

Yes Tivoli Storage Manager only audits complete files that are stored on the volume to be audited. For sequential access volumes, only the specified volume is mounted. The status of any skipped files is unknown.
No Specifies that Tivoli Storage Manager audits files that span multiple volumes when performing an audit operation on a specified volume. For sequential access volumes, multiple volumes can be mounted. The default is No.

Quiet Mode

Select whether Tivoli Storage Manager sends detailed informational messages to the activity log and the server console about irretrievable files on the volume.

Yes Tivoli Storage Manager is in quiet mode. Therefore, it only sends a summary report to the activity log and the server console.
No Tivoli Storage Manager is not in quiet mode. Therefore, it sends detailed informational messages and a summary report to the activity log and the server console. Each message contains the node, file space, and client name for the file. The default is No.

Volumes Written Beginning with Date

Specify the beginning date of the range to audit volumes.  All sequential volumes meeting the time range criteria that were written to after this date are audited.  All online disk volumes in storage will be included in the audit.    The default is the current date.  The server starts one audit process for each volume and runs the process serially.  You cannot use this parameter if you have specified a volume.  This parameter is optional.  To limit the number of volumes that may include disk volumes, use both the beginning and ending date fields along with the storage pool field.

You can specify the date by using one of the values below:

Value Description Example
MM/DD/YYYY A specific date 10/25/01

If a date is entered, all candidate volumes written on that day (starting at 12:00:01 am) will be audited.

TODAY The current date TODAY
TODAY-days or -days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY -7 or -7.

To audit volumes written to a week ago, you can specify FROMDATE=TODAY-7 or FROMDATE=-7

Volumes Written Ending with Date

Specify the ending date of the range for volumes to audit.  All volumes meeting the time range criteria that were written to before this date are audited.  If you do not specify a value, the current date is used. You cannot use this parameter if you have specified a volume.  This parameter is optional.  To limit the number of volumes that may include disk volumes, use both the beginning and ending date fields along with the storage pool field.

You can specify the date using one of the values below:

Value Description Example
MM/DD/YYYY A specific date 10/25/01

If a date is entered, all candidate volumes written on that day (starting at 12:00:01 am) will be evaluated.

TODAY The current date TODAY
TODAY-days or -days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY -1 or -1.

To display information created up to yesterday, you can specify TODATE=TODAY-1 or simply TODATE=-1.

Storage Pool Name

Specifies that only the volumes from this storage pool will be audited.  This parameter is optional.  You cannot use this parameter if you have specified a volume.