Windows operating systems

Resetarchiveattribute

Use the resetarchiveattribute option to specify whether Tivoli® Storage Manager resets the Windows archive attribute on files that are successfully backed up to a Tivoli Storage Manager server.

Tivoli Storage Manager also resets the archive attribute during incremental backups if it is determined that there is already an active object on the Tivoli Storage Manager server. The resetarchiveattribute option is useful in conjunction with applications, such as the IBM® Tivoli Storage Resource Manager, as a simple way to report on the backup status of files.

The Windows archive attribute is used to indicate that a file has changed since the last backup. After Tivoli Storage Manager resets the archive attribute, the Windows operating system turns the attribute back to ON after the file has been modified. Tivoli Storage Manager does not use the Windows archive attribute to determine if a file is a candidate for incremental backup, but only manipulates this attribute for reporting purposes. Tivoli Storage Manager uses a much more sophisticated method to determine candidacy for incremental backup.

There are several applications which manipulate or examine the Windows archive attribute. Be aware of the ramifications of using the resetarchiveattribute option in conjunction with these products.

If you set the resetarchiveattribute option to yes, after a file has been successfully backed up to the Tivoli Storage Manager server, the Tivoli Storage Manager client resets the Windows archive attribute on the local file system:

  • The Windows archive attribute is reset during incremental and selective backups after the file has been successfully committed to the Tivoli Storage Manager database. This attribute is not reset for archive, or image operations.
  • The Windows archive attribute is not reset when processing system objects or system state objects.
  • The Windows archive attribute is not reset for directory entries.

In addition, in order for the local file system to reflect the current active object inventory on the Tivoli Storage Manager server, the resetarchiveattribute option instructs the Tivoli Storage Manager client to reset the Windows archive attribute on the local file system if it is determined during incremental backup that a valid, active backup copy of the file already exists on the Tivoli Storage Manager server. This behavior is not displayed in the following cases:

  • Incremental backup operations which do not examine the stored client attributes on the Tivoli Storage Manager server, such as journal-based backup or incremental-by-date processing.
  • Files that are not examined during an incremental backup operation because they are excluded from backup processing.

The Tivoli Storage Manager client does not guarantee the accuracy of the current setting of the Windows archive attribute. For example, if the resetarchiveattribute option is set to yes and a file examined by a reporting product indicates that the Windows archive attribute is OFF for a particular file, this does not necessarily mean that a valid, active backup copy of the file exists on the Tivoli Storage Manager server. Factors that could contribute to this type of situation include:

  • An independent software vendor product is manipulating the Windows archive attribute
  • A file space was deleted from the Tivoli Storage Manager server
  • A backup tape was lost or destroyed

There should be no significant performance degradation when using the resetarchiveattribute option. The resetarchiveattribute option does not affect restore processing.

Supported Clients

This option is valid for all Windows clients. The server can also define this option.

Options File

This option is valid in the client options file (dsm.opt) or server client options set. You can set this option on the Backup tab of the Preferences editor.

Syntax

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

Parameters

Yes
Specifies that you want to reset the Windows archive attribute for files during a backup operation.
No
Specifies that you do not want to reset the Windows archive attribute for files during a backup operation. This is the default.

Examples

Options file:
resetarchiveattribute yes