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