IT37002: IBM SPECTRUM PROTECT API CRASH DUE TO INSUFFICIENT STACK SIZE

APAR status

• Closed as program error.

Error description

• All forms of IBM Spectrum Protect clients or solutions based on
  direct use of IBM Spectrum Protect API can experience failures
  caused by a crash within API due to undersized stack memory.
  
  Diagnosing the issue further:
  
  Symptoms will vary depending on application. All will show a
  backup failure or the client itself will crash.
  On Windows one can see something like this in the Application
  Event Log:
  ...
  P4: tsmapi64.dll
  ..
  P7: c00000fd
  
  Where P7 value of c00000fd denotes Stack Overflow error.
  Dump analysis will show a stack dump like:
  tsmapi64!__chkstk+0x38
  tsmapi64!StrChr+0x15
  tsmapi64!trOutTSTrMessage+0x9a
  tsmapi64!trVPrintf+0xb1
  tsmapi64!TRACE_VA<wchar_t>+0x36
  tsmapi64!HandleStats+0x187
  tsmapi64!sendRestoreReq+0x2bb
  tsmapi64!tsmProxyGet+0xa90
  tsmapi64!dsmProxyGet+0x7cf
  DpExcEngine+0x3f775
  
  
  IBM Spectrum Protect Versions Affected:
  All versions of IBM Spectrum Protect clients 7.1.x and 8.1.x
  
  Initial Impact: Low
  
  Additional Keywords:
  TS005294449 c00000fd stack overflow
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect API client 7.1.x, 8.1.0, 8.1.2, 8.1.4,  *
  * 8.1.6, 8.1.7, 8.1.8, 8.1.9, 8.1.10, 8.1.11 and 8.1.12        *
  * running on Windows platforms                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the IBM Spectrum      *
  * Protect client  version 8.1.13 on all platforms.             *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• Now IBM Spectrum Protect  API does not crash during TDP Exchange
  restore from VM VSS backup
  

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:

Modules/Macros

• api
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels