Performing a file transfer

The file transfer action implements IND$FILE file transfer. This action requires that the IND$FILE program be installed on the IBM host, and that the 3270 cursor be located in a field that will accept a TSO or VM/CMS command.

The file transfer action can be entered at the command prompt with no parameters, which will cause it to prompt interactively for the file names and options. It can also be invoked with parameters to define the entire transfer.

To perform a file transfer

1. With an emulator session open in an editor in the workspace, click . The 3270 Emulator File Transfer dialog box appears.
2. In the Local File Name field, enter the name of the file on the local workstation.
3. In the Host File Name field, enter the name of the file on the host.
4. In the Direction box, select one of the following to indicate the direction of the file transfer:
   • Send to host to send a file to the host
   • Receive from host to receive a file from the host
5. In the Host type box, select one of the following to indicate the type of host (which dictates the form of the IND$FILE command):
   • Host is VM/CMS
   • Host is TSO
6. In the Transfer mode box, select one of the following:
   • Transfer ASCII file if the file is a text file. It will be translated between and as necessary.
   • Transfer binary file if the file is a non-text file.
7. In the CR Handling box, select one of the following to controls how newline characters are handled when transferring Mode=ascii files:
   • Remove to strip newline characters in local files before transferring them to the host
   • Add to add newline characters to each host file record before transferring it to the local workstation
   • Keep preserving newline characters when transferring a local file to the host
8. In the Destination exists box, select one of the following to control what happens when the destination file already exists:
   • Keep preserving the file, causing the transfer action to fail
   • Replace to overwrite the destination file with the source file
   • Append to add the source file to the destination file
9. In the Record Format box, select one of the following to control the record format of files created on the host (for and hosts only):
   • Default to create a file with system defaults
   • Fixed to create a file with fixed-length records
   • Variable to create a file with variable-length records
   • Undefined to create a file with undefined-length records (hosts only)
10. In the Logical record length field, enter the record length (or maximum record length) for files created on the host ( and hosts only).
11. In the Block size field, enter the block size for files created on the host ( and hosts only).
12. In the Space Allocation Units box, select one of the following to specify the units for the Primary space and Secondary space settings below (for TSO hosts only):
    • Default
    • Tracks
    • Cylinders
    • Avblock
13. If other than Default is specified in the Space Allocation Units box, set the Primary space field as appropriate.
14. If other than Default is specified in the Space Allocation Units box, set the Secondary space field as appropriate.
15. Click Transfer File.