Synchronous transfer of multiple files with FTAM

It is possible to transfer successively multiple files with one ncopy command (Unix and Windows systems) or FTSCOPY command (BS2000 systems) via one transport connection and one FTAM connection. This works for send and receive requests and is controlled by the file name syntax.

The total length of the file list must match with the file name parameter of the ncopy/FTSCOPY command.

This function is also available at the program interface on Unix and Windows systems.

Specification of the send files

If the name of the send file does not start with two commas, everything will work as before.

If the name begins with two commas, the following applies

• Several names are derived from this name, which in turn are separated by two commas.

  Example 1

  ,,Letter1,,Document,,Booking

  The files Letter1, Document and Booking are transferred.

• If the first subname ends with slash, point, or backslash in Windows, it is interpreted as a prefix for all subsequent subnames.

  Example 2

  ,,MyDirectory/,,Letter1,,Document,,Booking

  The files MyDirectory/Letter1, MyDirectory/Document and MyDirectory/Booking are transferred.

Files with a comma at the end of the file name, or multiple commas within the name can not be transferred with the multiple option. Files whose names start with two commas can generally only be transferred asynchronously.

Specification of the receive file

For the single transfers, the name of the receive file is formed from the specified name and the name of the send file, whereby a prefix, if any, is not taken into account in the send file name.

Example

If target/ is specified as a receive file in Example 1 and Example 2, the receive files target/Letter1, target/Document and target/Booking are generated in both cases.

Logging and behavior in case of transfer errors

A separate logging record is written for each partial transfer request, and also follow-up processing (if specified) is started individually for each partial transfer request.

As a result of such a multiple file transfer, an OK message is received only if all transfers have been successful. Otherwise, the multiple transfer will be aborted after the first error and a corresponding message will be displayed even if some files of the multiple transfer have already been successfully transferred. Files whose transfer has not yet been started are marked as "canceled" in the logging.