IT30753: "ANS4018E FILENAME TOO LONG" DURING RESTORE OR RETRIEVE OF DIRECTORY WITH 255 BYTES ON UNIX / LINUX PLATFORM

APAR status

• Closed as program error.

Error description

• The backup-archive client for UNIX and Linux supports file and
  directory names that are up to 255 bytes in length. However, the
   following error occurs during restore or retrieve of a
  directory if its name is exactly 255 bytes long:
  
  ANS4018E Error processing
  '/filesystem/directory/test/longdirectorynamelongdirectorynamelo
  ngdirectorynamelongdirectorynamelongdirectorynamelongdirectoryna
  melongdirectorynamelongdirectorynamelongdirectorynamelongdirecto
  rynamelongdirectorynamelongdirectorynamelongdirectorynamelongdir
  ectorynamelongdirectoryname': file name too long
   ** Unsuccessful **
  ANS4007E Error processing
  '/filesystem/directory/test/longdirectorynamelongdirectorynamelo
  ngdirectorynamelongdirectorynamelongdirectorynamelongdirectoryna
  melongdirectorynamelongdirectorynamelongdirectorynamelongdirecto
  rynamelongdirectorynamelongdirectorynamelongdirectorynamelongdir
  ectorynamelongdirectoryname': access to the object is denied
  
  While file objects are not affected by this problem, if any
  directory name that is part of the file's path is exactly 255
  bytes, the restore does not work. will not work because the long
  named parent directory will fail.
  But restoring the long file name to an alternate location
  without its failing parent directory will work.  See the Local
  fix below if needed.
  
  
  IBM Spectrum Protect backup-archive client versions affected:
     V7.1 or V8.1 on Unix platforms
  
  
  Initial Impact: Medium
  
  Additional Keywords: TS002800476  TSM
  

Local fix

• - For file located in a path with a 255 bytes directory, restore
  it to an alternate location with smaller directory name and with
   option -preservepath=none , then copy the file to the needed
  location.
  Example =>
  "dsmc restore /some/long/dir_with_255_bytes/myfile.txt
  /some/short/dir/  -preservepath=none"
  
  - Until the fix is applied, restoring the 255 bytes directory
  itself is not possible.
  

Problem summary

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

Problem conclusion

• IBM Spectrum Protect client has been fixed and objects which
  have 255 byte length will be restored/retrieved without errors.
  

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