IT32079: IBM SPECTRUM PROTECT(SP) CLIENTS USING THE SP API CAN FAIL WITH NO ERRORS DUE TO AN API CRASH IF A PROXYNODE TARGET IS DEFINED

APAR status

• Closed as program error.

Error description

• IBM Spectrum Protect(SP) clients using the SP API can fail with
  no errors due to an API crash if a proxynode target is defined
  in a domain with an invalid directory management class.
  A crash dump on Windows would look similar to the following:
  Crash dump successfully written to file 'C:\Program
  Files\Tivoli\TSM\baclient\dsmcrash.dmp'
  Stack Trace:
  0x00000000B361FA8B (0x79FCDCB0 0x00000000 0x719E1240 0x00000000)
  dsmc.exe, pbFileBind()+251 bytes
  0x00000000B34E3868 (0x00000000 0x719E1240 0x719E12E9 0x719E1330)
  dsmc.exe, CheckAddDirEntry()+2072 bytes
  0x00000000B34E4514 (0x78FFFEC0 0x0000000F 0x78FEF740 0x76FF0000)
  dsmc.exe, fioGetFirstDirEntry()+900 bytes
  0x00000000B34E4110 (0x7A020A08 0x7906FE60 0x79FC7290 0x78FFFD60)
  dsmc.exe, fioGetDirEntries2()+192 bytes
  0x00000000B38EE010 (0x0000000F 0x00000002 0x00000000 0x00000000)
  dsmc.exe, PrivIncrFileSpace()+864 bytes
  0x00000000B38F6B5F (0x79FC7290 0x00000000 0x79FC7290 0xB3DB5378)
  dsmc.exe, baIncremental()+2399 bytes
  0x00000000B38F91A8 (0x00000000 0x00000000 0x00000000 0x00000000)
  dsmc.exe, baProcessRequest()+3704 bytes
  0x00000000B38FA2AE (0x79FB9E30 0x78F5B4C0 0x78F5B4C0 0xB3DBB190)
  dsmc.exe, baRequestHandler()+1582 bytes
  0x00000000B38FE991 (0x78F5B4C0 0x78EB4670 0x78F5B4C0 0x79ECE8D0)
  dsmc.exe, DccTxnProducer::HandleQueue()+577 bytes
  0x00000000B390032E (0x79ECE8D0 0x79DDE8C0 0x77003490 0x00006684)
  dsmc.exe, DccTxnProducer::Run()+1374 bytes
  0x00000000B3631E67 (0x79DDB0E0 0x00000000 0x00000000 0x00000000)
  dsmc.exe, startThread()+279 bytes
  0x00000000C8E70E72 (0x00000000 0x00000000 0x00000000 0x00000000)
  ucrtbase.dll, beginthreadex()+322 bytes
  0x00000000C9DC7BD4 (0x00000000 0x00000000 0x00000000 0x00000000)
  KERNEL32.DLL, BaseThreadInitThunk()+20 bytes
  0x00000000CB66CED1 (0x00000000 0x00000000 0x00000000 0x00000000)
  ntdll.dll, RtlUserThreadStart()+33 bytes
  A crash dump on Unix/Linux would look like:
  (gdb) where
  #0  0x00007f17e6665b55 in raise () from /lib64/libc.so.6
  #1  0x00007f17e6667131 in abort () from /lib64/libc.so.6
  #2  0x00000000006ff584 in psTrapHandler(int) ()
  #3  <signal handler called>
  #4  0x00000000006e8bfd in pbFileBind(policyObject_t*, char*,
  Attrib*, cliFuncState_t, unsigned int, int) ()
  #5  0x00000000006a4a8b in CheckAddDirEntry(int*,
  GetDirEntryData*) ()
  #6  0x00000000006a510d in fioGetFirstDirEntry(GetDirEntryData*,
  int*) ()
  #7  0x00000000006a5218 in fioGetDirEntries2(policyObject_t*,
  int, int, fileSpec_t*, S_DirEntNode**, S_DirEntNode**,
  cliFuncState_t, int, fileNameLimits*, int, int, int, int,
  DEventCollector*, cliType_t, fsStatsObject*) ()
  #8  0x0000000000557783 in PrivIncrFileSpace(backupPrivObject_t*,
  backupSpec*, nfDate*, unsigned int) ()
  #9  0x0000000000558737 in PrivIncrFileSpace(backupPrivObject_t*,
  backupSpec*, nfDate*, unsigned int) ()
  #10 0x000000000055b3b3 in baIncremental(backupPrivObject_t*,
  backupSpec*) ()
  #11 0x0000000000561129 in baProcessRequest(backupPrivObject_t*,
  backupSpec*) ()
  #12 0x0000000000562b16 in baRequestHandler(backupPrivObject_t*,
  backupSpec*) ()
  #13 0x00000000005ab4a5 in DccTxnProducer::HandleQueue() ()
  #14 0x00000000005abbbd in DccTxnProducer::Run(void*) ()
  #15 0x00000000005abd11 in DccTxnProducer::DoThread(void*) ()
  #16 0x00000000005abd3d in callDoPThread2(void*) ()
  #17 0x00000000006ec589 in startThread2(Threadstart*) ()
  #18 0x00000000006ec5bf in startThread(Threadstart*) ()
  #19 0x00007f17e79707b6 in start_thread () from
  /lib64/libpthread.so.0
  #20 0x00007f17e670cd6d in clone () from /lib64/libc.so.6
  #21 0x0000000000000000 in ?? ()
  Spectrum Protect Versions Affected:
  IBM Spectrum Protect API 7.1.x and 8.1.x
  Initial Impact: Low
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect application programming interface  and  *
  * IBM Spectrum Protect Backup-Archive Client versions 7.1 and  *
  * 8.1 running on all UNIX, Linux and Windows platforms.        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in level 8.1.10. Note that this is subject to    *
  * change at the discretion of IBM.                             *
  ****************************************************************
  

Problem conclusion

• IBM Spectrum Protect will return error instead of crash.
  

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

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels