serverhost | String Name or IP address of the FTP server (for example, ftp.netscape.com). | |
serverport | String Port number on which the FTP server listens for requests (for example, 4566). The default is 21. | |
dataport | String Optional. Listener port number of the data transfer channel (for example, 3345). If you do not specify dataport, the Integration Server will choose the listener port number. This value is used only when the transfertype value is active. | |
username | String Valid FTP user on the remote FTP server (for example, anonymous). | |
password | String Optional. Valid password for the FTP user specified in username (for example, someone@somewhere). | |
account | String Optional. The user name for an account on the FTP server. Specify account if your FTP host requires account information. The account is defined in the FTP protocol to further identify the user that is identified by the username and password input variables. | |
transfertype | String Type of the FTP data transfer mode (passive or active). The default is active. | |
encoding | String Optional. Default character set for encoding data transferred during this session. Specify an IANA-registered character set (for example, ISO-8859-1). If you do not set encoding, the default JVM encoding is used. | |
serverencoding | String Optional. Specifies the encoding this service uses to convert the incoming FTP command string to encoded bytes that are supported by IANA and the FTP server. If the parameter is null, the service uses the 'UTF-8' character set to encode the FTP command String to bytes. | |
timeout | String Optional. Time (measured in seconds) to wait for a response from the FTP server before timing out and terminating the request. The default is to wait forever. | |
secure | Document Indicates whether the FTP session is with a secure FTP server. Note:Integration Server does not support FTPS (FTP over SSL) requests through FTP proxy. Note: Integration Server does not support implicit FTPS, which is also deprecated. | |
Key | Description | |
auth | String The kind of authentication mechanism to use: None, SSL, TLS, or TLS-P. None specifies that the FTP session is with a non-secure FTP server. This is the default. If the value of auth is None, the securedata variable is ignored. TLS-P is a shortcut that is equivalent to the sequence AUTH TLS, PBSZ 0, and PROT P. If the value of auth is TLS-P, the securedata variable is ignored. | |
securedata | String Use the value false for a client sending PROT C (Data Channel Protection Level Clear). Use the value true for a client sending PROT P (Data Channel Protection Level Private). Note: If you do not set a value, the default is false. | |
useJSSE | String Optional. Whether to enable the use of the Java Secure Socket Extension (JSSE) library for creating outbound FTPS connections. Set to: yes if the connection requires the use of TLS 1.1, TLS 1.2, or TLS 1.3. When set to yes, Integration Server creates the connection using the Java Secure Socket Extension (JSSE) library. no if the connection does not require support for TLS 1.1, TLS 1.2, or TLS 1.3. When set to no, the connection supports only TLS 1.0 which is not secure. The Entrust IAIK library is used to create the outbound FTPS connection. When the value of useJSSE is not specified, Integration Server uses the value set for the watt.net.ssl.client.ftps.useJSSE server configuration parameter. Note: A value of yes or no for the useJSSE input parameter overrides the value of the watt.net.ssl.client.ftps.useJSSE server configuration parameter. To control the cipher suites used on JSSE sockets that are used while making outbound FTPS requests, set the server configuration property watt.net.jsse.client.enabledCipherSuiteList. For more information, see webMethods Integration Server Administrator’s Guide. When using this service to set up an FTPS connection over JSSE with an FTPS server, you must ensure that the FTPS port on the destination Integration Server is configured with the Use JSSE parameter set to Yes. For more information about configuring the FTPS port, see webMethods Integration Server Administrator’s Guide. | |
newSession | String Optional. Flag indicating whether a a new FTP session will be created for this FTP operation. Set to: yes to create a new session for this FTP operation. no to use the current session, if one is available, for this FTP operation. This is the default. | |
clientTimeout | String Optional. Specifies the idle time-out, measured in seconds, for this FTP session. If clientTimeout is set to 0 (zero), the session will never time out. The default is 600 seconds (10 minutes). | |
proxyAlias | String Optional. Name of the proxy alias for the proxy server through which Integration Server routes the FTP request. If you do not specify a proxyAlias, Integration Server routes the FTP request through the proxy server specified in the default FTP proxy alias. If there is no default FTP proxy alias, the action taken by Integration Server depends on the value specified for the watt.net.proxy.useNonDefaultProxies parameter. If the watt.net.proxy.useNonDefaultProxies parameter is set to true, Integration Server routes the FTP request through the proxy server in any configured FTP proxy alias. If the Integration Server does not have any defined FTP proxy aliases, Integration Server sends the FTP request directly to the FTP server or throws an exception depending on the settings specified for the watt.net.proxy.fallbackToDirectConnection parameter. If the watt.net.proxy.useNonDefaultProxies parameter is set to false, Integration Server sends the request to the remote server using a direct connection. For more information about proxy server usage, refer to webMethods Integration Server Administrator’s Guide. |
sessionkey | String Unique key for the current FTP session. This session key must be provided to execute most other services in pub.client.ftp. |
returncode | String Standard FTP protocol return code. |
returnmsg | String Standard FTP protocol return message. |
logmsg | String FTP log messages for the entire user session. |