IT00630: RESTORE OF SYMBOLIC LINK FROM BACKUPSET CAN HANG THE CLIENT JAVA GUI

IBM Tivoli Storage Manager (TSM) Client 7.1.1 Downloads and READMEs
IBM Tivoli Storage Manager Client 6.4.3 Downloads and READMEs
IBM Tivoli Storage Manager (TSM) client 6.3.2.x interim fix downloads - EOL

APAR status

• Closed as program error.

Error description

• When restoring a symbolic link from a backupset the
  Backup/Archive client java GUI may hang.
  
  Customer/L2 Diagnostics (if applicable)
  
  dsm.opt has:
  FOLLOWSYMBOLIC: NO
  ARCHSYMLINKASFILE: NO
  
  A service trace will show an out of sequence verb:
  02/14/14   15:01:04.574 [26869890] [1802] : virtstat.cpp
  ( 623): dsmNFSsyscall lstat for path
  /usr/sys/inst.images/uc4/prd/ediV7awx/AWhelp.zip
  02/14/14   15:01:04.574 [26869890] [1802] : virtstat.cpp
  ( 899): dsmNFSsyscalls: returns(-1), errCode(2).
  02/14/14   15:01:04.574 [26869890] [1802] :
  ../unx/aix/pserrno.cpp( 293): TransErrno: Received error from
  lstat, errno = 2, rc = 104
  02/14/14   15:01:04.574 [26869890] [1802] : restproc.cpp
  (12689):
  RestoreSymLink(/usr/sys/inst.images/uc4/prd/ediV7awx/AWhelp.zip)
  : fileSize(34)
  ...
  02/14/14   15:01:04.575 [26869890] [1802] : session.cpp
  (1554):   Length:   362 Code: 00001000 Type:    <-
  ObjectInsNorm
  02/14/14   15:01:04.575 [26869890] [1802] : restproc.cpp
  (13066): RestoreFile: Out of sequence verb: verb:
  (<--- HERE)
  02/14/14   15:01:04.575 [26869890] [1802] : restproc.cpp
  (7839): ProcessFile: Got rc: 131
  02/14/14   15:01:04.575 [26869890] [1802] :
  DccRestoreConsumer.cpp(2139): HandleEndRequest: Not sending end
  signal.
  02/14/14   15:01:04.575 [26869890] [1802] :
  DccRestoreConsumer.cpp(2140): HandleEndRequest: noQryRestore ==
  bFalse
  02/14/14   15:01:04.575 [26869890] [1802] : session.cpp
  (2144): Sess (302bf570) FREELOCK lock action by thread (70a):
  02/14/14   15:01:04.575 [26869890] [1802] :
  DccRestoreConsumer.cpp(1095): HandleQueue: Leaving Consumer with
  rc: 131
  02/14/14   15:01:04.575 [26869890] [1802] : thrdmgr.cpp
  ( 901): Thread 1st Restore Consumer exiting, result =131
  02/14/14   15:01:04.575 [26869890] [1802] : ../unx/psthread.cpp
  ( 874): Thread 1802 exit called.
  
  *NOTE*
  None
  
  Platforms affected:
  All Unix/Linux 5.x, 6.x, 7.x
  
  Initial Impact: Medium
  
  Additional Keywords: symlink sym link ZZ61 ZZ62 ZZ63 ZZ71
  

Local fix

• Use the dsmc command line as a work-around
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All backup-archive client versions running   *
  *                 on AIX, Linux, Solaris and HP platforms      *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION                   *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in levels 6.3.2.3, 6.4.3 and 7.1.1. Note that*
  *                 until the fixing levels are available, this  *
  *                 information is subject to change at the      *
  *                 discretion of IBM.                           *
  ****************************************************************
  *
  

Problem conclusion

• The problem has been fixed so that it no longer occurs
  

Temporary fix

• 6.3.2.3 for all UNIX and Linux
  

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

• DSMAGENT
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R63A PSY

     UP

• R63H PSY

     UP

• R63L PSY

     UP

• R63S PSY

     UP

• R64A PSY

     UP

• R64H PSY

     UP

• R64L PSY

     UP

• R64S PSY

     UP

• R71A PSY

     UP

• R71H PSY

     UP

• R71L PSY

     UP

• R71S PSY

     UP