IT31957: 'DSMC QUERY BACKUP <DRIVE PATH> -ASNODENAME=<CLUSTER NAME>' MAY FAIL WITH ANS1083E.

APAR status

• Closed as program error.

Error description

• The problem may occur as below:
  
  Step 1: On a Windows cluster (e.g. cluster_name_1), take a
  backup data.
  
  Step 2: Use export/import node commands to transfer the backup
  data to another environment.
  
  Step 3: On one of the cluster nodes in the another environment,
  run 'dsmc query backup <drive pathe> -asnodename=<cluster name>'
  command.
  The dsmc command may fails with ANS1083E.
  
  For example, the following command may fails at the step 3:
  - dsmc query backup X:\ -asnodename=cluster_name_1
  This command may return "ANS1083E No files have previously been
  archived for 'X:\' ".
  
  This problem may also occur in following operations:
  - Issuing restore/query archive/retrieve command instead of
  query backup.
  - Using virtualnodename option instead of asnodename.
  
  
  
  Customer/Support Diagnostics (If Applicable):
  
  When this problem occurs, the service trace shows that the
  client is using cluster name of the another environment instead
  of asnodename value constructing the UNC name.
  
  e.g.
  Cluster:       cluster_name_1 - the cluster where the backup was
  taken so file space on server is '\\cluster_name_1\x$'.
  
  Cluster:       cluster_name_2 - the cluster where the
  "query/restore" command were running.
  Cluster node:  node_name     - the node name in the cluster
  cluster_name_2.
  
  asnodename     cluster_name_1
  nodename       node_name
  
  ...
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfsinfo.cpp(3712): psGetUncName(): Enter
  with path 'X:\'
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfssub.cpp(3823): psIsClusterVolume():
  enter. Checking volume <X:\
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfssub.cpp(3889): psIsClusterVolume(): use
  old way - call psIsClus
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfssub.cpp(1208): Cluster info for drive
  'X:' is TRUE
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfssub.cpp(3943): psIsClusterVolume(X:\)
  returns 1 (bool)
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\winnt\psfsinfo.cpp(3927): psGetUncName(): Use
  cluster name <cluster_name_2>
  ...
  yyyy-mm-dd hh;mm:ss.nnn [mmmmmm] [nnnn] :
  ..\..\common\filem\fmname.cpp(3410): fsID          : 0
  fs            : \\cluster_name_2\x$
  hl            :
  ll            : \*
  ...
  
  The ASNODENAME cluster_name_1 was specified so the unc name for
  X: should be \\cluster_name_1\x$ but it is \\cluster_name_2\x$.
  
  
  
  IBM Spectrum Protect Versions Affected:
  All supported versions of IBM Tivoli Storage Manager and
  Spectrum Protect Backup-Archive Client on Windows platform
  
  
  Initial Impact:
  Middle
  
  
  Additional Keywords:
  TS003157321, TSM
  

Local fix

• - Set "CLUSTERDISKSONLY NO" option in the client options file
  (dsm.opt) when query (or restore, etc.) command runs.
  
  - Specfiy filespace name instead of the drive path, as below:
  dsmc query backup \\cluster_name_1\X$ -asnodename=cluster_name_1
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Backup-Archive client versions 7.1.6,   *
  * 7.1.8, 8.1.2, 8.1.4, 8.1.6, 8.1.8 and 8.1.9 on Windows       *
  * platform.                                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the IBM Spectrum      *
  * Protect Backup-Archive client 8.1.10 version on Windows      *
  * platform.                                                    *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• Internal routine that handles the ASNODENAME option has been
  updated to correctly construct UNC name.
  

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

• DSM      DSMC     DSMCSVC  DSMAGENT
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels