IC76247: MOVE DRMEDIA WITH DBSNAPSHOT OPTION AND USING WILDCARD FOR VOLUMES MAY FAIL WITH ANR6698E

APAR status

• Closed as program error.

Error description

• The Tivoli Storage Manager server command MOVE DRMEDIA with the
  option SOURCE=DBSNAPSHOT and using a wildcard for the volumes
  may fail.
  
  Example:
  MOVE DRMEDIA * wherest=courier tostate=vault source=dbs
  
  ANR6698E MOVE DRMEDIA: CHECKOUT LIBVOLUME for VOL00001 in
  library LIB01 failed.
  
  Customer/L2 Diagnostics
  Example from a server trace with traceflags
  PVR MMS NA ADMCMD ORM
  
  [output.c][6699][PutConsoleMsg]:ANR0610I MOVE DRMEDIA started by
  ADMIN as process 87.~
  
  [ormadm.c][1353][MoveStgPoolVolumes]:13 copy stgpool volumes on
  the eligible volume list.
  
  [ormutil.c][2010][OrmChkEligibleVolume]:Entering, with
  volume=VOL00001, whereState=3:
  [ormutil.c][2129][OrmChkEligibleVolume]:Volume VOL00001 has a
  current volume state of 3.
  [ormutil.c][2229][OrmChkEligibleVolume]:Exiting with rc = 0 and
  skipVol = 0.
  
  [pvr.c][4650][pvrMatchVolName]:Matching volume name "VOL00002"
  (devClass=1).
  [pvrclass.c][4656][pvrIsFileDevClassId]:pvrIsFileDevClassId:
  device class 1 is not File
  [ormutil.c][2010][OrmChkEligibleVolume]:Entering, with
  volume=VOL00002, whereState=3:
  [ormutil.c][2129][OrmChkEligibleVolume]:Volume VOL00002 has a
  current volume state of 3.
  [ormutil.c][2229][OrmChkEligibleVolume]:Exiting with rc = 0 and
  skipVol = 0.
  
  [output.c][6699][PutConsoleMsg]:ANR6696I MOVE DRMEDIA: CHECKOUT
  LIBVOLUME for volume VOL00001 in library LIB01 starting.~
  
  [output.c][6699][PutConsoleMsg]:ANR6696I MOVE DRMEDIA: CHECKOUT
  LIBVOLUME for volume VOL00002 in library LIB01 starting.~
  [mmsdrm.c][370][MmsCheckoutLibVol]:Checking out 13 volumes from
  library LIB01 with force = 0, checkLabel = 0, removeCart = 1,
  bulkEject = 1, failIfEEfull = 0.
  
  [mmsshr.c][2188][ShareCheckoutVolume]:Checkout 13 volumes for
  DRM, volStatus = 115b87cf8.
  [ormadm.c][1732][UpdateStgPoolVolumes]:Volume list count=13,
  status list count = 13.
  [ormadm.c][1753][UpdateStgPoolVolumes]:Volume status value=0.
  [output.c][6699][PutConsoleMsg]:ANR6698E MOVE DRMEDIA: CHECKOUT
  LIBVOLUME for volume VOL00001 in library LIB01 failed.~
  
  [ormadm.c][1753][UpdateStgPoolVolumes]:Volume status value=0.
  [output.c][6699][PutConsoleMsg]:ANR6698E MOVE DRMEDIA: CHECKOUT
  LIBVOLUME for volume VOL00002 in library LIB01 failed.~
  
  Tivoli Storage Manager Versions Affected:
  Tivoli Storage Manager  server 5.4, 5.5, 6.1 and 6.2 on all
  platforms
  
  Initial Impact:
  medium
  
  Additional Keywords:
  zz61 zz62 TSM drmedia checkout
  

Local fix

• Use the MOVE DRMEDIA command for each volume separately:
  MOVE DRMEDIA xxxxxxxx wherest=courier tostate=vault s=dbs
  and the media was checked out successfully.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli Storage Manager users of the      *
  *                 MOVE DRMEDIA command.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION.                  *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in levels 6.2.3.                             *
  *                                                              *
  *                 Note that this is subject to change at the   *
  *                 discretion of IBM.                           *
  ****************************************************************
  See ERROR DESCRIPTION.
  

Problem conclusion

• The described problem has been resolved.
  

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

• R62A PSY

     UP

• R62H PSY

     UP

• R62L PSY

     UP

• R62S PSY

     UP

• R62W PSY

     UP