Please enable JavaScript to view this site.

A-Shell Reference

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

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