Administrator's Reference

AUDIT LIBRARY (Verify an Automated Library's Inventory)

Use the AUDIT LIBRARY command to ensure that an automated library is in a consistent state with respect to the server's internal library volume inventory. If inconsistencies are detected, the server updates its inventory to reflect the current state of the library. Missing volumes are deleted and moved volumes locations are updated, new volumes are not added, they must be checked in.

Important:

Audit library processing waits until all volumes have been dismounted from drives within the specified library. If one or more volumes are mounted, but are in the IDLE state, you can force the volumes to be dismounted by issuing the DISMOUNT VOLUME command. Otherwise, the audit library operation remains in a wait state until the idle volumes have been dismounted (the idle volumes are dismounted once the MOUNTRETENTION period expires).

The server options file that is created during installation includes a DEVCONFIG option that specifies a default device configuration file named devcnfg.out. You can specify other device configuration files with additional DEVCONFIG options. The files you specify with this option are automatically updated with the results of this command.

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 or unrestricted storage privilege.

Syntax

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

Parameters

libraryname

Specifies the name of the library to be audited. This parameter is required.

CHECKLabel=chklblvalue

Specifies how the storage volume label is checked during audit library processing. This parameter is optional and is only applicable to SCSI libraries. The default is YES. Possible values are:

Yes

Specifies to use the storage volume label on the tape.

Barcode

Specifies to use the barcode storage volume label to update the library inventory. You can decrease the audit processing time by using the barcode.

If the scanner cannot read a given barcode label, or if a tape does not have a barcode label, ADSM loads that tape in a drive to read the label. The above barcode information applies to SCSI libraries, but does not apply to 3494-class libraries.

Usage Notes

This command prevents any other activity with the library until the background process it starts is done. For example, no restore or retrieve requests that involve this library are processed while this command runs.

Examples

Task

Ensure that the EZLIFE automated library is in a consistent state with respect to the ADSM server's library volume inventory.

Command:

audit library ezlife

Related Commands

Table 12. 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 one or all background server processes.
UPDATE LIBRARY	Changes the attributes of a library.