IC80127: AFTER UPGRADE FROM 5.X TO 6.X, ARCHIVED DIRECTORIES EXPIRE EVEN IF THERE ARE STILL DEPENDANT FILES

APAR status

• Closed as program error.

Error description

• On a Tivoli Storage Manager Server that has been upgraded from
  version 5 to version 6, directories archived prior to the
  upgrade expire when the retention period for the management
  class they are bound to is reached even if there are still files
  dependant on these directories.
  
  Only directories archived at version 5 before the upgrade to
  version 6 are affected.  Directories archived after the upgrade
  to version 6 are not affected.
  
  Users performing the retrieve from the GUI or webclient will not
  be able to browse the directory structure if the directories
  have been expired.
  
  Users performing the retrieve from the command line will not
  notice a problem, however since the directories are not
  available for retrieve, they will get created using the default
  permissions and attributes rather than the original permissions
  and attributes.
  
  Customer/L2 Diagnostic:
  Using DB2 select queries, it's possible to query the
  archive_objects table to see if the PARENTHL column has a value
  or not.  For example, if we know the archive was done on
  2011-05-03 for node: NODE1
  
  db2 connect to tsmdb1
  db2 set schemat to tsmdb1
  db2 select nodeid from nodes where nodename='NODE1'
  (use the value returned in the command above with the command
  below, for the example, let's assume the nodeid returned was 97)
  db2 "select HL,LL,OBJID,DESCR,PARENTHL from archive_objects
  where nodeid=97 and date(insdate)='2011-05-03'" > select.out
  
  Consult select.out and check if the PARENTHL column is populated
  or has a NULL value.  If there are only NULL values, this APAR
  applies.
  
  Versions Affected:
  Tivoli Storage Manager version 6.1, 6.2 or 6.3 that was upgraded
  from version 5.x.
  
  Initial Impact:
  Medium
  
  Additional Keywords:
  imar_parenthl
  

Local fix

• To retrieve files from the GUI:
  - click on Retrieve as normal.
  - from the left pane, select the archive to retrieve from
  - from the Edit menu, click on Find
  - in the Filename drop down, select a proper filter and enter a
  filename in the field next to it
  - click on Search to find the file
  - retrieve the file
  
  Alternatively, perform the retrieve from a command line.  If
  necessary, use the -pick option to find the file(s) to be
  retrieved if the exact path is not known.  Example:
  dsmc retrieve c:\directory\* -su=yes -pick
  dsmc retrieve /directory/* -su=yes -pick
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli Storage Manager server users of   *
  *                 the upgrade process from version 5 to        *
  *                 version 6.                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION.                  *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be         *
  *                 fixed in level 6.2.5 and 6.3.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

• R61A PSY

     UP

• R61H PSY

     UP

• R61L PSY

     UP

• R61S PSY

     UP

• R61W PSY

     UP

• R62A PSY

     UP

• R62H PSY

     UP

• R62L PSY

     UP

• R62S PSY

     UP

• R62W PSY

     UP

• R63A PSY

     UP

• R63H PSY

     UP

• R63L PSY

     UP

• R63S PSY

     UP

• R63W PSY

     UP