Please enable JavaScript to view this site.

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

Created with Help+Manual 9 and styled with Premium Pack Version 5 © by EC Software