Versions Compared

Old Version 3

changes.mady.by.user Daniel Gibson

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
1255834
1255834
Description

Anchor
1255835
1255835
The dbDB_file_generations option specifies the number of archived UBroker databases that should be stored. The following databases can be archived: bcomponent.db, scomponent.db, uems.db, ues.db and they will bearchived on a rolling basis in a hidden .archive folder. The path for this folder on Windows is: C:\Program Files\Universal\spool\ubroker\.archive and on Linux it is /var/opt/universal/spool/.archiveFILE_GENERATIONS option enables archival of databases that fail the validation which may occur at Universal Broker startup.

The Broker initiates this validation when a previous instance of Broker failed to properly close the databases at shutdown.

Databases eligible for archival include:

  • bcomponent.db
  • scomponent.db
  • uems.db
  • ues.db

Archives are saved under the location specified by the SPOOL_DIRECTORY option, in an .archive folder that the Broker will create if it does not exist.

The number of archived copies for each of the eligible databases is managed by this option. When a new archival would exceed the configured value, the oldest copy is removed to accommodate the new archive.

The Broker will make every attempt to start successfully. Whether the archival is successful or not, the Broker will recreate the affected database so startup may proceed.

Only the databases listed above will be recreated. Other databases contain persistent data that will not be deleted automatically.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

NONE

n/a





Command Line, Long Form

-db_file_generations generations

count(tick)


(tick)

(tick)


Environment Variable

UBRDBFILEGENERATIONS

count

=generations


(tick)

(tick)

(tick)

Configuration File Keyword

db_file_generations

count

generations


(tick)

(tick)

(tick)

Value

count is the specification for

Anchor
1255872
1255872
generations is the number of UBroker databases to be archived.

The range of valid values for this option is 0-5, where 0 disables archiving all-together while still recreating the new database.

Default value is 3.

Command Usage

The DB_FILE_GENERATIONS option is used when the data from a corrupted database is preferred to be stored, rather than deleted when recreating a new UBroker database.

...

archive files that will be saved within the archive directory.

Anchor
1255873
1255873
The maximum number of generations of log files that can be saved is 9999.

Default is 3.


Note
titleNote

If the value is decreased, only the specified number of generations will be maintained. The "excess" archive files are not cleaned up immediately, but as the archive files rotate, this "excess" will be cleaned up and reused.


Note

This change removes the recreate_databases option added in 7.3.0.0, to copy the functionality of the recreate_databases option, simply set the value of the new db_file_generations option to 0.