Specifications
504
FLD$ Field lengths in bytes. Delimit the field length specifi-
cations with commas (,) or semicolons (;). (This
parameter applies only to downloaded data files.)
"<field length 1> [,<field length 2>,... <field length n>]"
(n=1 to 16, field length = 1 to 254)
DISP.MODE% Flag controlling a progress display consisting of an 8-
digit number giving the number of bytes transferred
Return value:
REPLY% Server response to FTP command
Example: Downloading a data file
SERV.FNAME$ = "MASTER.DAT" ’File name on server
CLNT.FNAME$ = "" ’Name for file on the BHT
’Same as on server
CRLF.TYPE% = .ftCR ’Server line delimiter: LF
CRLF.MODE% = .ftRcdSepa ’Data composition
’There are no line delimiters in the data.
FLD$ = "3, 2, 1" ’Field lengths: 3, 2, 1
CALL "FTP.FN3" .fcRETR FTPHANDLE%, SERV.FNAME$, CLNT.FNAME$, CRLF.TYPE%, _
CRLF.MODE%, REPLY%, FLD$
Example: Downloading a program file, with progress display
SERV.FNAME$ = "SAMPLE.PD3" ’File name on server
CLNT.FNAME$ = "" ’Name for file on the BHT
’Same as on server
CRLF.TYPE% = .ftCRLF ’Server line delimiter: CR-LF combination
CRLF.MODE% = .ftRcdSepa ’Data composition: Will be ignored for
’files except data files
DISP.MODE% = .ftDisp ’Enable progress display
CALL "FTP.FN3" .fcRETR FTPHANDLE%, SERV.FNAME$, CLNT.FNAME$, CRLF.TYPE%, _
CRLF.MODE%, REPLY%, DISP.MODE%
.ftNotDisp 0 Disable
.ftDisp 1 Enable