IT49035: MISSING WARNING ON AUDIT LIBRARY COMMAND WITH TYPE SHARED IN MULTI-LIBRARY MANAGER/CLIENT ENVIRONMENTS.

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

Error description

• In complex IBM Storage Protect Server library sharing
  environments, a tape volume status can unexpectedly be changed
  to SCRATCH with the AUDIT LIBRARY command when the following
  condition is met:
   
  A device class (XYZ) is removed from the library AAA by issuing
  the command :
  UPDATE DEVCLASS XYZ library=NEW-LIBRARY
  and this NEW-LIBRARY is managed by a different library manager
  server.
  When the command :
  AUDIT LIBRARY AAA
  is issued on the original library client server, some volumes
  status can unexpectedly change to SCRATCH.
   
  This happens when the audit library command tries to
  synchronise the volume inventory and ownership of the library
  client server.
  The operation detects volumes with device class XYZ which does
  not exist anymore in the AAA library because of the previous
  UPDATE DEVCLASS command.
  In that situation, the volume status will be set to SCRATCH for
  the volumes belonging to the XYZ devclass.
   
  If a tape volume containing valid data is incorrectly marked as
  SCRATCH, it might get overwritten by any session or process
  needing to write data on a new tape volume.
   
  To help prevent such problems, a warning message should be
  displayed whenever the AUDIT LIBRARY command is executed on a
  shared library (LIBTYPE=SHARED).
   
  This warning should inform users that the tape status may change
  to SCRATCH if the UPDATE DEVCLASS command is executed too early
  during the setup of a new tape library or while reconfiguring an
  existing tape library.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  *  All IBM Storage Protect server users of library sharing.    *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available.                           *
  * This problem is currently projected to be fixed in levels    *
  * 8.2.2.                                                       *
  * Note that this is subject to change at the discretion of IBM *
  *                                                              *
  * ANR8536I  The remote tape volume XYZ is deleted from the     *
  * library ABC inventory.                                       *
  * Explanation                                                  *
  * The remote tape volume does not exist in the library.        *
  * The server deletes the volume from the library.              *
  * SystemAction                                                 *
  * The volume is removed from the server's inventory.           *
  * UserResponse                                                 *
  * None.                                                        *
  *                                                              *
  * ANR8537I  The tape volume XYZ is released from the library   *
  * ABC.                                                         *
  * Explanation                                                  *
  * The server releases the volume which does not exist anymore. *
  * SystemAction                                                 *
  * The volume is released from the library.                     *
  * UserResponse                                                 *
  * None.                                                        *
  *                                                              *
  * ANR8538W The AUDIT LIBRARY is not allowed to a shared        *
  * library XYZ when ALLOWLIBCLIENT parameter is No.             *
  * msgExplanation                                               *
  * AUDIT LIBRARY can be run to a shared library when            *
  * ALLOWLIBCLIENT                                               *
  * parameter is specifed as YES.                                *
  * In a shared library environent with multiple library         *
  * managers,                                                    *
  * if the audit library command is issued on a library client,  *
  * the audit operation may detect some tape volumes which       *
  * do not exist in this library any more on this server.        *
  * The audit operation deletes these volumes and sets the       *
  * SCRATCH                                                      *
  * state to these volumes. If these tapes exist in other        *
  * library                                                      *
  * with a different library manager, this deletion can cause    *
  * the                                                          *
  * data lost issue.                                             *
  * msgSystemAction                                              *
  * The operation fails.                                         *
  * msgUserResponse                                              *
  * Be caution to issue the AUDIT LIBRARY on a library client.   *
  *                                                              *
  *                                                              *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
   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

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels