Transfer() action

Description
The Transfer action is the way to do file transfers in scripts, as well as in c3270 and wc3270.

Parameters
In c3270 and wc3270, Transfer can be invoked with no parameters. It will prompt interactively for the parameters it needs.

Otherwise, it takes a number of parameters, consisting of option names and values. Values can be specified in one of two ways. They can be attached to the option name:
 * option=value

Or they can be specified separately:
 * option,value

Options

 * Direction
 * The direction of the transfer.
 * The value send means sending a file to the host. This is the default.
 * The value receive means receiving a file from the host.


 * HostFile
 * The name of the file on the host. This option is required.


 * LocalFile
 * The name of the file on the workstation. This option is required.
 * If doing a receive, this option can also specify a local folder. The name of the local file is then taken as the same as the name of the host file.


 * Host
 * Defines the host type: tso (the default), vm or cics.


 * Mode
 * Specifies whether the file contains text or opaque data.
 * The value ascii indicates a text file, which may involve translation between the host and workstation. This is the default.
 * The value binary indicates a binary file, which is untranslated.


 * Cr
 * Defines how end-of-line (the newline character or the CR/LF sequence) is handled during the transfer of text files.
 * The value remove causes end-of-line to be stripped from local files before transferring them to the host
 * The value add causes end-of-line characters to be added to each host file record before transferring it to the local workstation. This is the default.
 * The value keep causes end-of-line to be preserved when transferring files.


 * Remap
 * Controls EBCDIC translation for text files.
 * The value yes (the default) causes the emulator to remap the text encoding to ensure maximum compatibility between the workstation's character set and encoding and the host code page.
 * The value no causes the emulator to pass the text to or from the host as-is, leaving all translation to the IND$FILE program on the host.


 * Exist
 * Controls what happens when the destination file already exists in Direction=receive mode.
 * The value keep (the default) preserves the file, causing the Transfer action to fail.
 * The value replace overwrites the destination file with the source file.
 * The value append appends the source file to the existing destination file.


 * Recfm
 * Controls the record format of files created on the host. (TSO and VM hosts only.)
 * The value fixed creates a file with fixed-length records.
 * The value variable creates a file with variable-length records.
 * The value undefined creates a file with undefined-length records (TSO hosts only).


 * Lrecl
 * Specifies the record length (or maximum record length) for files created on the host. (TSO and VM hosts only, and only for Recfm=fixed and Recfm=variable.)


 * Blksize
 * Specifies the block size for files created on the host. (TSO and VM hosts only.)


 * Allocation
 * Specifies the units for the PrimarySpace and SecondarySpace options: tracks, cylinders or avblock. (TSO hosts only.)


 * PrimarySpace
 * Primary allocation for a file. The units are given by the Allocation option. Required when the Allocation is specified as something other than default. (TSO hosts only.)


 * SecondarySpace
 * Secondary allocation for a file. The units are given by the Allocation option. (TSO hosts only.)


 * Avblock
 * Average block size, required when Allocation specifies avblock. (TSO hosts only.)


 * BufferSize
 * Buffer size for DFT-mode transfers. The value can range from 256 to 32768. Larger values give better performance, but some hosts may not be able to support them.


 * Defaults
 * Use default values for all options.

Related resources
Resources can be used to specify default values for each of the options.