Reviewed and revised April 2024
xcall MIAMEX, MX_ATEFILEXFR , hostfile, pcfile, status
MX_ATEFILEXFR (MIAMEX 183) provides file client-to-server transfer capability for the ATE/ATSD environment, where such transfers are otherwise inconvenient due to the typical lack of an FTP service. It uses the keyboard channel to send the raw data from the client to the server, independent of routers, firewalls, etc. A-Shell 6.1.1357 or later is required on both the server and the ATE client.
Parameters
hostfile (String) [in]
filespec of target file on the server. If it exists and matches the source, no action is taken , otherwise it will be overwritten.
pcfile (String) [in]
filespec of the source file on the client.
status (Signed Int) [out]
returns the number of bytes output to hostfile. Negative numbers constitute system error codes, or one of these:
Code |
Description |
---|---|
### |
BASIC error ### |
-99 |
platform error (only supported on ATSD/ATE) |
-98 |
invalid options |
-97 |
unable to allocate memory |
-96 |
timeout while waiting for data |
-95 |
ATE client or A-Shell/Windows version too old |
-94 |
File transferred but hash doesn't match original |
-1 |
pcfile not found |
0 |
No transfer because hostfile already matches pcfile |
See Also
• | ATEAPX in SOSLIB:[907,33] for server-to-client file transfers. |
• | ATEAPX in SOSLIB:[907,33] which acts as a wrapper to MX_ATEFILEXFR and extends the capability to ATE/Unix environments. |
History
2013 July, A-Shell 6.1.1357: Routine added to A-Shell