sessionkey | String Unique key for the current FTP session. The sessionkey is returned by the pub.client.ftp:login service. | |
transfermode | String FTP file transfer mode (ascii or binary). The default is ascii. | |
localfile | String Optional. Name of a local file where the retrieved file is to be saved. | |
remotefile | String Name of the remote file. | |
encoding | String Optional. Character set in which the file is encoded. This variable is required to convert the file to bytes correctly. Specify an IANA-registered character set (for example: ISO-8859-1). If this variable is null, the encoding currently set for the FTP session is used. If encoding was never set for this FTP session, the default JVM encoding is used. | |
largefilethreshold | String Optional. Defines the size (in bytes) of a "large" file. For more information, see the Usage Notes. | |
If you... | Then... | |
Set to 0 | All files will be considered large files. This means: The output parameter islargefile will always be true. The file content will be returned in the output parameter contentstream (as a java.io.InputStream object). The output parameter content will be null. | |
Set to any value greater than 0 | Any file larger than the value you specify will be considered large. This means: The output parameter islargefile will be true. The file content will be returned in the output parameter contentstream (as a java.io.InputStream object). The output parameter content will be null. | |
Leave blank | No file is considered large. This means: The output parameter islargefile will always be false. The file content will be returned in the output parameter content. The output parameter contentstream will be null. | |
cleanlinefeeds | String Optional. Indicates whether the service should retain or remove carriage return characters at the end of each line of text. Set to: true to remove carriage returns. false to retain carriage returns. This is the default. |
content | byte[ ] Data retrieved from the remote file. |
returncode | String Standard FTP protocol return code. |
returnmsg | String Standard FTP protocol return message. |
logmsg | String FTP log messages for the entire user session. |
islargefile | String Indicates whether the file is considered to be large (as specified by the input parameter largefilethreshold). A value of: true indicates that the file is larger than the value of largethreshold. false indicates that the file is not larger than the value of largethreshold (or largethreshold is blank). |
contentstream | Object An java.io.InputStream object. |
Tip: | Due to the impact to the throughput of pub.client.ftp:get when streaming is enabled, you should set the value for largefilethreshold to a sufficiently large value so that it causes only minimal degradation to throughput and yet allows the service to retrieve large files without encountering an OutOfMemory exception. |