Backup (-B)

Use the Backup (-B) adapter command to create a backup file of processed IDocs. The default is to produce a file named transaction_id.tid where transaction_id is the SAP R/3 assigned Transaction Identifier (TID) in the map directory.

If a Transaction Identifier (TID) cannot be assigned, transaction_id is m4r3serial_number. Optionally, you can specify that the file be input for a map, delete the file upon successful map execution, specify your own file name, incorporate the transaction_id into your file name, or specify a full path for the file.

Note: When a failure occurs, a transaction_id.tid backup file is created with the connection information and the IDOC (when normal usage of -B occurs only the IDOC is created).

Note: When the Audit adapter command and its U option (-AR3U) is used in conjunction with this adapter command, the name of the audit file and the backup file always match.


Source -B[I][X] [%tid%|full_path]
Target -B[X] [%tid%|full_path]

Option: Description
I: Create backup file in temporary directory instead of using memory buffers. This option is only applicable when the ALE adapter is used as a Source.
X: Delete the backup file from the temporary directory upon successful completion of map execution.
%tid%: When specifying the name for the backup file, you can incorporate this literal as part of the file name and it is replaced by the TID_number.
full_path: Specify the name for the backup file, which can include the directory path.

The following are examples using the Backup (-B) adapter command:

Command: Result
-B %tid%: dstx_directory\TID_number.tid where dstx_directory is the installation directory and TID_number represents the TID number generated. Before using the -B adapter option with %tid%, you must first create a resource registry entry for tid and assign it a value of %tid%.
-B d:\bak\%tid%: d:\bak\TID_number.tid where TID_number represents the TID number generated.
-B Archive%tid%: dstx_directory\ArchiveTID_number.tid where dstx_directory is the installation directory and TID_number represents the TID number that is generated.