HOST - UFTP configuration option

Description

The HOST option specifies the name of the remote host to connect to on which the command(s) are to be run.

Usage

Specification Method

Parameter / Value

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

-i name



(tick)

(tick)

(tick)

Command Line, Long Form

-host name



(tick)

(tick)

(tick)

Environment Variable

UFTPHOST=name



(tick)

(tick)

(tick)

Configuration File Keyword

n/a






Value

name is name of the remote host to connect to.

name can be:

  • Fully qualified domain name of the host
  • Local network name of the machine on your network
  • IP address

For example:

  • -host dev-server
  • -host 192.168.33.40
     

Optionally, you can include a protocol identifier.

For example:

Note

You also can specify a protocol by using the PROTOCOL configuration option.

Updates for Explicit FTPS (FTPES) Support

Explicit FTPS support was added to UFTP for Universal Agent 7.1.0.0. When an FTP server enables explicit TLS/SSL support, it allows clients to request encrypted sessions over the standard FTP port 21. This is different from implicit TLS/SSL support, which requires a connection to a unique, well-known port (990 by default) that ONLY accepts TLS/SSL-enabled client requests.

UFTP has always offered implicit FTPS support via the FTPS protocol value.

Because an FTP client may not always know whether the FTP server's port 21 is accepting SSL-enabled connections (thereby permitting unencrypted, plain-text FTP sessions), explicit FTPS is not really a distinct protocol per se. Therefore, UFTP offers explicit FTPS support by applying new options and supported values to the existing FTP PROTOCOL value.

Requesting an FTPES Session Via the HOST Option

One way that UFTP provides FTPES support is by allowing the -host value to be prefixed with ftpes://. UFTP will still use the FTP protocol, but when it will request a session using TLS/SSL with the FTP server. If the FTP server does not have TLS/SSL support enabled, an unencrypted, plain-text session will be created.

Universal Controller Task Support

The ftpes:// prefix also enables compatibility with current and previous versions of Universal Controller. The existing File Transfer and Remote File Monitor forms can be used to request an FTPES connection simply by choosing the FTP protocol and updating the FTP Server value with the ftpes:// prefix.

Requesting an FTPES Session Via New UFTP Options

UFTP also provides explicit FTPS session support with the ENABLE_SSL option, new for Universal Agent 7.1.0.0. When this option is yes, the -host value does not require any special prefixes. 

Setting ENABLE_SSL to yes AND adding the ftpes:// prefix to the -host value is supported, but unnecessary. The ftpes:// prefix causes UFTP to behave as though ENABLE_SSL were set to yes.