IBM Support

IC85150: HSM FOR WINDOWS RETRIEVE AND DSMFILEINFO MAY FAIL FOR FILES WITH TRAILING DOLLAR SIGN

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Problem description:
    HSM for Windows does not retrieve and overwrite files with file
    names, that end with a dollar sign, if these files already exist
    in your file system. Command dsmfileinfo does not process files,
    that end with a dollar sign.
    In some situations HSM for Windows considers a file ending on a
    dollar sign as a directory and appends a trailing backslash to
    it.
    
    Affected Products:
    HSM for Windows 6.1.0.0 - 6.1.5.0 (inclusive), 5.3.x.x, 5.4.x.x,
    5.5.x.x.
    
    Customer/L2 diagnostics (if applicable):
    Check if the problem occurs specifically with files ending with
    a dollar sign. Check the trace file of the retrieving
    application (dsmgui.log or dsmclc.log), or dsmfileinfo
    (dsmfileinfo.log), respectively.
    
    DSMGUI (05C4:0A54) _restoreFile
    12-07-09 15:12:46.375
     E: Failure restoring file '\\EDWARDS\E$\file$\file$'
        to target file '\\EDWARDS\E$\file$\file$':
        Errno-value:    0x03000022 (E: File moving failed)
        Originator:     System, error code 183L (0x000000b7L):
    Cannot create a file when that file already exists.
        Message-number: ANS27058E
        Message-text:   Failure retrieving file(s)
    '\\EDWARDS\E$\file$\file$' from TSM server 'tsm61:1500':
         Cannot create a file when that file already exists.
        Explanation:    Requested file(s) could not be retrieved
    from the TSM server.
        System action:  The retrieve operation is aborted.
        User response:  Check server address, configuration and
    permissions, check file space and disk space on file system.
    
    DSMFILEINFO (09F0:07E4) _tmain
    12-07-09 15:10:24.031
     E: Failure running dsmfileinfo:
        Errno-value:    0x03000024 (E: File not found)
        Originator:     <No originator information>
        Message-number: ANS27068E
        Message-text:   The file 'e:\file$\file$' specified as
    parameter was not found
        Explanation:    The file specified as parameter could not be
    found.
        System action:  The program terminates.
        User response:  Specify a path to an existing file.
    
    Additional Keywords: HSM for Windows
    

Local fix

  • Rename or delete files with trailing dollar sign on your file
    system before retrieving them. No local fix for dsmfileinfo
    (despite from renaming the file before analysis).
    

Problem summary

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

Problem conclusion

  • The problem has been resolved.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC85150

  • Reported component name

    TSM HSM FOR WIN

  • Reported component ID

    5698ICNCL

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-07-10

  • Closed date

    2012-08-02

  • Last modified date

    2012-08-15

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

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

Modules/Macros

  • dsmclc   dsmfilei dsmgui
    

Fix information

  • Fixed component name

    TSM HSM FOR WIN

  • Fixed component ID

    5698ICNCL

Applicable component levels

  • R610 PSY

       UP



Document information

More support for: Tivoli Storage Manager HSM for Windows

Software version: 610

Reference #: IC85150

Modified date: 15 August 2012