IBM Support

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

Subscribe

You can track all active APARs for this component.

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

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 number

    IT04589

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    63L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-09-24

  • Closed date

    2015-04-02

  • Last modified date

    2015-04-02

  • 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



Document information

More support for: Tivoli Storage Manager

Software version: 63L

Reference #: IT04589

Modified date: 02 April 2015