IBM Support

Some TSM client dedup file backups can be unrecoverable if server pool runs out of storage (IT11994)

Flashes (Alerts)


If a backup or archive operation using TSM client-side deduplication fails with 'ANS1311E Server out of data storage space', under certain conditions the backup or archive of the next file will be reported as successful, but the backup or archive copy of the file is not recoverable.


During IBM Tivoli Storage Manager (TSM) backup or archive operations using client-side deduplication, under certain conditions when the TSM server has little data storage space remaining, a file can be incorrectly backed up or archived by the TSM client with no error message for that file. The restore of an affected backup or archive copy will fail with an error such as 'digest validation error', 'unknown format', or a crash. The data that was intended to be backed up or archived in the copy being restored may not be recoverable.

APAR IT11994 has been opened for this issue.


The backup-archive clients in all TSM releases since client-side deduplication was introduced (in TSM 6.2) are affected, including the following levels:

  • TSM 7.1.0 thru 7.1.3
  • TSM 6.4.0 thru 6.4.3
  • TSM 6.3.0 thru
  • TSM 6.2.0 thru (the 6.2 release has reached End of Support)

Backups or archives performed using the TSM API client are not affected.


All of the following conditions are required for the problem to occur:

  • Client-side deduplication was used for the backup or archive operation
  • The backup or archive of a large file failed because the TSM server reported "out of data storage space" to the TSM client during the operation
  • Examples of circumstances that can cause the out of space error:

      • Not enough space in the primary storage pool
      • Not enough space in the storage container pool introduced with TSM (IBM Spectrum Protect) 7.1.3
      • Not enough space in the next storage pool, if it is also a deduplicated storage pool
      • Not enough scratch volumes
      • Size of the large file exceeds the maximum object size ('maxsize' parameter) for the storage pool
  • There is an additional file (or files) left in the backup or archive session after the large file that failed, and the very next file is small enough to fit in the remaining storage pool space.

Note that if several small files follow the large file in the session and all of them fit in the remaining storage space, only the first file following a failed file can be affected by this issue, as illustrated in this example.


If you use client-side deduplication for your backup or archive operations, examine your client schedule and error logs. If you received these TSM client error messages when backing up or archiving a file: 'ANS1228E Sending of object filename failed' and 'ANS1311E Server out of data storage space', then if the operation completed on the next file without failure, the backup or archive copy of that next file could potentially be affected.

When an affected backup or archive copy is restored, the restore fails with an error such as 'digest validation error', 'unknown format', or a crash.

Use the script and query described in this technote to determine if your TSM server has affected files:


Until you can apply a fixing level, use one of the following circumventions:

  • use server-side deduplication instead of client-side deduplication
  • turn off deduplication


The following client levels fix the issue for future backups and archives. There is no solution that correctly restores the backup or archive copy of an already-affected file. Contact IBM Support for assistance with possible recovery of data in an affected copy of a file.

Backup-Archive Client affected release levels
First level with fix for IT11994 -
available now -
available now -
available now
6.2, all levelsTSM 6.2 has reached end of support; upgrade to a fixing release.
Note: target dates are subject to change at the discretion of IBM

29 October 2015: Original copy published
5 November 2015: Added link to packages

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF014","label":"iOS"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"6.2;6.3;6.4;7.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
25 September 2022