IT09529: VMCLI INQUIRE_DETAIL DOCUMENTATION IS INCORRECT

Download Information: Version 4.1.3 IBM Spectrum Protectâ„¢ Snapshot

APAR status

• Closed as documentation error.

Error description

• In the Tivoli Storage Flashcopy Manager for VMware
  documentation, the vmcli inquire_detail lists an incorrect
  option for the backup type.  It states that ALL is a valid
  parameter, but when it is used, the following failure occurs:
  #ERROR FMM16038E The -t option value 'ALL' is not valid. Only
  [FCM, TSM] backup types are valid. You can specify two or more
  backup type, separated by commas
  
  Also, when the inquire_detail is run with a backup type of
  TSM, it results in the following failure:
  #ERROR ANS2825E TSM for Virtual Environments detected that the
  node name representing the Datacenter is not specified.
  
  The documentation does not indicate that '-d <Datacenter
  Nodename>' is required when the TSM backup type option
  is used.
  
  Versions Affected: Tivoli Storage Flashcopy Manager for VMware
  documentation 3.1, 3.2, and 4.1.x
  
  Initial Impact: Low
  
  Additional Keywords: FCM FCMVE FCMVM FCM4VE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * FlashCopy Manager for VMware 4.1.x                           *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Proceed as instructed in the VMCLI INQUIRE_DETAIL section of *
  * the FlashCopy Manager for VMware 4.1.3 User's Guide.         *
  ****************************************************************
  

Problem conclusion

• The vmcli -f inquire_detail command uses the following syntax:
  
  Read syntax diagramSkip visual syntax diagram
  vmcli command
  
  >>-vmcli------ -f
  inquire_detail-------------------------------->
  
  >--+---------------------------------+--------------------------
  >
     '- -t--backupType--+------------+-'
                        '-backupType-'
  
  >--+---------------------------------------------+--------------
  >
     '- -d--datacenternodename--datacenternodename-'
  
  >--+---------------+------------------------------------------->
  <
     '- -B--backupID-'
  
  The -t and -B options can be used to set filters for the
  information of interest.
  Parameters
  
  -t backupType
  
      FCM
          Specifies that the inquire_detail operation is performed
  for Tivoli Storage FlashCopy Manager for VMware backups.
  
      TSM
          Specifies that the inquire_detail operation is performed
  for Tivoli Storage Manager for Virtual Environments backups.
      -d
          When the -t parameter specifies the TSM option, specify
  the datacenter node name.
  
  -B backupID
      The ID of the backup for the inquire_detail command.
  

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

Applicable component levels