Updated October 2016; see History
This is the A-Shell implementation of ZTERM's AMOS-to-PC file transfer routine. It can be used when transferring files to/from an A-Shell host and a connected PC that is running either ZTERM or ATE. Binary transfers are performed unless ASCII is specified with the /A switch. The following syntax can be displayed by entering ZTXFER with no arguments. See also the discussion on the ATE environment variable.
Note that ZTXFER requires an FTP server, so it won't work on most Windows servers unless an FTP server has been specifically set up.
To send from host to PC:
ZTXFER{/A} host-name PC-name
or
ZTXFER{/A} host-name
To send from PC to Host:
ZTXFER{/A} host-name=PC-name
or
ZTXFER{/A} =PC-name
Using with ATE
ZTXFER supports wildcards if the client is ATE. Examples:
Copy all files from current directory to PC:
.ZTXFER *.* C:\VM\MIAME\DSK0\111222
Copy all RUN files from PC to current directory
.ZTXFER = C:\VM\MIAME\DSK0\111222\*.RUN
Copy A*.B* from PC to BAS:
ZTXFER BAS: = C:\VM\MIAME\DSK0\111222\A*.B*
ZTXFER also supports an /ATE switch to force alternative transfer protocol—i.e. using ATE terminal channel. This was already automatic for transfers between an ATE client and a Windows server, but now can be forced in other situations. For example, under UNIX, FTP/SFTP transfers may be blocked by some security or other obstacle, while the ATE terminal channel would work.
Comments
See FTP Debugging for tips on debugging ZTXFER FTP-based transfers.
Also see ATEAPX and ATEGFK for alternate file transfer possibilities.
History
2016 October, A-Shell 6.3.1531: ZTXFER.LIT 1.4(108) implements /ATE switch.
2014 March, A-Shell 1381: ZTXFER.LIT 1.3(107) now supports filenames that exceed the 10.3 file.ext format. Also now treats server destination of "*" or "*.*" as equivalent to ""—i.e. uses file.ext from PC.
2013 December, A-Shell 1370: ZTXFER.LIT 1.3(106) now supports PC to Windows server file transfers using the AG_GETFILEDATA protocol introduced in 6.1.1357 and vastly improved in 6.1.1370.0. PC to server file transfers are now typically 1 MB/sec, without requiring any special servers or ports. For the UNIX server world, it also supports a new /2 switch to invoke the new FTP/SFTP protocol (implemented in ASHNET.DLL 1.6.139) if it is available.