ATEGFK.SBX

New SOSLIB routine 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. Syntax:

xcall ATEGFK, hostspec, pcspec, flags, status

parameters

hostspec  (str)  [in]

is the destination (native or AMOS-style)

pcspec  (str)  [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.

Also see MX_ATEFILEXFR and ATEXFR.SBX