IBM Support

IT07640: TIVOLI STORAGE MANAGER CLIENT GUI HANGS WHEN PERFORMING A SEARCH AND ENCOUNTERING A MULTIBYTE CHARACTER

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The Tivoli Storage Manager Client GUI (dsmj) may hang when
    issuing a search through archive or backup objects and one is
    found which contains a multibyte character (eg umlaut).
    
    The file count displayed for "Files inspected" will not progress
    past this point and the GUI will hang until cancelled.
    
    
    Tivoli Storage Manager Versions Affected:
    All supported versions and all supported Unix operating systems
    
    Customer/L2 Diagnostics (If Applicable)
    Obtaining a client service trace and also a Java trace will show
    we find a filename containing a multibyte character :
    
    cuqrepos.cpp        (1771): NetToAttrib(): maj: 6, min: 6, os:
    12, fs: 2, client: 1, fileSize: 96
    cuqrepos.cpp        (1775):                type: 586, build: 0,
    mod: 0, attrOnly: 0
    cuqrepos.cpp        ( 662): cuGetArchQryResp: fsID: 9, hl:
    '/dir1/dir2', ll: '/Produktivitトt', objType: DIR
    cuqrepos.cpp        ( 667):                   type: 1112,
    fileSize: 96, mgmtClass: 1, copyGroup: 1
    cuqrepos.cpp        ( 671):                   insDate: 05/19/03
    10:16:48, defunct: false, owner: 'Scan Start Time: Thu Sep 19
    10:21:16 2002'
    cuqrepos.cpp        ( 675):                   expDate: 00/00/35
    00:00:00, versId: 0.47489497387433, restOrder: 0.0.0.0.0,
    mediaClass: fixed
    cuqrepos.cpp        ( 691):                   descr: 'Scan Start
    Time: Thu Sep 19 10:21:16 2002'
    dicuqry.cpp         ( 956): =========> Entering
    dicuSendArchQryResp()
    
    but within the Java trace taken at the same time, we appear to
    pass an empty string :
    
    SessID=2, IM (imArchQry): Exiting
    SessID=2, DcgServerRvFileSystemTree (cgGetFileEntries): Exiting
    SessID=2, DcgServerRvFileSystemTree (cgGetNodeEntries): Exiting
    DcgFilterEngine.traverseTree() -> go through childs :
    Entering DcgFilterEngine.traverseTree(,false
    DcgFilterEngine.traverseTree() -> current node is :
    Entering DcgFilterEngine.matchesSearchObjType()
    Entering DcgFilterEngine.nodeMatches(,false)
    Entering DcgFilterEngine.matchesFileType()
    DcgFilterEngine.traverseTree() -> is a search load the node :
    
    
    SessID=2, DcgServerRvFileSystemTree (cgArchQryCallBack): fsID =
    9 hl = /dir1/dir2 ll =
    DcgFileSystemTree::cgSetMCName: mcList.size = 4
    DcgFileSystemTree::cgSetMCName: mcListElement.mcNum =
    15cAttr.mcNum = 1
    
    Note :
    The "current node" and "ll=" are both blank.
    
    This was caused by the locale used and the Backup/Archive client
    not handling the returned value from the system call mbstowcs()
    which leads to an endless loop. In the above example, the LANG
    was set to "en_us" and LC_ALL was set to "Posix". The multibyte
    character encountered could not be translated correctly to
    unicode.
    
    Changing the local so that LANG=en_US and LC_ALL=en_US resolved
    the issue and allowed the search to continue.
    
    Initial Impact: Low|Medium|High
    Low
    
    Additional Keywords:
    TSM java hang
    

Local fix

  • Amend the locale that the client GUI is ran in to a supported
    locale for the character set used. Eg, before running dsmj :
    
    export LANG=en_US
    export LC_ALL=en_US
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Tivoli Storage Manager backup-archive client versions 6.3,   *
    * 6.4 and 7.1 on all platforms                                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed in levels 6.4.3 and 7.1.3.             *
    * Note that until these levels are available, this information *
    * is subject to change at the discretion of IBM.               *
    ****************************************************************
    *
    

Problem conclusion

  • The problem has been fixed so that it no longer occurs.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT07640

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    63L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-03-11

  • Closed date

    2015-05-19

  • Last modified date

    2015-05-19

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Modules/Macros

  • dsmagent
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R64A PSY

       UP

  • R64H PSY

       UP

  • R64L PSY

       UP

  • R64M PSY

       UP

  • R64S PSY

       UP

  • R64W PSY

       UP

  • R71A PSY

       UP

  • R71H PSY

       UP

  • R71L PSY

       UP

  • R71M PSY

       UP

  • R71S PSY

       UP

  • R71W PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"63L","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
07 January 2022