Enablearchiveretentionprotection

The enablearchiveretentionprotection option allows the client to connect to a Tivoli® Storage Manager data retention server. This ensures that archive objects will not be deleted from the server until policy-based retention requirements for that object have been satisfied.

This option is ignored if the client connects to a server that is not retention protection enabled. If the option is no (the default) and an attempt is made to connect to a data retention server, the connection is refused.

The data retention server is specially configured for this task, so normal backup or restore processing is rejected by the server. When the client is connected to a data retention server, the following commands will not be available. If you attempt to use these commands, a message is displayed indicating that they are not valid with this server.

  • incremental
  • backup (all subcommands)
  • selective
  • restore (all subcommands except restore backupset -location=file or -location=tape)
    Note: restore backupset -location=file or -location=tape do not connect to any server (except the virtual one) and thus will not be blocked under any circumstances.
  • restart restore
  • delete backup
  • delete group
  • expire
  • All queries except:
    • query access
    • query archive
    • query filespace
    • query inclexcl
    • query managementclass
    • query node
    • query options
    • query schedule
    • query session
    • query systeminfo
    • query tracestatus

Supported Clients

This option is valid for all clients.

Options File

Windows operating systemsThis option is valid only in client options file (dsm.opt) and is not valid in a client option set from the server. It is not valid on any command line.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThis option is valid only in the dsm.sys file within a server stanza and is not valid in a client option set from the server. It is not valid on any command line.

Syntax

Read syntax diagramSkip visual syntax diagram
                                     .-No--.   
>>-ENABLEARCHIVERETENTIONProtection--+-----+-------------------><
                                     '-Yes-'   

Parameters

No
The data retention server connection is refused. This is the default.
Yes
The client connects to a data retention server.