IBM Support

IT24873: INVALID LENGTH VALUE FOR PARTIAL RETRIEVE MAY GET TOO MUCH DATA

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as change to accomodate OEM Vendor's code.

Error description

  • Under certain conditions, in dsmBeginGetData(), the
    IBM Spectrum Protect API client may request an invalid
    data length for partial object retrieve.
    As a result, more data is retrieved than expected,
    which in turn takes more time than expected.
    The investigated system did not show any malfunction nor error.
    
    Customer/L2 diagnostics
    =======================
    API client trace with 'traceflag service' showing
    file attributes and two partial retrieve requests
    -------------------------------------------------
    04/04/2018 11:05:57.314 [008652] [564229920] :
     cuqrepos.cpp        (2722): ApiNetToAttrib:
     obj compressed: >NO< encrypt type :>NO< encryptAlg >UNKNOWN<
     clientdedup >NO< SizeEstimate >8 297680384<
    04/04/2018 11:05:57.314 [008652] [564229920] :
     dsmnextq.cpp        (1511): apicuGetArchQryResp: owner ><
     Name fs=>/fs_name< hl=>/path/appdir< ll=>/file.ext<
     id hi:0 lo:441813207
        ...
    03/22/2018 13:23:40.195 [008165] [4234602272] :
     dsmget.cpp          (4168): ApiObjRtrv: partial obj restore
     objid: 0 441813207, offset: 0 12288,
     length: 140720308486144 140720308486144                   <<==
        ...
    03/22/2018 13:29:29.187 [008165] [4234602272] :
     dsmget.cpp          (4168): ApiObjRtrv: partial obj restore
     objid: 0 441813207, offset: 0 12365,
     length: 0 140630114172928                                 <<==
    
    show invo 441813207
    -------------------
    Inventory object 441813207 of copy type Archive has attributes:
      NodeName: NODE, Filespace(6): /fs_name,
      ObjName: /path/appdir/file.ext.
      hlID: F401E51FAC4D7DC03247A3069E0F60FDD0C013E4
      llID: 7F103F8FFD044DEDDB80A7FA3C8948DA7E16FE29
      objType: FILE, objId: 441813207, size: 34657418752,
     flags 0000, mcName: MCLASS
      hasDir: yes, owner: (none), desc:
      Inserted 01/06/2016 05:44:34 AM (UTC 01/06/2016 04:44:34 AM),
     retention initiated 01/06/2016 05:44:34 AM
    Bitfile Object: 441813207
    **Archival Bitfile Entry
      Bitfile Type: PRIMARY  Storage Format: 22
      Bitfile Size: 34661650934  Number of Segments: 1, flags: 0
      Storage Pool ID: 12  Volume ID: 34567  Volume Name: V_NAME
    
    Accepting two 32-bit integers, the maximum allowed value for
    length would be in theory:
        length: 4294967296 4294967296
        (          2^32       2^32          )
    
    In practice the length value must not tbe greater than the
    length of the object. This file is about 34 GB:
        length: 8 297680384
        ( SizeEstimate >8 297680384< = size: 34657418752 )
    
    or the offset in addition to the length must not extend past
    the end of the object.
    
    Product versions affected: IBM Spectrum Protect client 7.1
               Initial impact: Medium
          Additional keywords: offset length restore
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IBM Spectrum Protect API versions 7.1.0-7.1.6 and            *
    * 8.1.2-8.1.6 on all platforms.                                *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is projected *
    * to be fixed in level 8.1.6. Note that this is                *
    * subject to change at the discretion of IBM.                  *
    ****************************************************************
    

Problem conclusion

  • After the fix partial lenght value correctly logged in trace
    file during partial data retrieve.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT24873

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71L

  • Status

    CLOSED OEM

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-04-26

  • Closed date

    2018-06-11

  • Last modified date

    2018-06-29

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

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

Modules/Macros

  • DSMAPI
    

Fix information

Applicable component levels

  • R81L PSY

       UP

  • R81W PSY

       UP

  • R81S PSY

       UP

  • R81A PSY

       UP

  • R81H PSY

       UP

  • R81S PSY

       UP

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

Document Information

Modified date:
28 September 2021