IT02162: RESTORE OF SUPER AGGREGATE FAILS WITH RC 1101 - BITFILE NOT FOUND , ERROR ANS1314E

IBM Tivoli Storage Manager (TSM) server V7.1.0.x interim fix downloads

APAR status

• Closed as program error.

Error description

• A restore from backup operation fails because the bitfile is not
  found yet the bitfile exists.    The server activity log
  indicates:
  ANR0548W  "Retrieve or  restore failed for session ### for node
  NODE_NAME (Filespace) processing file space Filespace # for file
  \FilespaceL\File.name  stored as Backup - error detected
  (SESSION: ###)".  No further information is given.
  
  The Backup/Archive Client returns ANS1314E, "File data currently
  unavailable on  server."
  
  Customer/L2 Diagnostics (if applicable)
  1)  issue the following to get the bfid
        select object_id from backups where
  node_name='NODENAME_INCAPS' and  ll_name='File.name'
  
  2) Issue Show BFO on the bfid to get the volume information
  Example:
     ANS8000I Server command: 'show bfo 1227242519'.
     Bitfile Object: 1227242519
     **Super-Bitfile 1227242519 is a Super Aggregate with 161
  fragments
  
     **Fragment 0, bitfile 1227242519, pendingId: -1
     Active
     **Disk Bitfile Entry
     Bitfile Type: PRIMARY  Storage Format: 22
     Logical Size: 10487247280  Physical Size: 10489171968  Number
  of Segments: 1, Deleted: False
     Storage Pool ID: 34  Volume ID: 110445  Volume Name:
  /dev/rtsmbkp14
     ...
     (output snipped for brevity - all fragments 0 to 160 appear
  in the output)
  
  3) Run Show Damaged on primary pool and determine if any objects
  are marked as damaged. Correct as needed.
  
  4) If no damaged objects are found get a server trace with
  BFAGGR BFSAGGR BFRTRV trace classes.
  
     Tracing will show:
     21412002:20:48:22.372
  [1080576][output.c][7407][PutConsoleMsg]:ANR0406I Session 493990
  started for node Node_name (Filespace) (Tcp/Ip
  192.168.3.11(61512)).~
     21412933:20:48:22.477
  [1080576][bfsaggr.c][423][bfGetSuperAggregateInfo]:Looking for
  bfId 1228055443 in poolId 0, thisFragOnly=No
     21413025:20:48:22.488
  [1080576][bfsaggr.c][734][bfGetSuperAggregateInfo]:Exiting for
  1227242519, rc 0, count is 160
     21413028:20:48:22.488 [1080576][bfrtrv.c][973][bfRtrv]:After
  UTST statements, offset is 241, length is 33792
     21413099:20:48:22.496
  [1080576][bfaggrut.c][4303][BfGetBitfileOwner]:Exit, rc 1101.
  Owner of 1227242519 is 0 with digest type 0
     21413159:20:48:22.503
  [1080576][output.c][7407][PutConsoleMsg]:ANR0548W Retrieve or
  restore failed for session ### for node Node_name (Filespace)
  processing file spaceFilespace # for file \subdir\File.Name
  stored as Backup - error detected.~
     21413448:20:48:22.536
  [1080576][output.c][7407][PutConsoleMsg]:ANR0403I Session ###
  ended for nodeNode_name (Filespace).~
  
     #define GRC_BITFILE_NOT_FOUND                   1101
  
  *NOTE*
  The object may resides on more than 1 volume.
  All volumes were available.
  
  Platforms affected:
  All platforms 7.1.
  
  Initial Impact: Medium
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All Tivoli Storage Manager server users.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 7.1.1. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Affected platforms:  AIX, HP-UX, Solaris, Linux, and Windows.
  

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:

Fix information

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels

• R71A PSY

     UP

• R71H PSY

     UP

• R71L PSY

     UP

• R71S PSY

     UP

• R71W PSY

     UP