# MX\_ATEFILEXFR

> [HTML Version](mx_atefilexfr.htm)

_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](string.htm.md))  \[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](string.htm.md))  \[in\]

filespec of the source file on the client.

_status_  ([Signed Int](integer-signed.htm.md))  \[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\]](https://bitbucket.org/microsabio/soslib/src/master/907033/ateapx.bp) for server-to-client file transfers. 

•	[ATEAPX in SOSLIB:\[907,33\]](https://bitbucket.org/microsabio/soslib/src/master/907033/ateapx.bp) 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