IT49015: UPDATE AUDIT LIBRARY COMMAND IN IBM STORAGE PROTECT DOCUMENTATION

8.2.2.000-IBM-SPSRV-Linuxx86_64
8.2.2.000-IBM-SPSRV-WindowsX64
8.2.2.000-IBM-SPSRV-AIX
8.2.2.000-IBM-SPSRV-Linuxppc64le
8.2.2.000-IBM-SPSRV-Linuxs390x

APAR status

• Closed as documentation error.

Error description

• When the AUDIT LIBRARY command is executed on a server with a
  shared library (LIBTYPE=SHARED), a volume with private status
  may be incorrectly reassigned or updated as a scratch tape
  volume.
  Additionally, if the AUDIT LIBRARY command is run on a library
  client shortly after issuing an UPDATE DEVCLASS command to
  configure a new library, certain tape volumes may also be
  converted to scratch. This situation arises when the device
  class of those tape volumes is not supported by the newly
  defined library.
  
  Attention: Due to the above conditions, administrators need to
  be cautious during running of AUDIT LIBRARY command on library
  client or to a server with SHARED library. There is a
  significant risk that volumes may be overwritten, potentially
  causing data loss.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Storage Protect server users                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.2.1. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• The AUDIT LIBRARY (Audit volume inventories in an automated
  library) topic in IBM Documentation is updated to add the
  following attention note:
  
  "Running the AUDIT LIBRARY command under some conditions can
  cause tape volumes to be overwritten, which can lead to data
  loss. Use caution when you issue the AUDIT LIBRARY command on a
  library client or on a library that uses the SHARED library
  type.
  
  - If you run the AUDIT LIBRARY command on a server or library
  client that uses a shared library (LIBTYPE=SHARED), tape volumes
  with private status might be updated incorrectly or reassigned
  as scratch. This issue can occur when the library client has
  multiple library managers and you previously used the UPDATE
  DEVCLASS command to change the library name. After this library
  update, tape volumes that use the same device class might not
  exist in the new library. As a result, these volumes might be
  unintentionally converted to scratch.
  - If you run the AUDIT LIBRARY command on a library manager in a
  shared library environment, the command audits the tape library
  to synchronize the library inventory between the library and the
  server.
  - If you run the AUDIT LIBRARY command on a library client in a
  shared library environment, the command audits tape volumes in
  the storage pool that is associated with the tape library. The
  audit synchronizes tape volumes between the library client and
  the storage pool."
  
  
  This update will be available in the IBM Storage Protect server
  8.2.1 documentation at the following topic URL:
  https://www.ibm.com/docs/en/storage-protect/8.2.1?topic=ac-audit
  -library-audit-volume-inventories-in-automated-library
  
  Affected platforms:
  AIX, Linux, and Windows
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels