Tivoli Storage Manager for Windows: 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 TSM detects inconsistencies, the server updates its inventory to reflect the current state of the library. TSM deletes missing volumes and updates moved volume locations. TSM does not automatically add new volumes; you must check in new volumes with the CHECKIN LIBVOLUME command.

This command prevents any other activity with the library until this background 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 audit library processing. This barcode information applies to SCSI libraries, but does not apply to 3494 libraries. 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 volume label. Using the barcode decreases the audit processing time.
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

Ensure that the EZLIFE automated library agrees with the TSM server's library volume inventory.

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 ]