IC83580: DOCUMENTATION OF THE PARAMETER RETVER (RETAIN VERSION) FOR ARCHIVE COPY GROUPS NEEDS TO BE EXPANDED

APAR status

• Closed as documentation error.

Error description

• The IBM Tivoli Storage Manager 5.5 Administrator's Reference
  for AIX, HP-UX, Linux, Solaris, and Windows contains
  insufficient information for the DEFINE COPYGROUP
  (Define an archive copy group) command.
  
  The description of the parameter RETVer (Retain Version) must
  be expanded to include the same information as in the V6
  documentation:
  
  Version 5.5:
    Note:
    'If you specify a value of 0 (zero), the default value of 365
     is used.'
  
  Version 6.X:
    If you specify a value of 0 (zero), and the destination
    storage pool for the archive copy group is a Snaplock storage
    pool (RECLAMATIONTYPE=SNAPLOCK), retention of the volumes will
    be set using the value of the server option
    RETENTIONEXTENSION. The default value for the
    RETENTIONEXTENSION option is 365 (days).
  
  Tivoli Storage Manager Versions Affected:
  Tivoli Storage Manager server documentation 5.5
  
  Initial Impact:
  Low
  
  Additional Keywords:
  TSM snaplock retain
  

Local fix

• Use the V6 documentation
  

Problem summary

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

Problem conclusion

• In the Tivoli Storage Manager documentation and command-line
  help, the description of the DEFINE COPYGROUP (Define an
  archive copy group) command will be updated. In the
  instructions for setting the number of days to keep an archive
  copy, the following text will be used:
  
  "Specifies the number of days to keep an archive copy. You can
  specify an integer from 0 to 30000.
  
  If you specify a value of 0 (zero), and the destination
  storage pool for the archive copy group is a Snaplock storage
  pool (RECLAMATIONTYPE=SNAPLOCK), retention of the volumes will
  be set by using the value of the server option
  RETENTIONEXTENSION. This also applies if data is copied or
  moved into the Snaplock storage pool by a server process such
  as migration, or by using the MOVE DATA/NODEDATA commands. The
   default value for the RETENTIONEXTENSION option is 365
  (days)."
  
  Affected platforms:  AIX, HP-UX, Solaris, Linux, Windows, and
  z/OS.
  

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