IC99324: VMHOSTCLUSTER VALUE IS TRUNCATED WHEN PERIODS(FULL STOPS) ARE USED IN THE NAME

IBM Tivoli Storage Manager (TSM) client 7.1.0.x interim fix downloads
IBM Tivoli Storage Manager (TSM) Client 7.1.1 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• The domain.vmfull option provides the vmhostcluster parameter to
  specify a specific VMware cluster to process during backup.  If
  the value specified with this parameter contains periods(full
  stops), the name will be truncated to the value before the first
  period(full stop).
  For example, if the cluster name is 'TSM.Lab.Cluster.01' during
  processing it will be truncated to 'TSM'.
  
  Versions Affected:Tivoli Storage Manager Backup/Archive client
  7.1.0
  
  Customer/L2 Diagnostics: A preview of the dsmc backup will show
  the following for each machine:
   'dsmc backup vm
   -domain.vmfull="vmhostcluster=TSM.Lab.Cluster.01" -preview'
  
         vmName: TestVM01
         DomainKeyword:  vmhostcluster=TSM
         toolsRunningStatus: guestToolsRunning
         toolsVersionStatus: guestToolsCurrent
         consolidationNeeded: No
  
  A service level trace will show the following entries against
  the vmVcbGetVMList:
  vmVcbGetVMList: VM Backup Domain keyword processing vmList
                  option value - First
                  loop='vmhostcluster=TSM.Lab.Cluster.01;-VM=*'
  vmVcbGetVMList: Keyword (semicolon) parsing
                  value='vmhostcluster=TSM.Lab.Cluster.01'
  vmVcbGetVMList: VM Backup domain keyword vmhostcluster specified
                  value='vmhostcluster=TSM.Lab.Cluster.01'
  vmVcbGetVMList: Striping off keyword 'vmhostcluster=',
                  value='TSM.Lab.Cluster.01'
  vmVcbGetVMList: Parsing vmhostcluster list (comma)
                  value='TSM.Lab.Cluster.01'
  vmVcbGetVMList: Saving shorten DSN name for search hostname=TSM
  vmVcbGetVMList: Adding vmhostcluster to vmhostclusterLinkList
                  vmhostcluster='TSM'
  
  Initial Impact: Medium
  
  Additional Keywords: tsm4ve ve fullstop
  

Local fix

• Specify the individual machines in the cluster if they need to
  be processed separately from other machines in the environment
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Backup-archive client versions 6.4.0,        *
  *                 6.4.1, 7.1.0 and 7.1.1 running on all        *
  *                 Microsoft Windows and Linux platforms        *
  ****************************************************************
  * PROBLEM DESCRIPTION: The domain.vmfull option provides the   *
  *                      vmhostcluster parameter to specify a    *
  *                      specific VMware cluster to process      *
  *                      during backup.  If the value specified  *
  *                      with this parameter contains periods,   *
  *                      the name will be truncated to the       *
  *                      value before the first period.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If the cluster name is 'TSM.Lab.Cluster.01' during
  processing it will be truncated to 'TSM'.
  

Problem conclusion

• Removed code that was scanning for periods in the
  clster 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:

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R64L PSY

     UP

• R64W PSY

     UP

• R71L PSY

     UP

• R71W PSY

     UP