DUPLICATE

Synopsis

HELP:   Copy whole segments to a new archive with the same characteristics
TYPE:   OBJECT
SYNTAX: DUPLICATE(NET.{},STORE/SAVE.{},MBRMODE=STOP/APPEND/OVERWRITE,MEMBER='str',KEYMODE=ADD/REPLACE,ENCRYPT/EXPORT.{},NORLBK[=num],REMOVE,PREPROCESS[()...],POSTPROCESS/PSTPRO[()...])

Description

Use this object to copy raw data segments from a FLAM archive to a new FLAM archive to create a duplicate. The archive will have the same characteristics as the source archive being read from. The data is not unpacked and the compressed and encrypted segments are transferred as-is. This is particularly important for the secure creation of subsets as the result set of a search request and will be very fast for a large amount of data.

INPUT TO OUTPUT NAME MAPPING can be used for the member name, whereby the member mode can also be selected accordingly.

You can replace or add additional keysets, just like the REKEY command, while writing the copy by specifying FLAM.ENCRYPT() with the desired parameters. Have a look at the REKEY command for details. To do this, however, the data key must be available in the keyset used to access the source archive so that the data remains accessible in the new archive. This is useful if a result set needs to be converted from a repository key to the public key of the requester.

The KEYMODE defines whether any new encrypted keysets defined should overwrite the old ones used for reading or whether they should be added here, with the latter being the default.

For the transfer of many members, it can make sense to deactivate the rollback, whereby in this case you can use the REMOVE switch to delete the members that were only partially transferred in the event of an error.

Arguments