3.2 General File Transfer Command Options

These options apply to all the file transfer commands. This section describes each of the general options available and lists any abbreviations that can be used for each option.

filename

The name of the local file that you wish to transfer to or from the AS/400.

AS/400location

The location on the AS/400. This is specified as follows:

[library name/] [file name] [(member name)]

For more information about these terms, refer to your AS/400 documentation.

-u userID

The user ID that has been defined on the AS/400. If no user ID is specified, the file transfer program uses the value of the environment variable, SNA400FTUSERID. If this environment variable is not defined, the file transfer program prompts you for this information as follows:

Enter User ID:

-p password

The password that has been defined on the AS/400 for you. If no password is specified, the file transfer program uses the value of the environment variable, SNA400FTPASSWD. If this environment variable is not defined, the file transfer program prompts you for this information as follows:

Enter Password:

Asterisks are displayed in place of each character of the password as it is typed in.

-lu local_lu

The alias of the local LU that the file transfer program will use to communicate with the AS/400. This must match the LU alias that was configured (for more information, see Configuring SNAP-IX). If the local LU alias is not specified, the file transfer program uses the value of the environment variable SNA400FTLU. If this environment variable is not defined then the file transfer program uses the default local LU.

-plu partner_lu

The name of the partner LU alias or the fully qualified partner LU name (in ASCII) that the AS/400 will use to communicate with the file transfer program. If the string specified includes a dot (period) character, the file transfer program uses it as the fully qualified partner LU name, otherwise it uses the string as an alias. If a partner LU alias or name is not specified, the file transfer program uses the value of the environment variable, SNA400FTPLU. If this environment variable is not defined, a default partner LU alias of AS400 is used.

-f [description_filename]

Specifies the description file that will be used for the transfer. The description file is used to determine which fields are to be sent to the AS/400. (For more information about description files, see Description Files.) If the description_filename is specified, this file is used as the description file for the transfer. If the -f option is used without a description_filename, the name used is the local file name, filename, with a suffix of .fdf. If the -f option is not specified then no description file is used, and the AS/400 file is assumed to be a source type file.

-datatype conversion_type

-d conversion_type

This option defines the conversion operation which is performed on character data transferred to and from the AS/400. The value of conversion_type may be one of the following:

ASCII_TEXT

Data is converted to EBCDIC on the AS/400 from ASCII locally and from EBCDIC on the AS/400 to ASCII locally. Specifying this option is equivalent to using a description file entry of file type 1.

ASCII_DATA

EBCDIC-encoded data on the AS/400 is converted to or from ASCII locally. Other data is not converted. Specifying this option is equivalent to using a description file entry of file type 2.

NONE

No conversion is performed. Specifying this option is equivalent to using a description file entry of file type 6.

The default value is ASCII_TEXT. If a description file is also used for file transfer, the file type entry overrides the option specified here, and a warning is generated.

-hostcp host_code_page

-h host_code_page

Specifies the code page in which the file is stored on the AS/400. The default value is 37. This field is only used if conversion_type is ASCII_TEXT or ASCII_DATA.

-localcp local_code_page

-l local_code_page

Specifies the code page in which the file is stored locally. The default is ISO8859-1. This field is only used if conversion_type is ASCII_TEXT or ASCII_DATA.

-timeout secs

-t secs

Specifies the number of seconds during which the program will attempt to perform the transfer operation. If the transfer has not completed when the timeout occurs, the transfer operation is aborted. You are warned that the program aborted due to timeout as follows:

Warning: Timeout occurred. File transfer did not complete.

-crlf

Specifies that the character marking the end of each record should be changed during file transfer.

• When a file is received from the AS/400, this field specifies that the Carriage Return/Line Feed code (0x0D0A) should be added to the end of each record instead of 0x0A.

• When a file is sent to the AS/400, this field specifies that 0x0A should be added to the end of each record instead of the Carriage Return/Line Feed code (0x0D0A).