IT17338: CLIENT STOPS A RESTORE OPERATION IF AN "ANS1154E" ERROR IS ENCOUNTERED IN CLASSIC RESTORE MODE.

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

APAR status

• Closed as fixed if next.

Error description

• Client stops a restore operation if an ANS1154E error is
  encountered in classic restore mode.
  The file/directory with incorrect symbols should be skipped and
  restore should continue.
  No-query restore is inactive when options " -inactive" and/or
  "-latest" are used.
  
  For example a restore runs with:
  
  dsmc restore -sub=yes -inactive -latest  /home/data/test/
  
  and stops with:
  
  Total number of objects restored:         1,311
  Total number of objects failed:               0
  Total number of bytes transferred:            0  B
  Data transfer time:                        0.00 sec
  Network data transfer rate:                0.00 KB/sec
  Aggregate data transfer rate:              0.00 KB/sec
  Elapsed processing time:               00:00:26
  
  ANS1154E Object name '/data' contains an invalid multibyte
  sequence for
  the current locale.
  
  The problem file/directory is the last one displayed as
  "Restoring" before "Total number of objects restored" if the
  restore is run in 'verbose' mode.
  
  A "service" trace will display at time of failure.
  
  08/22/2016 16:14:53.696 [007486] [726574848] :
  DccRestoreConsumer.cpp(2385): HandleEndRequest: Not sending end
  signal.
  08/22/2016 16:14:53.696 [007486] [726574848] :
  DccRestoreConsumer.cpp(2386): HandleEndRequest: noQryRestore ==
  bFalse
  08/22/2016 16:14:53.696 [007486] [726574848] : session.cpp
  (2354): Sess (0x1358e90) FREELOCK lock action by thread
  (2b4ea700):
  08/22/2016 16:14:53.696 [007486] [726574848] :
  DccRestoreConsumer.cpp(1243): HandleQueue: Leaving Consumer with
  rc: 207
  08/22/2016 16:14:53.696 [007486] [726574848] : thrdmgr.cpp
  (
  912): Thread 1st Restore Consumer exiting, result =207
  
  
  Tivoli Storage Manager versions affected:
  Client 6.3.x, 6.4.x and 7.1.x on all supported platforms
  
  
  
  
  Initial Impact: Low
  
  Additional Keywords:  TSM restore failure fails stops
  

Local fix

• If able to do so, split up restore so that problem
  directory/file(s) are not restored.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 6.4, 7.1 running on           *
  * Unix/Linux platforms.                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

Temporary fix

Comments

• If there is a next release of Tivoli Storage Manager after 7.1,
  this APAR will be fixed in that next release.
  

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

Applicable component levels

• R71L PSN

     UP

• R71A PSN

     UP

• R71H PSN

     UP

• R71S PSN

     UP

• R71M PSN

     UP