Page History

Transactional Transfer

This parameter specifies whether a transfer should be processed within a single transaction,

        i.e. either all objects are successfully transferred or none.

Should an error occur during a transfer operation then all transfers will be rolled back.

The following applies when the value true is specified:

• The atomic_suffix and/or atomic_prefix parameters have to be specified to cause target files to be created on the target system with a suffix and/or prefix such as "~". 
  After the transfer has been completed, the names of these files will then be changed back to their original values.
  (See Atomicity)
• If at least one file out of a set of files cannot be transferred successfully then no files will be renamed.
  Instead the files that were written on the target system under their temporary names will be removed.
• The remove_files parameter that causes files to be removed after successful transfer will only be effective after all files have been successfully transferred.
  Otherwise no files will be removed.

Note:

• Transactional transfer requires write permissions on the target host.
• Transactional transfer is not 100% reliable - there are situations where rollback is not possible.
  Consider the situation where a large number of files are transferred transactionally to a remote Windows system, where renaming cannot rolled back.
  • If, after transfer of all the files has been completed, one of the files waiting to be renamed is accessed by another process on the target server (which should not but can happen) - the rename action will fail and the whole transfer should be rolled back.