IC94067: HSM FOR WINDOWS RECONCILIATION CREATES ORPHANS FOR FILE NAMES EXCEEDING 259 CHARACTERS

APAR status

• Closed as program error.

Error description

• HSM for Windows Reconciliation process doesn't recognize files
  with names longer than 259 characters and handles them as 'not
  found'. File names consist of full path and file name including
  drive letter, colon, backslash and name components separated by
  backslashes. Because a stub file with such long name is not
  found on the file system, the corresponding file content on TSM
  server filespace is deleted by reconciliation process and the
  stub file on the Windows file system becomes an orphan. Also the
  orphan stub files with names longer than 259 characters cannot
  be detected by HSM for Windows and therefore the following
  reconcile run does not stop with error and those orphan stub
  files are not listed in the orphan log file.
  HSM for Windows versions 6.4.0 and higher are not affected.
  
  Recommendation:
  Unconfigure volumes for reconciliation until you have applied
  the APAR fix or installed HSM for Windows version 6.4.0 or
  higher.
  After you have applied the fix or installed version 6.4.0 or
  higher, configure volumes for reconciliation again.
  
  Affected Products:
  Tivoli Storage Manager HSM for Windows versions
  5.5.0.0 - 5.5.3.1, 6.1.0.0 - 6.1.5.1, 6.3.0.0 - 6.3.1.0
  
  Customer/L2 diagnostics:
  An orphan stub is created if the following error message for a
  path longer than 259 characters is displayed in hsmmonitor.log
  for an existing stub file in the file system.
  For example:
  HSMMONITOR (05C8:0C98) NtfsVolume::scanFiles
  13-07-05 05:56:24.142
   W: FindFirstFile failed for path:
  'H:\l00400-10\subdir001\subdir002\subdir003\subdir004\subdir005\
  subdir006\subdir007\subdir008\subdir009\subdir010\subdir011\subd
  ir012\subdir013\subdir014\subdir015\subdir016\subdir017\subdir01
  8\subdir019\subdir020\subdir021\subdir022\subdir023\subdir024\su
  bdir025\subdir026\subdir027\subdir028\subdir029\subdir030\subdir
  031\subdir032\subdir033\subdir034\subdir035\subdir036\subdir037\
  subdir038\*' dwError: '3' ('ERROR_PATH_NOT_FOUND').
  
  In hsmmonitor-delete-<DATE>-<TIME>.log
  A record for a file name longer than 259 characters indicates
  the problem.
  For example:
  hsmmonitor-delete-20130709-081612.log
  DATE="2013-07-09" TIME="05:06:39"
  LFNAME="\\WIN2008R2\H$\l00300-10\subdir001\subdir002\subdir003\s
  ubdir004\subdir005\subdir006\subdir007\subdir008\subdir009\subdi
  r010\subdir011\subdir012\subdir013\subdir014\subdir015\subdir016
  \subdir017\subdir018\subdir019\subdir020\subdir021\subdir022\sub
  dir023\subdir024\subdir025\subdir026\subdir027\subdir028\subdir0
  29\subdir030\subdir031\subdir032\subdir033\subdir034\subdir035\s
  ubdir036\subdir037\NewFile_template_for_review_8_1" LFVERS="1"
  LSERVER="172.16.12.112:1500" LNODE="WIN2008R2" RESULT="Marked"
  SEVERITY="I"
  
  Please note: Orhan stub files with names longer than 259
  characters will not be reported in hsmmonitor-orphan.log.
  
  You can query the backups on TSM server for file names longer
  than 259 characters using the following example for dsmadmc
  command:
  dsmadmc -id=smtest -pa=samplepw -tabd
  -outfile=IC94067_candidates.out "select filespace_name
  || hl_name || ll_name, 2 + length(hl_name) + length(ll_name)
  from backups where node_name='<node_name>' and
  (2+length(hl_name)+length(ll_name)>259) order by 2 desc"
  
  Or HSM archive can be queried for migrated files with long
  names. The 'select from archives' command is inaccurate for the
  length of computer name, because hl_name includes computer name.
  You can correct that by inserting the number '259 + length of
  computer name' instead of 259.
  dsmadmc -id=admin -pa=admin -tabd -outfile=
  IC94067_candidates.out "select
  hl_name || ll_name, length(hl_name) + length(ll_name) from
  archives where node_name='<node_name>' and
  (length(hl_name)+length(ll_name)>259) order by 2 desc"
  
  The parameters are:
  -id is your id
  -pa is your password
  <node_name> is node name of TSM Backup/Archive client backup
  pool.
  
  
  Initial Impact:
  high
  
  Additional Keywords:
  Reconcile orphan
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: TSM HSM for Windows Client Versions          *
  *                 5.5.0.0 - 5.5.3.1, 6.1.0.0 - 6.1.5.1         *
  *                 6.3.0.0 - 6.3.1.0                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * For detailed description see ERROR DESCRIPTION               *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in fixes later than 6.3.1                    *
  ****************************************************************
  

Problem conclusion

• The problem has been fixed
  

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 HSM FOR WIN

• Fixed component ID

  5698ICNCL

Applicable component levels

• R630 PSY

     UP