ATEGFK

Added May 2016

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

 

Comments

ATEGFK.SBX may work with ATE 6.1.1357+ but will be much better with ATE 6.1.1370.0+.

See test program TSTATEGFK.BP. Both are included in [907,33] of the SOSLIB along with other ATE file-transfer related utilities.

See Also

MX_ATEFILEXFR

ATEAPX.SBX

• Source, samples and related functions can be found in SOSLIB:[907,33].

 

History

2016 April, A-Shell 6.3.1510:  Routine added to A-Shell