Specifications

Chapter 18. TCP/IP
503
Syntax:
CALL "FTP.FN3" .fcRETR FTPHANDLE%, SERV.FNAME$,
CLNT.FNAME$,
CRLF.TYPE%, CRLF.MODE%, REPLY% [,FLD$]
[,DISP.MODE%]
Description: This function downloads, from the current directory on the FTP server to
the BHT, the specified file using the specified parameters.
Parameters:
FTPHANDLE% FTP client handle
SERV.FNAME$ Name of file to download from FTP server
CLNT.FNAME$ Name for file on handy terminal. Leaving this unspeci-
fied ("") uses the name in
SERV.FNAME$ instead.
Note:
SERV.FNAME$ and CLNT.FNAME$ must have the same type
(file extension): user program (.PD3), extension library (.FN3 or .EX3), or
data file (all other extensions). Otherwise, the run-time error 32h is the
result.
CRLF.TYPE% Line delimiter
CRLF.MODE% Treatment of line delimiters in records and trailing
spaces in fields
Note:
CRLF.MODE% will be ignored for files except
data files.
.fcRETR Download file from FTP server
.ftCRLF 0 CR-LF combination
(Treat CR-LF combinations as delimiters. Use
this value when the data file delimits records with
CR-LF combinations.)
.ftCR 1 LF
(Treat LFs as delimiters. Use this value when the
data file delimits records with LFs.)
.ftLF 2 CR
(Treat CRs as delimiters. Use this value when
the data file delimits records with CRs.)
.ftNONE 3 None
Use this value when the data file does not delimit
records.
.ftRcdSepa
0
Treat line delimiters in records as SEPARATORS.
TRIM trailing spaces in fields.
.ftRcdData
1
Treat line delimiters in records as DATA.
TRIM trailing spaces in fields.
.ftLspDel
10
Treat line delimiters in records as SEPARATORS.
RETAIN trailing spaces in fields.
.ftLspData
11
Treat line delimiters in records as DATA.
RETAIN trailing spaces in fields.