IT32635: THE NODE REPLICATION TABLE IS NOT CREATED IN THE PATH SET IN THE NRTABLEPATH OPTION

APAR status

• Closed as program error.

Error description

• The default location of the node replication table database
  cannot be changed by setting the NRTABLEPATH option for the
  Spectrum Protect API Client in the options file
  dsm.opt on Windows, or dsm.sys on UNIX and Linux.
  If a locking issue concerning the node replication table occurs,
  this might lead to messages in the API Client's dsierror.log:
  
  ANS2124W Client node replication table is locked by another
   process.
  ANS0361I DIAG: dbOpen(): error opening/creating lock file
   'C:\Program Files\Tivoli\TSM\baclient\tsmnrtable.DB.Lock'.
  
  This symptom does not respond to setting NRTABLEPATH.
  
  
  ======================
  Diagnostics:
  
  A service API trace shows the default location used despite the
  NRTABLEPATH option set to a different path, for example
  "X:\CUSTOM_PATH":
  
  [date] [time] [pid] [tid] :
   ..\..\common\opt\optservices.cpp(7997): SrvCanOvrRde(Y)
   Src(0x01=File   )           nrtablepath X:\CUSTOM_PATH
  ........................
  [date] [time] [pid] [tid] : ..\..\common\ba\nrtable.cpp( 361):
   NodeReplicationTable::initialize():
     db File     :
   C:\Program Files\Tivoli\TSM\baclient\tsmnrtable.DB
     max db size : 268435456
  
  .... and a thread [threadA] calls tsmEndSendObj without
  previously calling dsmInitEx and dsmSendObj :
  
   New thread         0================>
  [date] [time] [pid] [threadA] :
   ..\..\api\common\dsmsend.cpp(2437): tsmEndSendObj ENTRY:
   tsmHandle=1
  [date] [time] [pid] [threadA] :
   ..\..\common\ut\instr.cpp(1596): [date] [time] TID: threadA,
   Replace: Other                 , With: API Send Data
  
  
  =======================
  Affected product versions:
  IBM Spectrum Protect API Client version 8.1
  on all platforms
  
  
  =======================
  Initial Impact: Low
  
  
  =======================
  Additional Keywords:
  TS003611359 tsm
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive clients v7.1 and v8.1 running on all          *
  * platforms.                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is fixed in the backup-archive client version     *
  * 8.1.11 on AIX, Linux, Windows platforms.                     *
  * Note 1: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

•  nrtablepath is set according option that was specified in
  server_A.opt
  

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