Specifications

506
Syntax: CALL "FTP.FN3" .fcSTOR FTPHANDLE%, SERV.FNAME$,
CLNT.FNAME$,
CRLF.TYPE%, UP.MODE%, REPLY%
[,DISP.MODE%]
Description: This function uploads, from the BHT to the current directory on the FTP
server, the specified file using the specified parameters.
Parameters:
FTPHANDLE% FTP client handle
SERV.FNAME$ Name for file on FTP server. Leaving this unspecified
("") uses the name in
CLNT.FNAME$ instead.
CLNT.FNAME$ Name of file to upload to FTP server
CRLF.TYPE% Line delimiter (See description under function #6
above.)
UP.MODE% Flag controlling treatment of existing files
DISP.MODE% Flag controlling a progress display consisting of an 8-
digit number giving the number of bytes transferred
See the
DISP.MODE% under function #6.
Return value:
REPLY% Server response to FTP command
Example: Uploading data file
CLNT.FNAME$ = "MASTER1.DAT" ’Name of file on BHT
SERV.FNAME$ = "" ’Name on server
’Same as on BHT
CRLF.TYPE% = .ftCRLF ’Server line delimiter: CR-LF combination
UP.MODE% = .ftUpAPPE ’Upload mode: Append
CALL "FTP.FN3" .fcSTOR FTPHANDLE%, SERV.FNAME$, CLNT.FNAME$, CRLF.TYPE%, _
UP.MODE%, REPLY%
Example: Uploading program file, with progress display
CLNT.FNAME$ = "SAMPLE.PD3" ’Name of file on BHT
SERV.FNAME$ = "" ’Name on server
’Same as on BHT
CRLF.TYPE% = .ftCRLF ’Server line delimiter: CR-LF combination
UP.MODE% = .ftUpSTOR ’Upload mode: Overwrite
DISP.MODE% = .ftDisp ’Enable progress display
CALL "FTP.FN3" .fcSTOR FTPHANDLE%, SERV.FNAME$, CLNT.FNAME$, CRLF.TYPE%, _
UP.MODE%, REPLY%, DISP.MODE%
.fcSTOR Upload file to FTP server
.ftUpSTOR 0 Overwrite existing file
.ftUpAPPE 1 Append to existing file. Create new file if neces-
sary.