BAR_HISTORY configuration parameter

Use the BAR_HISTORY configuration parameter to specify whether the sysutils database maintains a backup history when you use onsmsync to expire old backups.

onconfig.std value
Not in the onconfig.std file.
default value
0
range of values
0 = Remove records for expired backup objects from the sysutils database
1 = Keep records for expired backup objects in the sysutils database
takes effect
When onsmsync starts
When you reset the value dynamically in your onconfig file by running the onmode -wf or equivalent SQL administration API command.

Usage

If you set the value to 0, onsmsync removes the bar_object, bar_action, and bar_instance rows for the expired backup objects from the sysutils database. If you set the value to 1, onsmsync sets the act_type value to 7 in the bar_action row and keeps the bar_action and bar_instance rows for expired backup objects in the sysutils database. If you do not set BAR_HISTORY to 1, the restore history is removed.

Regardless of the value of BAR_HISTORY, onsmsync removes the line that describes the backup object from the emergency boot file and removes the object from the storage manager when the storage manager expires the object.

For more information about onsmsync, see The onsmsync utility.