FTP URL (-URL)

The FTP URL adapter command (-URL) is required for connection to an FTP server. Specify the file names to be retrieved (adapter source) or created and appended (adapter target).


-URL [FTP:[//]][ftp_user[:ftp_pass]@][ftp_host[:ftp_port]]
[/[/]][dir/[dir/...]] [filename][;type=xfer_type[+]]
Option Description

FTP:

Specify as a connection to an FTP server. If not specified, FTP: is assumed, along with the //. Another / is required to separate the user and host parameters from file and transfer type, if specified.

ftp_user

Specify the user name to connect to the FTP server. Unless you are also specifying a password, this parameter must be followed by @ if you specify ftp_host.

:ftp_pass

Specify the password that authenticates the user name. This parameter must be followed by @ if you are also specifying ftp_host.

ftp_host

Specify the FTP server name or address to which to connect. If not specified, the default of localhost is assumed.

:ftp_port

The port name or number to use for connection

dir/ ...

Specify the directory path for the file. The ellipsis (...) indicates this field can repeat, depending on your directory structure.

filename

Specify the name of the target file. This is required for an adapter target but optional for an adapter source. If not specified, all files in the path are retrieved.

;type=xfer_type

Specify the transfer type or mode. The supported transfer types vary from server to server. Depending on the server, there might be additional or omitted transfer types. Valid transfer types are:

A[len][!] ASCII

where len specifies the optional record length to which to pad or truncate the record and ! indicates no line terminator for the record(s).

When sending an FTP request to the AS/400, the file must first be created on the AS/400 in order for the len parameter to pad the record correctly.

Transfer type
Description
I
Directory (file names only)
LB
Local 8-bit types (usually equivalent to I)
D
Directory (file names only)
D1
Directory (file names only)
D2
Directory (server-defined format)
D3
Directory (easily parsed line format, as defined in Internet draft draft-bernstein-eplf-02.txt)
D4
Directory (machine-readable list format as defined in Internet draft draft-ietf-ftpext-m1st-02.txt)

+

Append the transferred data to the existing file.

An additional forward slash (/) is required to separate the user and host parameters from file and transfer type, if specified.