IC80800: RESTORE DB CAN FAIL WITH ANR4593E WHEN THERE ARE TWO VOLHISTORY ENTRIES WITH DIFFERENT FILE NAME SPECIFIED IN DSMSERV.OPT FILE.

APAR status

• Closed as program error.

Error description

• Restore db fail with ANR4593E when there are two or more
  volhistory entries,
  which have identical contents, specified in dsmserv.opt file.
  
  Messages are displayed in standard output as follows while
  restore db running.
  
  
  ANR4636I Starting roll-forward database restore.
  ANR4593E Restore database unable to find eligible candidate to
  use for
  processing.
  ANR4602E No volumes found for TODATE MM/DD/YYYY 23:59:59.
  ANR2032E RESTORE DB: Command failed - internal server error
  detected.
  ANR9999D Thread<0> issued message 2032 from:
  ANR9999D Thread<0>  000007FEF3C504AE outMsgf()+3e
  ANR9999D Thread<0>  000007FEF34F51B6 AdmRestoreDb()+e86
  ANR9999D Thread<0>  000007FEF348C657 admRestoreDatabase()+187
  ANR9999D Thread<0>  000007FEF3471302 psPostCleanup()+272
  ANR9999D Thread<0>  000007FEF3473420 adsmMain()+ed0
  ANR9999D Thread<0>  000000013F361187 main()+c7 dsmserv.c:249
  ANR9999D Thread<0>  000000013F36294A __tmainCRTStartup()+11a
  crtexe.c:555
  ANR9999D Thread<0>  0000000076FB652D BaseThreadInitThunk()+d
  ANR9999D Thread<0>  00000000771EC521 RtlUserThreadStart()+21
  ANR1794W TSM SAN discovery is disabled by options.
  
  
  Customer/L2 Diagnostics:
  ----------------------------------------
  The problem occur while parsing the contents of volhistory file.
  Server trace with ICBACK and ICVOLHST classes will show the
  following entries when problem occur.
  
  HH:MM:SS.SSS
  [0][icvolhst.c][8031][AssignRestoreStanzaFromVolHist]:Volume
  entry 000000000026B720 assigned seqNum 10001 with devClassName
  DBBACKUP.
  HH:MM:SS.SSS
  [0][icvolhst.c][8066][AssignRestoreStanzaFromVolHist]:Setting
  error based on volume already in the list...
  HH:MM:SS.SSS
  [0][icvolhst.c][8080][AssignRestoreStanzaFromVolHist]:Found vol
  True for stanza 000000000416A618 with seriesId 1 and lastVolP
  0000000000000000 and volSeqNum 10001
  (s->dbVols=000000000416A8A8).
  HH:MM:SS.SSS
  [0][icvolhst.c][8125][AssignRestoreStanzaFromVolHist]:Resetting
  doThisLine to pickup next volhist stanza.
  HH:MM:SS.SSS
  [0][icvolhst.c][8137][AssignRestoreStanzaFromVolHist]:Finished
  parsing volhist files, rc=9999.
  ----------------------------------------
  
  
  TSM Versions Affected:
  TSM  Servers 6.3 on all platforms.
  
  Initial Impact: Low
  
  Additional Keywords:
  zz63
  

Local fix

• Comment out some volhistory entries in dsmserv.opt while issuing
  "restore db" to leave only one identical volhistory file is
  specified in the opt file.
  

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 level 6.3.3. Note that this is            *
  *                 subject to change at the discretion of IBM.  *
  ****************************************************************
  *
  

Problem conclusion

• This problem was fixed.
  

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

• R63A PSY

     UP

• R63H PSY

     UP

• R63L PSY

     UP

• R63S PSY

     UP

• R63W PSY

     UP