IT27922: INCLUDE.VMSNAPSHOTATTEMPTS OPTION NOT WORKING WHEN DEFINED IN SERVER OPTION SET.

APAR status

• Closed as program error.

Error description

• Abstract: Include.vmsnapshotattempts option not working when
  defined in Server option set.
  Error Description:
  Documentation states that the following option
  'Include.vmsnapshotattempts' option be configured in the option
  file and Server option set
  but it only works when defined in the option file.
  On TSM Server:
  define clientopt {cloptset_name} inclexcl
  "include.vmsnapshotattempts * 2 2"
  When the client tries to read the syntax from the Server Option
  Set, it is getting the following errors as seen by a 'Service'
  trace:
  "Illegal syntax found in INCLEXCL option:
  include.vmsnapshotattempts * 2 2"
  
  Products affected:
  IBM Spectrum Protect for Virtual Environments Data Protection
  for VMware versions 7.1 and  8.1 running on
  all Microsoft Windows x64 and Linux x86 platforms;
  Data Protection for Microsoft Hyper-V versions 7.1 and 8.1
  running on all Microsoft Windows x64 platforms.
  
  Note 1: The Backup-Archive Client is a prerequisite to using the
  Data Protection for VMware version 7.1. In Data Protection for
  VMware environments, the Backup-Archive Client is also known
  as the data mover.
  
  Note 2: The Backup-Archive Client is a prerequisite to using the
  Data Protection for Microsoft Hyper-V versions 7.1 till 8.1.2.
  In Data Protection for  Microsoft Hyper-V environments,
  the Backup-Archive Client is also known as the data mover.
  
  If you are using Backup-Archive Client 7.1 and 8.1, refer to
  APAR  IT27922
  
  If you are using Data Protection for VMware 8.1,
  refer to APAR IT28171
  
  If you are using Data Protection for Microsoft Hyper-V
  8.1.4 and later, refer to APAR IT28172
  
  Customer/L2 Diagnostics:  N/A
  Initial Impact: Medium
  Additional Keywords: include inclexcl exclude TS001797607
  

Local fix

• Do not code the option in the client option set instead code it
  in the client option file.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware versions 7.1 and  8.1 running on all   *
  * Microsoft Windows x64 and Linux x86 platforms;               *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for Microsoft Hyper-V versions 7.1 and 8.1        *
  * running on all Microsoft Windows x64 platforms.              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * client version 7.1.8.5 on Windows x64 platforms and Linux    *
  * x86 platforms                                                *
  *                                                              *
  * Note 1: The Backup-Archive Client is a prerequisite to using *
  * the Data Protection for VMware version 7.1.                  *
  * In Data Protection for VMware environments, the              *
  * Backup-Archive Client is also known as the data mover.       *
  *                                                              *
  * Note 2: The Backup-Archive Client is a prerequisite to using *
  * the Data Protection for Microsoft Hyper-V versions 7.1 till  *
  * 8.1.2.                                                       *
  * In Data Protection for  Microsoft Hyper-V environments, the  *
  * Backup-Archive Client is also known as the data mover.       *
  *                                                              *
  * Note 3: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• The following options can now be set from server:
  INCLUDE.VAPP
  INCLUDE.VM
  INCLUDE.VMDISK
  INCLUDE.VMLOCALSNAPSHOT
  INCLUDE.VMRESETCBT
  INCLUDE.VMSNAPSHOTATTEMPTS
  

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:

  IT28171 IT28172

Modules/Macros

• dsmagent
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSY

     UP

• R71L PSY

     UP