IT04589: SERVER CRASH DURING RESTORE DB WHEN DEVCONFIG HAS LOWER-CASE COM MANDS

6.3.6.000-TIV-TSMRPT-AGENT-Linux
6.3.6.000-TIV-TSMRPT-AGENT-AIX
6.3.6.000-TIV-TSMRPT-AIX
6.3.6.000-TIV-TSMRPT-AGENT-Windows
6.3.6.000-TIV-TSMRPT-Linuxx86
6.3.6.000-TIV-TSMRPT-Linuxx86_64
6.3.6.000-TIV-TSMRPT-WindowsI32
6.3.6.000-TIV-TSMRPT-WindowsX64
6.3.6.000-TIV-TSMAC-WindowsX64
6.3.6.000-TIV-TSMAC-WindowsI32
6.3.6.000-TIV-TSMAC-SolarisSPARC
6.3.6.000-TIV-TSMAC-Linuxx86
6.3.6.000-TIV-TSMAC-Linuxs390x
6.3.6.000-TIV-TSMAC-AIX
6.3.6.000-TIV-TSMALL-SolarisSPARC
6.3.6.000-TIV-TSMALL-WindowsX64
6.3.6.000-TIV-TSMSTA-WindowsI32
6.3.6.000-TIV-TSMALL-HP-UX
6.3.6.000-TIV-TSMALL-Linuxppc64
6.3.6.000-TIV-TSMALL-AIX
6.3.6.000-TIV-TSMALL-Linuxs390x
6.3.6.000-TIV-TSMALL-Linuxx86_64
7.1.3.000-TIV-TSMSRV-WIN
7.1.3.000-TIV-TSMSRV-SolarisSPARC
7.1.3.000-TIV-TSMSRV-Linuxx86_64
7.1.3.000-TIV-TSMSRV-Linuxs390x
7.1.3.000-TIV-TSMSRV-Linuxppc64
7.1.3.000-TIV-TSMSRV-HP-UX
7.1.3.000-TIV-TSMSRV-AIX
IBM Tivoli Storage Manager V6.3 Fix Pack 6 (6.3.6.000) Server Downloads

APAR status

• Closed as program error.

Error description

• The Tivoli Storage Manager server can crash during a RESTORE DB
  operation if the defined device configuration file contains
  lower-case commands.
  
  For example, a device configuration file that contains the
  following commands in lower-case would cause the server to
  crash during RESTORE DB operations:
  
   define devclass ltoclass library=manuallib devtype=lto
   define library manuallib libtype=manual
   define drive manuallib ltodrive1
   define path libmgr ltodrive1 srct=server destt=drive
       library=manuallib device=/dev/IBMtape0
  
  A device configuration file that contains the following
  commands in upper-case would not cause the server to
  crash during RESTORE DB operations:
  
   DEFINE DEVCLASS LTOCLASS LIBRARY=MANUALLIB DEVTYPE=LTO
   DEFINE LIBRARY MANUALLIB LIBTYPE=MANUAL
   DEFINE DRIVE MANUALLIB LTODRIVE1
   DEFINE PATH LIBMGR LTODRIVE1 SRCT=SERVER DESTT=DRIVE
       LIBRARY=MANUALLIB DEVICE=/dev/IBMtape0
  
  There are no messages printed to the console during the
  RESTORE DB operation that would help users recognize that
  the crash is being caused by the device configuration file.
  
  Customer/L2 Diagnostics:
  The following failing callstack can be extracted from the
  dump file generated (Linux example):
  
    #0  strcmp ()
    #1  ProcessDevClass ()
    #2  DoLineAsCmd ()
    #3  pvrProcessDevconfig ()
    #4  ssProcessDevconfig ()
    #5  DefineDevClass ()
    #6  AssignRestoreStanzaFromVolHist ()
    #7  icGetRestoreList ()
    #8  RdbAdmRestoreDB ()
    #9  AdmRestoreDb ()
    #10 admRestoreDatabase ()
    #11 RestoreDb ()
    #12 main ()
  
  Initial Impact:
  High
  
  Tivoli Storage Manager Versions Affected:
  All supported Tivoli Storage Manager servers
  
  Additional Keywords:
  TSM CRASH ABEND SEG FAULT PROCESSDEVCLASS DEFINEDEVCLASS
  RESTORE DB RESTOREDB DEV CONFIG DEVCONFIG DEVICE
  

Local fix

• Correct the device configuration file such that commands are
  upper-case.  Review the following TechNote for more
  information:
  
   http://www.ibm.com/support/docview.wss?uid=swg21616047
  

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

Problem conclusion

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

• R63A PSY

     UP

• R63H PSY

     UP

• R63L PSY

     UP

• R63S PSY

     UP

• R63W PSY

     UP

• R71A PSY

     UP

• R71H PSY

     UP

• R71L PSY

     UP

• R71S PSY

     UP

• R71W PSY

     UP