IC79511: DELETE VOLHIST TYPE=BACKUPSET SYNTAX DOCUMENTATION IS INCORRECT.

APAR status

• Closed as documentation error.

Error description

• The syntax for Tivoli Storage Manager server command DELETE
  VOLHIST TYPE=BACKUPSET is incorrectly documented. From the
  administrator's reference, the syntax for this command is as
  followed:
  >>-DELete
  VOLHistory--TODate--=--date--------------------------->
  
     .-TOTime--=--23:59:59-.
  >--+---------------------+--------------------------------------
  >
     '-TOTime--=--time-----'
  
  >--Type--=--+-All---------------------------------------+------>
  <
              +-BACKUPSET---------------------------------+
              +-DBBackup--+-------------------------+-----+
              |           '-DEVclass--=--class_name-'     |
              +-DBSnapshot--+-------------------------+---+
              |             '-DEVclass--=--class_name-'   |
              +-DBRpf-------------------------------------+
              +-EXPort------------------------------------+
              +-REMote------------------------------------+
              |         .-DELETELatest--=--No------.      |
              +-RPFile--+--------------------------+------+
              |         '-DELETELatest--=--+-No--+-'      |
              |                            '-Yes-'        |
              |              .-DELETELatest--=--No------. |
              +-RPFSnapshot--+--------------------------+-+
              |              '-DELETELatest--=--+-No--+-' |
              |                                 '-Yes-'   |
              +-STGNew------------------------------------+
              +-STGReuse----------------------------------+
              '-STGDelete---------------------------------'
  
  The only required parameter for TYPE=BACKUPSET is TODATE.
  However, when this command is issued, an error message is
  encountered.
  
  tsm: URANIUM1>delete volh todate=today t=backupset
  ANR2022E DELETE VOLHISTORY: One or more parameters are missing.
  ANS8001I Return code 3.
  
  There are other required parameters for this command.
  
  
  Tivoli Storage Manager Versions Affected:
  Tivoli Storage Manager version 6
  
  Customer/L2 Diagnostics (If Applicable)
  None
  
  Initial Impact:
  Low
  
  Additional Keywords:
  TSM volume history volumehistory
  

Local fix

• Contact IBM support for the correct DELETE VOLHIST
  TYPE=BACKUPSET syntax.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli Storage Manager server users.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: See error description.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  *
  

Problem conclusion

• In the Tivoli Storage Manager Administrator's Reference, in
  the topic "DELETE VOLHISTORY (Delete sequential volume history
  information)," the reference to the TYPE=BACKUPSET parameter
  was removed from the syntax and from the parameter list. The
  same changes were made in the online help.
  
  In the Tivoli Storage Manager Upgrade and Migration Guide, in
  the topic "DELETE VOLHISTORY (Delete sequential volume history
  information)," the reference to the TYPE=BACKUPSET parameter
  was removed from the parameter list.
  
  
  Affected platforms: AIX, HP-UX, Solaris, Linux, and Windows.
  

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