OLD

Synopsis

HELP:   Add new version to an existing archive (new version starts empty)
TYPE:   OBJECT
SYNTAX: OLD(NET.{},STORE/SAVE.{},FLAM(),PREPROCESS[()...],POSTPROCESS/PSTPRO[()...])

Description

Use this object to write a new version to an existing archive that is independent of any previous versions in the archive, i.e. the new archive starts out empty. Archives can be stored in various locations using different storage backends.

To open an existing archive, you must specify where the archive is stored using the STORE parameter. It also allows you to delete the previous version or all older versions after the new version was written successfully. Remember that deleting old versions only marks the data as deleted. To actually remove all deleted segment data that is no longer required, the archive must be pruned (PRUNE). Depending on the storage backend, this can be an expensive operation. For file-based archives, the whole archive is rewritten.

If the archive is encrypted, you must also provide credential via the FLAM.DECRYPT() parameter to unlock a keyset in order to decrypt the contents. This keyset is automatically used to write the new version so that all previously valid credentials can also access the new archive version.

You can replace or add additional keysets, just like the REKEY command, while writing the new version by specifying FLAM.ENCRYPT() with the desired parameters. Have a look at the REKEY command for details.