Updated January 2018; see History
xcall ATEGFK, hostspec, pcspec, flags, status
ATEGFK.SBX retrieves a file from the PC via the ATE terminal connection. This is useful in situations where FTP isn't available or isn't practical.
Parameters
hostspec (String) [in]
is the destination (native or AMOS-style)
pcspec (String) [in]
is the source (PC native)
flags (Num) ( [in]
may contain zero or more of the following:
Value |
Definition |
---|---|
16 |
skip post-transfer verification |
32 |
pre-verify (skip transfer if destination matches source) |
64 |
ignore version 0 in pre-verification |
128 |
put ategfk.log in current directory rather than OPR: |
status (Signed Num) [out]
returns status of operation:
Value |
Definition |
---|---|
>0 |
file transferred |
0 |
transfer not required |
-1 |
ATE required |
-2 |
source file doesn't exist |
-3 |
file transferred but failed to verify afterwards |
-4 |
transfer failure |
See Also
• | Test program TSTATEGFK.BP in SOSLIB:[907,33]. |
• | Source, samples and related functions can be found in SOSLIB:[907,33]. |
History
2018 January 2018, A-Shell 6.4.1556, ATEGFK.SBX 1.0(105): eliminate a five second delay in the case where the source file exists but has zero bytes.
2016 April, A-Shell 6.3.1510: Routine added to A-Shell