IT32341: dsmc restore unable to restore orphan stub files but no error logged to the console or stdout.

APAR status

• Closed as program error.

Error description

• If an error occurs during IBM Spectrum Protect for Space
  Management orphan stub file restore, no error logged to the
  console and the return code is 0.
  
  Example:
  > dsmc rest -replace=all -restoremigstate=no </path/filename>
  
  IBM Tivoli Storage Manager
  Command Line Backup-Archive Client Interface
    Client Version 7, Release 1, Level 4.4
    Client date/time: 2020-02-28 15:21:10
  (c) Copyright by IBM Corporation and other(s) 1990, 2016. All
  Rights Reserved.Node Name: <nodename>
  Session established with server ABC: AIX
    Server Version 8, Release 1, Level 6.200
    Server date/time: 2020-02-28 15:21:10  Last access: 2020-02-28
  14:53:37
  Restore function invoked.
  Restore processing finished.
  > echo $?
  0
  
  Although, it should have been as follows instead:
  
  > dsmc rest -replace=all -restoremigstate=no </path/filename>
  IBM Tivoli Storage Manager
  Command Line Backup-Archive Client Interface
    Client Version 7, Release 1, Level 4.4
    Client date/time: 2020-02-28 15:21:10
  (c) Copyright by IBM Corporation and other(s) 1990, 2016. All
  Rights Reserved.Node Name: <nodename>
  Session established with server ABC: AIX
    Server Version 8, Release 1, Level 6.200
    Server date/time: 2020-02-28 15:21:10  Last access: 2020-02-28
  14:53:37
  Restore function invoked.
  
   ** Unsuccessful **
  ANS4023E Error processing 'file-name': file input/output error
  
  Restore processing finished.
  
  Total number of objects restored:             0
  Total number of objects failed:               1
  Total number of bytes transferred:            0  B
  Data transfer time:                        0.00 sec
  Network data transfer rate:                0.00 KB/sec
  Aggregate data transfer rate:              0.00 KB/sec
  Elapsed processing time:               00:00:03
  > echo $?
  12
  
  The intent of the restore was to overwrite the stubs after an
  accidental deletion of migrated file data on the IBM Spectrum
  Protect server side.
  
  This APAR will fix the restore statistics to generate the
  failure message or return code in case of orphan stub restore
  failure.
  
  Customer/Support Diagnostics:
  In this case orphan stub restore fails as there were some GPFS
  snapshot(s) which still reference the affected orphan stub
  hence, dsmrecalld tries to recall the file/files data for these
  orphans and failed as expected.
  
  dsmerror.log:
  ANS2254E dsmrecalld with session id 5E5FC0A4 aborted recall for
  token 0-5ECCA669. ERRNO 5 : Input/output error was set. See
  message explanation.
  ANS9548W Cannot complete remote file access for inode:'65818',
  alias:'orphan'.
  .
  Client "service" trace shows:
  2020-02-28 14:53:38.151 [1010629] [2481501952] : virtstat.cpp
  ( 898): dsmNFSsyscalls: returns(0), errCode(0).
  2020-02-28 14:53:38.151 [1010629] [2481501952] : unxfilio.cpp
  (6068): fioCheckFileAccess: /path/filename is read only. Result
  code = 907
  2020-02-28 14:53:38.151 [1010629] [2481501952] : unxfilio.cpp
  (3365): HlOpen: Opening /path/filename for writing...
  2020-02-28 14:53:38.151 [1010629] [2481501952] : unxfilio.cpp
  (3372): HlOpen: File will be truncated.
  ...
  2020-02-28 14:53:38.151 [1010629] [2481501952] :
  linux/pserrno.cpp   ( 309): TransErrno: Received error from
  open, errno = 5, rc = 164
  
  IBM Spectrum Protect Client Versions Affected:
  IBM Spectrum Protect Backup-Archive clients v7.1.x and 8.1.x on
  AIX and Linux platforms
  
  Initial Impact:
  Medium
  
  Additional Keywords:
  TSM, spectrum protect, recall, orphan stub, restore, TS003394176
  
  Local Fix:
  None
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect backup-archive client versions 7.1.x    *
  * and 8.1.x on all platforms                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in levels 7.1.8.9 and 8.1.10. Note that this is  *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• In case of a temporary inability to overwrite the affected Space
  Management (HSM) migrated files (due to existing Spectrum Scale
  snapshots), the restore operation will honor EIO errors returned
  by the HSM and issue appropriate ANS4023E error messages.
  

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

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels