IBM Support

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

Subscribe

You can track all active APARs for this component.

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 number

    IT17338

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71L

  • Status

    CLOSED FIN

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-10-04

  • Closed date

    2017-07-31

  • Last modified date

    2017-07-31

  • 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



Document information

More support for: Tivoli Storage Manager

Software version: 71L

Reference #: IT17338

Modified date: 31 July 2017