IT42385: MOVE DRMEDIA MAY NOT ALWAYS MOVE TAPES TO EE PORTS AFTER CHECKOUT LIBVOLUME HAS BEEN DONE

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

APAR status

• Closed as program error.

Error description

• Starting with IBM Spectrum Protect Server version 8.1.10, a MOVE
  DRMEDIA command may not always move tapes to the Entry/Exit (EE)
  ports as expected.
  This happens if no REMove parameter has been specified in the
  MOVE DRMEDIA command as the default value of the REMove
  parameter will be set to NO in the affected versions.
  
  Here a trace with traceflags ORM PVR MMS to show the remove
  value.
  
  07:29:27.079 [201][admcmd.c][10059][TraceMsg]:ANR2017I
  Administrator ADMIN issued command: MOVE DRMEDIA *
  wherestate=mountable tostate=Vault ~
  07:29:27.273 [197][ormadm.c][1621][MoveStgPoolVolumes]:1 copy
  stgpool volumes on the eligible
  
  volume list.
  07:29:27.273
  [197][ormadm.c][1741][ProcessEligibleStgPoolVols]:Scanning list,
  processing
  library=<LIBRARY>.
  07:29:27.273
  [197][ormadm.c][1788][ProcessEligibleStgPoolVols]:Found volume
  <VOLNAME>, devType 21,
  
  volInLib 1, gotVol 0, dcId 1, libName <LIBRARY> (type 1)
  07:29:27.273 [197][ormadm.c][3972][TraceMsg]:ANR6696I MOVE
  DRMEDIA: CHECKOUT LIBVOLUME for volume
  
  <VOLNAME> in library <LIBRARY> starting.~
  07:29:27.273 [197][mmsdrm.c][456][MmsCheckoutLibVol]:Checking
  out 1 volumes from library <LIBRARY>
  
  with force = 0, checkLabel = 1, removeCart = 0, bulkEject = 0,
  failIfEEfull = 0.
  07:29:27.273 [197][mmslib.c][6865][MmsFindLibDesc]:Finding
  descriptor for library <LIBRARY> (Desc Not
  Changing).
  07:29:27.273 [197][mmslib.c][6891][MmsFindLibDesc]:Found=1.
  07:29:27.273 [197][mmstxn.c][281][MmsLockUniverse]:Acquiring MMS
  universe lock (sLock).
  07:29:27.273 [197][mmslib.c][6963][MmsTestLib]:Testing for
  existence of library <LIBRARY>.
  07:29:27.273 [197][mmslib.c][6996][MmsTestLib]:Library <LIBRARY>
  does exist.
  07:29:27.273 [197][mmstxn.c][323][MmsUnlockUniverse]:Releasing
  MMS Universe lock.
  07:29:27.273 [197][mmsscsi.c][4426][ScsiCheckoutVolume]:Entry:
  checking out volume(s) from library
  
  <LIBRARY>, force 0, verify label 1, isDrm 1, remove 0.  <====
  07:29:27.273 [197][mmsscsi.c][14064][BeginActivity]:Beginning
  CHECKOUT activity for SCSI library
  <LIBRARY>.
  07:29:27.273 [197][mmslib.c][6865][MmsFindLibDesc]:Finding
  descriptor for library <LIBRARY> (Desc Any
  State).
  07:29:27.273 [197][mmslib.c][6891][MmsFindLibDesc]:Found=1.
  07:29:27.273 [197][mmsscsi.c][4451][ScsiCheckoutVolume]:Checkout
  1 volumes for DRM, volStatus =
  000001C5B89372D0.
  07:29:27.273
  [197][mmslib.c][7365][MmsGetNextVolumeInRange]:InVol is empty.
  07:29:27.273
  [197][mmslib.c][7507][MmsGetNextVolumeInRange]:OutVol =
  <VOLNAME>.
  07:29:27.273 [197][mmstxn.c][281][MmsLockUniverse]:Acquiring MMS
  universe lock (sLock).
  07:29:27.273 [197][mmslib.c][7150][MmsTestLibVolume]:Testing for
  existence of volume <VOLNAME> in
  
  library <LIBRARY>.
  07:29:27.302 [197][mmslib.c][7213][MmsTestLibVolume]:Volume
  <VOLNAME> exists in library <LIBRARY>;
  
  stat=1, use=1.
  07:29:27.302
  [197][mmsscsi.c][4518][ScsiCheckoutVolume]:MmsTestLibVolume
  returned for volume
  
  <VOLNAME>, with rc=0 exists=1.
  07:29:27.302 [197][mmsscsi.c][4540][TraceMsg]:ANR8867I
  Processing volume <VOLNAME> for the CHECKOUT
  command.~
  07:29:27.302
  [197][mmslib.c][9839][MmsReserveLibVolume]:Obtaining reservation
  for volume <VOLNAME>
  
  in library <LIBRARY>; activity=1.
  07:29:27.302 [197][mmsscsi.c][11887][GetVolumeHomeSlot]:Finding
  the home slot of volume <VOLNAME> in
  
  library <LIBRARY>.
  07:29:27.302 [197][mmstxn.c][281][MmsLockUniverse]:Acquiring MMS
  universe lock (xLock).
  07:29:27.303 [197][mmsscsi.c][11942][GetVolumeHomeSlot]:The home
  slot for volume <VOLNAME> is 1017,
  
  rc = 0.
  07:29:27.303 [197][mmsdrive.c][2550][MmsBorrowDrive]:Borrowing
  drive; lib=<LIBRARY>, devType=LTO,
  
  mode=R/O, specific=0, elem=0, mediaType=439.
  
  Key here in the trace is the isDrm 1, remove 0. which means
  the volume is not removed.
  
  | MDVREGR 8.1.10-TIV_5698ISMSV |
  

Local fix

• Explicitly specify the REMove value in the MOVE DRMEDIA command.
  

Problem summary

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

Problem conclusion

• This problem was fixed.
  Affected platforms for reported release:  AIX, Linux, and
  Windows.
  Platforms fixed:  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