IT40861: LONG-RUNNING CLIENT OR API APPLICATIONS CAN FAIL WITH FILE OPEN ERRORS SUCH AS ANS9178E, ANS0282E, ANS1035S, RC 168, RC 406

APAR status

• Closed as program error.

Error description

• Backup-archive client and API applications that run for a long
  period of time can eventually experience operation failures due
  to too many open file handles.
  
  
  The problem affects client nodes that are configured for
  automatic failover to a replication server and that do repeated
  sign-on to the IBM Spectrum Protect server. For example, Db2
  using the API for backup, or client schedulers that are not
  managed by the CAD.
  
  
  Known symptoms include any of these messages in dsmerror.log or
  
  dsierror.log when the client fails to open or read from existing
  
  files:
  
   ANS0361I DIAG: ..\..\common\ut\instr.cpp( 847): instrStop:
     Unable to get write file lock or report file handler.
  
  
   ANS9178E <program-name> cannot open file <file-spec> due to
     the following error: Too many open files.
  
  
   ANS0282E Password file is not available.
  
  
   ANS1035S Options file '*' could not be found, or it cannot be
     read.
  
  
  For Db2, the db2diag.log file might contain messages like one
  of
  these:
  
   FUNCTION: DB2 UDB, database utilities, sqluvint, probe:292
   TSM RC=0x000000A8=168 -- see TSM API Reference for meaning.
  
  
   FUNCTION: DB2 UDB, database utilities, sqluvint, probe:292
   DATA #1 : TSM RC, PD_DB2_TYPE_TSM_RC, 4 bytes
   TSM RC=0x00000196=406 -- see TSM API Reference for meaning.
  
  
  The leaked handles are for dsm.sys (AIX and Linux) or dsm.opt
  (Microsoft Windows) and a copy of the same file with ".tmp" at
  the end of the name (dsm.sys.tmp or dsm.opt.tmp). On Windows,
  the options file might have a different name such as
  DB2.OPT.tmp.
  
  The temporary copy ("xxx.tmp") should normally be deleted before
  the process ends. However, the file is left over at the end of
  the process.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client and API versions 8.1.13.x and 8.1.14.x *
  * on all platforms                                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Support for multi-target replication failover added as of    *
  * version 8.1.13 inadvertently introduced file handle leaks.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.1.15. Note that this is     *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• The file handle leaks are eliminated and the "xxx.tmp" temporary
  file is no longer left over when the process ends.
  

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

•    DSMAGENT DSMC     DSMCAD   DSMCSVC  TSMAPI64
  LIBAPITS
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels