IC65186: MIGRATION INITIATED REPAIR STGVOL MIGHT FAIL WITH ANR4759E

APAR status

• Closed as program error.

Error description

• If during Tivoli Storage Manager storage pool migration a volume
  is identified to be processed by a REPAIR STGVOL process, this
  might fail with ANR4759E.
  
  The activity log will report a sequence like:
  ANR1100I Migration started for volume <volume>, storage pool
    <poolid> (process number <number>). (SESSION: <migration
    sessionid>, PROCESS: <processid>)
  ANR1102I Removable volume <volume> is required for migration.
    (SESSION: <migration sessionid>, PROCESS: <processid>)
  ANR0984I Process 747 for REPAIR STGVOL started in the BACKGROUND
    at <time>. (SESSION: <repair sessionid>, PROCESS: <processid>)
  ANR4752I REPAIR STGVOL process 747 started for 1 volumes.
    (SESSION: <repair sessionid>, PROCESS: <processid>)
  ANR1101I Migration ended for volume <volume>. (SESSION:
    <migration sessionid>, PROCESS: <processid>)
  ..
  ANR4759E REPAIR STGVOL failed to process <volume>. (SESSION:
    <repair sessionid>, PROCESS: <processid>)
  
  The symptom is caused by migration leasing a volume for
  processing, and the lease not being freed before the REPAIR
  command is invoked.
  
    Tivoli Storage Manager Versions Affected: all V6 servers
    Customer/L2 Diagnostics (If Applicable)
  A trace with tracflag REPAIRVOL shows the following
  messages:
  <time>
  
  [22469][ssalloc.c][2574][DoRepairStgVols]:DoRepairStgVols:
  Failure leasing volume.
  <time> [22469][ssalloc.c][2933][ReportVol]:ReportVol: Volume
  <volume> report state 2.
  <time> [22469][output.c][6653][PutConsoleMsg]:ANR4759E REPAIR
  STGVOL failed to process <volume>.~
  <time>
  [22469][ssalloc.c][2692][DoRepairStgVols]:DoRepairStgVols:
  Exiting with rc 155.
  
  RC 155 translates to SSRC_VOLUME_ALREADY_LEASED
  
  SHOW SSL will report
    Volume <volume>(<volumeid>) --> Mode=Access, PoolId=15,
  Strategy=30, SessId=<migration sessionid>, Tag=4
    Initial Impact: Low
    Additional Keywords: REPAIR STGVOL TSM ZZ61
  
  Reclamation can also show this same condition.
  
  Platform/Version affected:
  
  Tivoli Storage Manager Server V55 V61
  

Local fix

• Manually run the
  REPAIR STGVOLS VOLName=<volumename>
  while there is no lease (SHOW SSL) active for the volume.
  

Problem summary

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

Problem conclusion

• This problem was fixed.
  Affected platforms: AIX, HP-UX, Sun Solaris, 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

• R61A PSY

     UP

• R61H PSY

     UP

• R61L PSY

     UP

• R61S PSY

     UP

• R61W PSY

     UP

• R61Z PSY

     UP