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

IBM Spectrum Protectâ„¢ Client 8.1.6 Downloads and READMEs

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 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