AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

AUDIT LIBRARY (Audit volume inventories in an automated library)

Use this command to audit and synchronize volume inventories in an automated library.

When the AUDIT LIBRARY command is issued on a library client, the client synchronizes its inventory with the inventory on the library manager. If the library client detects inconsistencies, it corrects them by changing the ownership of the volume on the library manager.

When the AUDIT LIBRARY command is issued on a server where the library is SCSI, 349X, or ACSLS (LIBTYPE=SCSI, LIBTYPE=349X, or LIBTYPE=ACSLS), the server synchronizes its inventory with the inventory of the library device. If the server detects inconsistencies, it deletes missing volumes from its inventory.
  • In SCSI libraries, the server also updates the locations of volumes in its inventory that have been moved since the last audit.
  • In 349X libraries, the server also ensures that scratch volumes are in the scratch category and that private volumes are in the private category.

When the AUDIT LIBRARY command is issued on a server that is a library manager for the library (SHARED=YES), the server updates ownership of its volumes if it detects inconsistencies.

Regardless the type of server or type of library, issuing the AUDIT LIBRARY command does not automatically add new volumes to a library. To add new volumes, you must use the CHECKIN LIBVOLUME command.

Attention: The following precautions apply to SCSI, 349X, and ACSLS libraries only (LIBTYPE=SCSI, LIBTYPE=349X, and LIBTYPE=ACSLS):
  • Running the AUDIT LIBRARY command prevents any other library activity until the audit completes. For example, Tivoli® Storage Manager will not process restore or retrieve requests that involve the library when the AUDIT LIBRARY command is running.
  • If other activity is occurring in the library, do not issue the AUDIT LIBRARY command. Issuing the AUDIT LIBRARY command when a library is active can produce unpredictable results (for example, a hang condition) if a process currently accessing the library attempts to acquire a new tape mount.

This command creates a background process that you can cancel with the CANCEL PROCESS command. To display information about background processes, use the QUERY PROCESS command.

Privilege class

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


Read syntax diagramSkip visual syntax diagram
>>-AUDIT LIBRary--library_name---------------------------------->




library_name (Required)
Specifies the name of the library to audit.
Specifies how the storage volume label is checked during the audit. This parameter applies to SCSI libraries only. The parameter is ignored for other library types. The default is YES. Possible values are:
Specifies that Tivoli Storage Manager checks each volume label to verify the identity of the volume.
Specifies that Tivoli Storage Manager uses the barcode reader to read the storage label. Using the barcode decreases the audit processing time. This parameter applies only to SCSI libraries.
Attention: If the scanner cannot read the barcode label or the barcode label is missing, Tivoli Storage Manager loads that tape in a drive to read the label.
Specifies whether the server's information about a library, which is normally obtained during initialization, is refreshed, so that any changes in configuration are reflected. By setting the REFRESHSTATE parameter to Yes, this action is completed without having to restart the server or re-define the library. The default is No. Possible values are:
Specifies that the Tivoli Storage Manager server does not refresh the library's state when the library is audited.
Specifies that the Tivoli Storage Manager server does refresh the library's state when the AUDIT LIBRARY command is issued.

Example: Audit an automated library

Audit the EZLIFE automated library.
audit library ezlife

Related commands

Table 1. 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.