Tivoli Header

Administrator's Reference

AUDIT LIBRARY (Verify an Automated Library's Inventory)

Use this command to ensure that the server's library volume inventory is consistent with the volumes that are physically located in an automated library. If the Tivoli Storage Manager server detects inconsistencies, it updates its inventory to reflect the current state of the library. The server deletes missing volumes. In SCSI libraries, it updates moved volume locations. In 349X libraries, it ensures that scratch volumes are in the scratch category and private volumes in the private category. The server does not automatically add new volumes; you must check in new volumes with the CHECKIN LIBVOLUME command.

This command prevents any other library activity until the process completes. For example, no restore or retrieve requests that involve this library process while this command runs.

Privilege Class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax

>>-AUDIT LIBRary--library_name---------------------------------->
 
   .-CHECKLabel--=--Yes---------.
>--+----------------------------+------------------------------><
   '-CHECKLabel--=--+-Yes-----+-'
                    '-Barcode-'
 
 

Parameters

library_name (Required)
Specifies the name of the library to audit.

CHECKLabel
Specifies how the storage volume label is checked during the audit. The default is YES. Possible values are:

Yes
Specifies that TSM checks each volume label to verify the identity of the volume.

Barcode
Specifies that TSM uses the barcode reader to read the storage label. Using the barcode decreases the audit processing time. This parameter applies only to SCSI libraries.
Note:
If the scanner cannot read the barcode label or the barcode label is missing, TSM loads that tape in a drive to read the label.

Examples

Task

Audit the EZLIFE automated library.

Command:
audit library ezlife

Related Commands

Table 14. Commands Related to AUDIT LIBRARY

Command Description
CANCEL PROCESS Cancels a background server process.
DEFINE LIBRARY Defines an automated or manual library.
DELETE LIBRARY Deletes a library.
DISMOUNT VOLUME Dismounts a sequential, removable volume by the volume name.
QUERY LIBRARY Displays information about one or more libraries.
QUERY LIBVOLUME Displays information about a library volume.
QUERY PROCESS Displays information about background processes.
UPDATE LIBRARY Changes the attributes of a library.


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