APAR status
Closed as program error.
Error description
The IBM Spectrum Protect Client for Space Management (HSM) transparent recall might not be able to recall the migrated files as entire file if Space Management partial recall is executed for the migrated files after the Scale SOBAR restore. The problem affects HSM migrated files which were either premigrated or partially recalled at SOBAR backup time. Customer/Support Diagnostics (If Applicable): ----------- Example output of dsmls command after SOBAR backup ----------------- IBM Spectrum Protect Command Line Space Management Client Interface Client Version 8, Release 1, Level 12.0 Client date/time: 10/07/2021 07:06:04 (c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved. ActS ResS ResB FSt FName <dir> 4096 1 - 10mb/ /gpfs0/10mb: 11813880 11813880 11544 p 10m_000.dat 12206080 4194304 4096 m (p) 10m_001.dat --------------------------------------------------------------- ---------- ---------- Example output of dsmls command after restored SOBAR backup ---------- IBM Spectrum Protect Command Line Space Management Client Interface Client Version 8, Release 1, Level 12.0 Client date/time: 10/07/2021 07:24:24 (c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved. ActS ResS ResB FSt FName <dir> 8192 8 - 10mb/ /gpfs0/10mb: 11813880 0 0 m 10m_000.dat 12206080 4194304 0 m (p) 10m_001.dat ( <=== inconsistent "ResS" size; it should have been "0" instead ) --------------------------------------------------------------- ---------- # dsmattr -recall=partialrecall /gpfs0/10mb/10m_000.dat # dsmrecall -offset=0 -size=4M /gpfs0/10mb/10m_000.dat # dsmls /gpfs0/10mb/10m_001.dat IBM Spectrum Protect Command Line Space Management Client Interface Client Version 8, Release 1, Level 12.0 Client date/time: 10/07/2021 12:53:47 (c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved. ActS ResS ResB FSt FName 11813880 11813880 4096 p 10m_000.dat ( <=== unexpected HSM migration state; it should have been "m(p)" instead. Also, the contents of such a premigrated file is corrupted. In particular, the rest of file (after the very first 4M correct portion) is full of zeroes) # dsmrecall -offset=0 -size=4M /gpfs0/10mb/10m_001.dat # dsmls /gpfs0/10mb/10m_001.dat IBM Spectrum Protect Command Line Space Management Client Interface Client Version 8, Release 1, Level 12.0 Client date/time: 10/07/2021 12:53:47 (c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved. ActS ResS ResB FSt FName 12206080 8388608 4096 m (p) 10m_001.dat ( <=== inconsistent "ResS" size; it should have been "4194304" instead ) A subsequent try to recall the whole file contents leads to a corrupted premigrated file (the last 4M portion of such file is full of zeros): # du -s /gpfs0/10mb/10m_001.dat 4096 /gpfs0/10mb/10m_001.dat # cp /gpfs0/10mb/10m_001.dat 10m_001.dat.new ( <== Transparent recall was executed.) # du -s /gpfs0/10mb/10m_001.dat 8192 /gpfs0/10mb/10m_001.dat ( <== The actual file size of recalled file was not 11920 KB (12206080 Byte). ) # du -s 10m_001.dat.new 11920 10m_001.dat.new ( <== The copied file size was 11920 KB but the its content was broken. ) # dsmls /gpfs0/10mb/10m_001.dat IBM Spectrum Protect Command Line Space Management Client Interface Client Version 8, Release 1, Level 12.0 Client date/time: 10/07/2021 12:56:36 (c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved. ActS ResS ResB FSt FName 12206080 12206080 8192 p 10m_001.dat IBM Spectrum Protect Versions Affected: Space Management Client for Unix and Linux 7.1.x and 8.1.x on all supported platforms Initial Impact: middle Additional KEYWORDS: Spectrum Protect; HSM; TS007044036; recall; premigrated
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Spectrum Protect for Space Management (HSM) client * * versions 7.1.x and 8.1.x on AIX GPFS and Linux GPFS * * platforms * **************************************************************** * PROBLEM DESCRIPTION: * * See ERROR DESCRIPTION. * **************************************************************** * RECOMMENDATION: * * Apply fixing level when available. This problem is projected * * to be fixed in IBM Spectrum Protect for Space Management * * client level 8.1.13. Note that this is subject to change at * * the discretion of IBM. * ****************************************************************
Problem conclusion
After the fix, the HSM transparent recall will consistently get the file data back regardless of the migration state the file was in at the SOBAR backup time.
Temporary fix
Comments
APAR Information
APAR number
IT38823
Reported component name
TSM SPACE MGMT
Reported component ID
5698HSMCL
Reported release
81L
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-10-26
Closed date
2021-12-09
Last modified date
2021-12-09
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
dsmrecal
Fix information
Fixed component name
TSM SPACE MGMT
Fixed component ID
5698HSMCL
Applicable component levels
[{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSSR2R","label":"Tivoli Storage Manager for Space Management"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"81L"}]
Document Information
Modified date:
10 December 2021