IT21657: ANS9999E MESSAGE WITH FILE ACCESS ERROR RETURN CODE 1359 CAUSES AN ANS1999E AND STOPS THE BACKUP

IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs
IBM Spectrum Protectâ„¢ Client 8.1.4 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• If a corrupted file is encountered during a backup it may cause
  the backup to stop instead of skipping the file and continuing.
  The messages seen in dsmerror.log are:
  
   ANS9999E ..\..\common\winnt\ntrc.cpp(767): Received Win32 RC
  1359 (0x0000054f) from FileOpen(): CreateFile. Error
     description:An internal error occurred .
  ANS1999E Incremental processing of '\\uncname\x$' stopped.
  
  
  Tivoli Storage Manager  / IBM Spectrum Protect Versions
   Affected:  Client  V6.3.x, V6.4.x, V7.1.x and V8.1.x on
              Windows platforms.
  
  Customer/L2 Diagnostics:
  
  - A client trace taken with "service" flag will allow to
  identify the file like in the below extract:
  
   \common\fio\ntfileio.cpp(7994):
     FileOpen(\\uncname\x$\path\filename.xxx): Entry.
   \common\fio\ntfileio.cpp(8086): FileOpen(): Opening
     '\\uncname\x$\path\filename.xxx'
   \common\winnt\ntrc.cpp( 732): TransWin32RC(): Translated Win32
    RC 1359 (0x0000054f) from FileOpen(): CreateFile to TSM RC 131
   \common\ut\GlobalRC.cpp( 428): msgNum = 9999 changed the Global
    RC.
  
  
  Initial Impact: Low
  
  Additional Keywords:  TSM corruption win32rc
                        ERROR_INTERNAL_ERROR
  

Local fix

• - Exclude the affected file from the backup
  - Contact the system administrator to take action to correct the
    affected file(s)
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 6.3, 6.4, 7.1 and 8.1 running *
  * on all Microsoft Windows platforms.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.8 and 8.1.4 on all Microsoft Windows      *
  * platforms.                                                   *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The client has been fixed so the Windows return code 1359
  (ERROR_INTERNAL_ERROR) will be mapped to RC_ACCESS_DENIED. So,
  the error message is logged for the file, and the backup
  continues with the next object.
  

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

• R71W PSY

     UP

• R81W PSY

     UP