IC94067: HSM FOR WINDOWS RECONCILIATION CREATES ORPHANS FOR FILE NAMES EXCEEDING 259 CHARACTERS

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • HSM for Windows Reconciliation process doesn't recognize files
    with names longer than 259 characters and handles them as 'not
    found'. File names consist of full path and file name including
    drive letter, colon, backslash and name components separated by
    backslashes. Because a stub file with such long name is not
    found on the file system, the corresponding file content on TSM
    server filespace is deleted by reconciliation process and the
    stub file on the Windows file system becomes an orphan. Also the
    orphan stub files with names longer than 259 characters cannot
    be detected by HSM for Windows and therefore the following
    reconcile run does not stop with error and those orphan stub
    files are not listed in the orphan log file.
    HSM for Windows versions 6.4.0 and higher are not affected.
    
    Recommendation:
    Unconfigure volumes for reconciliation until you have applied
    the APAR fix or installed HSM for Windows version 6.4.0 or
    higher.
    After you have applied the fix or installed version 6.4.0 or
    higher, configure volumes for reconciliation again.
    
    Affected Products:
    Tivoli Storage Manager HSM for Windows versions
    5.5.0.0 - 5.5.3.1, 6.1.0.0 - 6.1.5.1, 6.3.0.0 - 6.3.1.0
    
    Customer/L2 diagnostics:
    An orphan stub is created if the following error message for a
    path longer than 259 characters is displayed in hsmmonitor.log
    for an existing stub file in the file system.
    For example:
    HSMMONITOR (05C8:0C98) NtfsVolume::scanFiles
    13-07-05 05:56:24.142
     W: FindFirstFile failed for path:
    'H:\l00400-10\subdir001\subdir002\subdir003\subdir004\subdir005\
    subdir006\subdir007\subdir008\subdir009\subdir010\subdir011\subd
    ir012\subdir013\subdir014\subdir015\subdir016\subdir017\subdir01
    8\subdir019\subdir020\subdir021\subdir022\subdir023\subdir024\su
    bdir025\subdir026\subdir027\subdir028\subdir029\subdir030\subdir
    031\subdir032\subdir033\subdir034\subdir035\subdir036\subdir037\
    subdir038\*' dwError: '3' ('ERROR_PATH_NOT_FOUND').
    
    In hsmmonitor-delete-<DATE>-<TIME>.log
    A record for a file name longer than 259 characters indicates
    the problem.
    For example:
    hsmmonitor-delete-20130709-081612.log
    DATE="2013-07-09" TIME="05:06:39"
    LFNAME="\\WIN2008R2\H$\l00300-10\subdir001\subdir002\subdir003\s
    ubdir004\subdir005\subdir006\subdir007\subdir008\subdir009\subdi
    r010\subdir011\subdir012\subdir013\subdir014\subdir015\subdir016
    \subdir017\subdir018\subdir019\subdir020\subdir021\subdir022\sub
    dir023\subdir024\subdir025\subdir026\subdir027\subdir028\subdir0
    29\subdir030\subdir031\subdir032\subdir033\subdir034\subdir035\s
    ubdir036\subdir037\NewFile_template_for_review_8_1" LFVERS="1"
    LSERVER="172.16.12.112:1500" LNODE="WIN2008R2" RESULT="Marked"
    SEVERITY="I"
    
    Please note: Orhan stub files with names longer than 259
    characters will not be reported in hsmmonitor-orphan.log.
    
    You can query the backups on TSM server for file names longer
    than 259 characters using the following example for dsmadmc
    command:
    dsmadmc -id=smtest -pa=samplepw -tabd
    -outfile=IC94067_candidates.out "select filespace_name
    || hl_name || ll_name, 2 + length(hl_name) + length(ll_name)
    from backups where node_name='<node_name>' and
    (2+length(hl_name)+length(ll_name)>259) order by 2 desc"
    
    Or HSM archive can be queried for migrated files with long
    names. The 'select from archives' command is inaccurate for the
    length of computer name, because hl_name includes computer name.
    You can correct that by inserting the number '259 + length of
    computer name' instead of 259.
    dsmadmc -id=admin -pa=admin -tabd -outfile=
    IC94067_candidates.out "select
    hl_name || ll_name, length(hl_name) + length(ll_name) from
    archives where node_name='<node_name>' and
    (length(hl_name)+length(ll_name)>259) order by 2 desc"
    
    The parameters are:
    -id is your id
    -pa is your password
    <node_name> is node name of TSM Backup/Archive client backup
    pool.
    
    
    Initial Impact:
    high
    
    Additional Keywords:
    Reconcile orphan
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: TSM HSM for Windows Client Versions          *
    *                 5.5.0.0 - 5.5.3.1, 6.1.0.0 - 6.1.5.1         *
    *                 6.3.0.0 - 6.3.1.0                            *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * For detailed description see ERROR DESCRIPTION               *
    ****************************************************************
    * RECOMMENDATION: Apply fixing level when available. This      *
    *                 problem is currently projected to be fixed   *
    *                 in fixes later than 6.3.1                    *
    ****************************************************************
    

Problem conclusion

  • The problem has been fixed
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC94067

  • Reported component name

    TSM HSM FOR WIN

  • Reported component ID

    5698ICNCL

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-07-12

  • Closed date

    2013-08-05

  • Last modified date

    2013-08-05

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

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

Fix information

  • Fixed component name

    TSM HSM FOR WIN

  • Fixed component ID

    5698ICNCL

Applicable component levels

  • R630 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Storage Manager HSM for Windows

Software version:

610

Reference #:

IC94067

Modified date:

2013-08-05

Translate my page

Machine Translation

Content navigation