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.
- 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.
- 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.
Syntax
>>-AUDIT LIBRary--library_name----------------------------------> .-CHECKLabel--=--Yes---------. >--+----------------------------+-------------------------------> '-CHECKLabel--=--+-Yes-----+-' '-Barcode-' .-REFRESHstate--=--No------. >--+--------------------------+-------------------------------->< '-REFRESHstate--=--+-No--+-' '-Yes-'
Parameters
- library_name (Required)
- Specifies the name of the library to audit.
- CHECKLabel
- 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:
- Yes
- Specifies that Tivoli Storage Manager checks each volume label to verify the identity of the volume.
- Barcode
- 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.
- REFRESHstate
- 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:
- No
- Specifies that the Tivoli Storage Manager server does not refresh the library's state when the library is audited.
- Yes
- 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
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. |