Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
C:\Program Files\Universal\spool\ubroker\.archive
and on Linux it is /var/opt/universal/spool/.archive
FILE_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 |
UNIX | Windows | z/OS | |
Command Line, Short Form |
n/a | ||||
Command Line, Long Form | -db_file_generations generations |
Environment Variable | UBRDBFILEGENERATIONS |
=generations | ||||
Configuration File Keyword | db_file_generations |
generations |
|
|
Value
...
Anchor | ||||
---|---|---|---|---|
|
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 databasearchive files that will be saved within the archive directory.
Anchor | ||||
---|---|---|---|---|
|
Default is 3.
Note | ||
---|---|---|
| ||
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 |