ESLWEB Subroutine

Transfer a file from a FTP Server.

call FTP_Get (        FTP_URL_SV,
                 FTP_RemoteFile_SV,
                 FTP_LocalFile_SV,
                 FTP_Userid_SV,
                 FTP_Password_SV

                 FTP_Overwrite_BV,

                 FTP_Passive_BV)

Parameters

FTP_URL_SV

A string variable containing  the name of the FTP server.

 

FTP_LocalFile_SV

A string variable containing the name of the file on the workstation; to created or overwritten with the file received from the Host.

 

FTP_RemoteFile_SV

A string variable containing the name of the file on the Host; to be transferred to the workstation.

 

FTP_Userid_SV

The User identifier for the FTP server. This can be a NULL string, if the server supports anonymous login.

 

FTP_Password_SV

The Password credential for the User identifier. This can be a NULL string, if the server supports anonymous login.

 

FTP_Overwrite_BV

A boolean variable, which, if set to true, will allow an existing file to be overwritten.

 

FTP_Passive_BV

A boolean variable, which when set to true, switches the FTP transfer mode to "Passive".

 

Description

This function uses the internet standard File Transfer Protocol (FTP) to copy files from a specified Server to the workstation. This routine supports both the Active and Passive transfer mode. To ensure compatible with your firewall settings, set the "Passive" variable to true. The files are transferred as binary, so any type of file content is supported.

As any relative path used to specify a file will be dependent on the Current Directory, it is recommend that the full (Absolute) path be used.

To determine whether the routine has been successful, the value of the built-in function "errorlevel" should be examined. If the routine has failed (i.e. errorlevel != FTP_E_ERRORFREE), there is also an error message recorded in the "errorlog".