BAR_RETRY configuration parameter

Use the BAR_RETRY configuration parameter to specify how many times onbar should try a data backup, logical-log backup, or restore operation if the first attempt fails.

onconfig.std value
1
if value not present
1
units
integer
range of values
0 = BAR_ABORT, stop the rest of the backup/restore
1 = BAR_CONT, continue the rest of the backup/restore
n = 2 to 32766
takes effect
When ON-Bar starts
When you reset the value dynamically in your onconfig file by running the onmode -wf or equivalent SQL administration API command.

Usage

The setting of the BAR_RETRY parameter determines ON-Bar behavior in the following ways:
  • If set to 0 (BAR_ABORT), ON-Bar stops the backup or restore session when an error occurs for a storage space or logical log, returns an error, and quits. If ON-Bar is running in parallel, the already running processes finish but no new ones are started.
  • If set to 1 (BAR_CONT), ON-Bar stops the backup or restore attempt for that particular storage space, returns an error, and attempts to back up or restore any storage spaces or logical logs that remain.
  • If set to a specific number (retry backup and restore operations 2 to 32766 times), ON-Bar attempts to back up or restore this storage space or logical log the specified number of times before it gives up and moves on to the next one.