AUDIT LIBVOLUME (Verify database information for a tape volume)

Use this command to determine whether a tape volume is intact and to audit data on any tape volume.

You can issue the AUDIT LIBVOLUME command from any tape volume that is checked in to a library. The command runs in the background by default. You can issue the command from the following library types that have IBM® TS1140, IBM LTO 5, or a later generation tape drive:
  • SCSI tape library
  • Virtual tape library (VTL)
The following table outlines the tape drives that can verify tape volumes with media types for IBM TS1140 and IBM LTO 5 and later generation LTO tape drives:
Table 1. Tape drives and the media types
Drive Media type
TS1140 JB, JX, JA, JW, JJ, JR, JC, JY, and JK
IBM LTO 5 LTO 3, LTO 4, and LTO 5
IBM LTO 6 LTO 4, LTO 5, and LTO 6
IBM LTO 7 LTO 5, LTO 6, and LTO 7
The following table outlines the minimum device driver level that you require to run the command:
Table 2. Minimum IBM device driver level
Driver name Device driver level
Atape driver on AIX® 12.3.5.00
lin_tape driver on Linux® 1.6.7.00
IBM tape driver on Windows 6.2.2.00
Restriction: You cannot issue the CANCEL PROCESS command while the AUDIT LIBVOLUME command is in progress.

Privilege class

To issue this command, you must have system privilege, or unrestricted storage privilege for the library to which the tape volume is defined.

Syntax

Read syntax diagramSkip visual syntax diagramAUDit LIBVolumelibrary_namevolume_nameWait=NoWait=NoYes

Parameters

library_name (Required)
Specifies the name of the library volume where the tape volume is located that you want to audit.
volume_name (Required)
Specifies the name of the physical tape volume that you want to audit.
Wait (Optional)
Specifies whether the audit or verification operation is completed in the foreground or background. This parameter is optional. The following options are available:
No
Specifies that the operation is completed in the background. The NO value is the default value.
Yes
Specifies that the operation is completed in the foreground. It might take a long time to complete the operation.

Example: Audit a tape volume

Audit the EZLIFE library that has a tape volume that is called KM0347L5.
audit libvolume ezlife KM0347L5