LIST

PATH

If no PATH keyword is present, the current directory is used. The path can contain operating system wild characters.

FORMAT

The default value *AUTO uses auto-detect list format:

• *AUTO - Auto-detect LIST format.
• *NAME - Uses NLST subcommand. 1 column.
• *UNIX -List is in UNIX format. 9 columns.
• *UNIX8 - List is in UNIX format. 8 columns.
• *UNIX9 - List is in UNIX format. 9 columns.
• *ISERIES - List is in IBM i format.
• *WINDOWS - List is in Windows format.

When using FTP between IBM i servers it is important to note the FTP attributes LISTFMT value (use CHGFTPA). For example, if the FTP Attributes has LISTFMT(*UNIX) then using LIST PATH(/TMP/*.*) FORMAT(*ISERIES) will not return any data. Changing to FORMAT(*UNIX) or using the SITE COMMAND(LISTFMT 0) will return data.

DATEFORMAT

The default value *NONE means that no formatting is applied to the date field. Dates are formatted to ISO8601 format.

• *NONE - No date formatting.
• *DMY - Except the date to be in day, month, year order.
• *MDY - Except the date to be in month, day, year order.
• *YMD - Except the date to be in year, month, day order.
• *YDM - Except the date to be in year, day, month order.

DATALINK

The DATALINK keyword determines how the "control" session is initiated. The default value is *PASV.

In passive mode, *PASV, the FTP the client initiates both connections to the server. Passive mode causes the FTPService to send a PASV subcommand to the remote FTP server, the FTP server returns the port number of the socket server it has started and a data transfer channel is established from the local server using this port number. This is known as "Passive FTP" and is often used to get around firewall difficulties. Using "Passive" FTP, the local server establishes the second connection, not the remote FTP server. Most firewalls will allow your computer to transfer files in this second connection to the remote FTP server (just as it allowed your computer to establish the first connection).

Port mode, *PORT, causes the FTPService to start a socket server and informs the remote FTP server via the PORT subcommand of the port number this socket server is listening on, the remote FTP server then connects to this socket server and a data transfer channel is established.

Refer to Technical Specifications for more information.