The command file feature is useful for specifying the entire command-line parameters inside a single file. To execute ascp command with command file, use the following syntax:
ascp --args-list=cmdfile
Note that when --args-list is present, it shall be the only option.
To make a command file, create a text file with an editor. You may save the file as unicode (UTF-8 and UTF-16, BE and LE). The format must be explicitly specified file extensions: ".utf8" for UTF-8 files and ".unicode" for UTF-16 files.
Separate command flag and value in different lines. For example, to specify target rate of 3000, and set local log directory as /tmp, use the following format:
-l 3000 -L /tmp
To support source list file, the ascp long option --file-list is introduced . In addition, a second long option --src-base is introduced for the purpose of preserving source directory structure. The following shows an example.
When using long options with value, for example, --symbolic-links=follow, enter the flag and value in two separate lines, without the equal symbol:
--symbolic-links follow
For ascp command options, refer to ascp Usage.
When the command file is created, you may execute ascp command with this file through the --args-list option. For example, to execute options stored in a command file named ascp_command_file:
> ascp --args-list=ascp_command_file