IC64849: TDP DOMINO MAY CRASH ON FILES WITH LOCAL ACCESS PROTECTION

APAR status

• Closed as program error.

Error description

• TDP Domino cannot correctly add a file to the
  DomDbInfo_t structure that holds the list of databases for
  backup, if the Domino API call dNSFDbOpenExtended returns
  rc = 760, which means: "This database has local access
  protection and you are not authorized to access it"
  In this case required parameters remain undetermined:
      Physical Name  : '<NULL>'
      DB Title       : '<NULL>'
      Modified Date  : '(null)'
      Length         : 0 KB
  .
  When it gets to actually send the listed files to TivSM
  server, TDP Domino may crash on the file that caused RC = 760.
  This crash may happen hours after the occurance of RC = 760,
  depending on processing speed and the file's position within
  the backup order.
  .
  Customer/L2 Diagnostics
  =======================
  domdsm.log
  ----------
  ACD5450E A failure occurred on TSM server session number (0),
           rc = 416
  This database has local access protection and you are not
           authorized to access it
  Backup of mail\xx\XXXX.nsf failed.
  .
  domdsmc trace
  -------------
  domapi.cpp (1813): Exit DDomApi::dNSFDbOpenExtended(DBHANDLE *),
      rc = 760
      #### more lines ####
  domapi.cpp  (3544): Exit DDomApi::dOSLoadString(), rc = 81
  domapi.cpp  ( 855): Exit DDomApi::GetApiError()
  domqeri.cpp (3036): DominoDirOpen failed for db mail\xx\XXXX.nsf
      with 416, msg(This database has local access protection
      and you are not authorized to access it (processing database
      mail\xx\XXXX.nsf))
  domqeri.cpp (3182): Exit processNSFSearchMatchDatabase(),
      rc = 416
      #### many more lines until dsmSendObj() is attempted ####
  domapi.cpp (1813): Exit DDomApi::dNSFDbOpenExtended(DBHANDLE *),
      rc = 0
  backupdb.cpp (1780): NSFDBOPENEXTENDED() was successful for
      mail\xx\XXXX.nsf.
    m_hDb: 0x804
      #### more lines ####
  backupdb.cpp        (4032): Calling DSMSENDOBJ( 0x1, 2 )
    dbDataObjName.fs                      : YYYYYYYY.ZZZZZZ
    dbDataObjName.hl                      : \MAIL\XX
    dbDataObjName.ll                      : \XXXX.NSF.DATA
      #### more lines ####
  dsmapi.cpp          (3555): Exit DDsmApi::ddsmSendObj(), rc = 0
  backupdb.cpp        (4068): DSMSENDOBJ() was successful.
  consumer.cpp        ( 215): Enter consumeToAdsm()
    dsmHandle: 0x1
  tdpthread.cpp       ( 141): Enter pkEventWait()
      #### TRACE END by crash ####
  .
  Note
  ----
  Only the 1st DDomApi::dNSFDbOpenExtended() returns rc = 760,
  while the call repeated before dsmSendObj() exits rc = 0 for
  the same file.
  It is outside the scope of TivSM software to determine what
  made the Domino API return another RC this time.
  The TDP Domino code must be enabled to handle this condition.
  .
  TSM Versions Affected: TDP Domino
         Initial Impact: Medium
    Additional Keywords: TSM RC=760 RC 760 RC760 permission
  

Local fix

• Lookup the files that yield "This database has local access
  protection ..." in domdsm.log and correct their local access
  protection settings, in order to allow successful backup,
  or add them to your exclude list in dsm.opt, in order to
  exclude them from backup.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DP for Lotus Domino clients              *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION                   *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available.           *
  ****************************************************************
  *
  

Problem conclusion

• The problem has been fixed so it no longer occurs.
  

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

• DOMDSMC  DOMDSM
  

Fix information

• Fixed component name

  TDP FOR DOMINO

• Fixed component ID

  5698DPDAP

Applicable component levels

• R55A PSY

     UP

• R55D PSY

     UP

• R55L PSY

     UP

• R55S PSY

     UP

• R55W PSY

     UP

• R55X PSY

     UP

• R55Z PSY

     UP