Tivoli Header
Administrator's Reference
Use this command to check for inconsistencies between database information
and a storage pool volume. You can only audit volumes that belong to
storage pools with DATAFORMAT=NATIVE. During the audit, the server
sends processing information to the activity log and the server
console.
You cannot audit a volume if it is being deleted from a primary or copy
storage pool.
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.
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.
To display information about the contents of a storage pool volume, use the
QUERY CONTENT command.
To audit multiple volumes, you can use the FROMDATE and TODATE
parameters, or use the STGPOOL parameter to audit all volumes in a storage
pool. When you use the parameters FROMDATE, TODATE, or both, the server
limits the audit to only the sequential media volumes that meet the date
criteria, and automatically includes all online disk volumes in
storage. To limit the number of volumes that may include disk volumes,
use the FROMDATE, TODATE, and STGPOOL parameters.
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-+--+-----------------+----------->
'-| A |-------' '-Fix--=--+-No--+-'
'-Yes-'
.-SKIPPartial--=--No------. .-Quiet--=--No------.
>--+-------------------------+--+-------------------+----------><
'-SKIPPartial--=--+-No--+-' '-Quiet--=--+-No--+-'
'-Yes-' '-Yes-'
A (at least one of these parameters must be specified)
|--+-----------------------------+------------------------------>
| (1) |
'--------STGPool--=--poolname-'
(1) (1)
.--------FROMDate--=--TODAY-. .-TODate--=--TODay------.
>--+---------------------------+--+-----------------------+-----|
'-FROMDate--=----date-------' '-TODate--=----date-----'
Notes:
- You cannot specify a volume name if you specify a storage pool name,
FROMDATE, or TODATE.
Parameters
- volume_name
- Specifies the name of the storage pool volume you want to audit.
This parameter is required if you do not specify a storage pool. You
cannot specify a volume name together with the FROMDATE and TODATE
parameters.
- Fix
- Specifies how the server resolves inconsistencies between the database
inventory and the specified storage pool volume. This parameter is
optional. The default is NO.
The actions the server performs depend on whether the volume is assigned to
a primary or a copy storage pool.
Primary Storage Pool:
- Note:
- 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 a correctable hardware
problem such as a dirty tape head.
- 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.
- Fix=Yes
- The server fixes any inconsistencies as they are detected:
- If the physical file is a cached copy, the server 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.
- 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
- The server reports the error and marks the physical file copy as
damaged in the database.
- Fix=Yes
- The server 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.
- FROMDate
- Specifies the beginning date of the range to audit volumes. The
default is the current date. All sequential media volumes meeting the
time range criteria that were written to after this date are audited.
The server includes all online disk volumes in storage . 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 the FROMDATE, TODATE, and STGPOOL
parameters.
You can specify the data by using one of the values below:
Value
| Description
| Example
|
MM/DD/YYYY
| A specific date
| 10/15/2001
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 -7 or -7.
To display information beginning with volumes written a week ago, you can
specify FROMDATE=TODAY-7 or FROMDATE= -7.
|
- TODate
- Specifies the ending date of the range for volumes to audit. All
sequential media volumes meeting the time range criteria that were written to
before this date are audited. The server includes all online disk
volumes in storage
. If you do not specify a value, the server defaults to the current
date. 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 the FROMDATE, TODATE, and STGPOOL
parameters.
You can specify the date by using one of the values below:
Value
| Description
| Example
|
MM/DD/YYYY
| A specific date
| 10/15/2001
If a date is entered, all candidate volumes written on that day (ending at
11:59:59 pm) 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.
|
- STGPool
- This parameter specifies that the server only audits the volumes from the
specified storage pool. This parameter is optional. You cannot
use this parameter if you have specified a volume.
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
Task
Verify that the database information for all eligible volumes
written to from 3/20/2002 to 3/22/2002 is consistent with data stored on the
volume.
- Command:
- audit volume fromdate=032002 todate=032202
Task
Verify that the database information for all volumes in storage pool
STPOOL3 is consistent with data stored on the volume for today.
- Command:
- audit volume stgpool=STPOOL3
Task
Verify that the database information for all volumes in storage pool
STPOOL3 is consistent with data stored on the volume for the last two
days.
- Command:
- audit volume stgpool=STPOOL3 fromdate=-1
Related Commands
Table 16. 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 ]