SET Parameter Reference

ACCOUNT

<string>

(there is no default value)

Specifies the name of the account to log into on an FTP server. This setting does not apply to SFTP connections.

ASCII-CLIENT-TYPE

<value>

(Default: WINDOWS)

When TRANSLATE-FILES and/or TRANSLATE-DIRECTORY-LISTING is YES, specifies the character set to use on the client PC during ASCII file transfers. Possible values are: PC-ENGLISH (IBM PC extended characters), PC-SLAVIC (DOS 852 code page), WINDOWS, WINDOWS-ANSI, WINDOWS-LATIN-2, WINDOWS-CYRILLIC, WINDOWS-GREEK, YUASCII. This setting does not apply to SFTP connections.

AUTO-SERVER- UPDATE

YES | NO

(Default: YES)

This global parameter specifies whether the server directory listing shown in the right pane is updated when you perform any operation that adds or deletes files or directories on the server.

CONFIRM-DELETE

YES | NO

(Default: YES)

This global parameter specifies whether the client should prompt for confirmation before deleting a file.

CREATE-8.3-FILENAMES

YES | NO

(Default: NO)

Specifies whether files transferred to the client use the 8.3 file naming convention.

DELETE- TRAILING-SPACES

YES | NO

(Default: NO)

Specifies whether to delete trailing spaces during ASCII file transfers from the server. This setting does not apply to SFTP connections.

FULL-TO-HALF-FROM- SERVER

YES | NO

(Default: NO)

Applies to ASCII file transfers from the server. If you want messages and files with DEC Kanji or JIS Kanji characters to be converted from full- to half-width Katakana when received from the server, set this value to YES. The ASCII-SERVER-TYPE parameter determines which Kanji character set is used during the conversion.

ISO7-TO-ROMAN8

YES | NO

(Default: NO

Applies to ASCII file transfers from the server when TRANSLATE-FILES is YES. If you want files with ISO-7 characters to be converted to files with Roman 8 characters when received on the PC, set this value to YES. The NATIONAL-REPLACEMENT-SET parameter determines the character conversion.

MCS-TO-NRC

YES | NO

(Default: NO)

Determines character set translation during ASCII file transfers to the server when TRANSLATE-FILES is YES. When set to YES, characters are translated from the DEC Multinational character set to the current national replacement character set. The NATIONAL-REPLACEMENT-SET value determines the character conversion.

NRC-TO-MCS

YES | NO

(Default: NO)

Determines character set translation during ASCII file transfers from the FTP server to the PC when TRANSLATE-FILES and/or TRANSLATE-DIRECTORY-LISTING is YES. When set to YES, characters are translated from the current national replacement character set to the DEC Multinational Character set. The NATIONAL-REPLACEMENT-SET value determines the character conversion. This setting does not apply to SFTP connections.

PASSTHROUGH- AUTHENTICATION

YES | NO

(Default: NO)

You must be connected to a site to change this global passthrough server property. Set PASSTHROUGH-AUTHENTICATION to YES if your passthrough server requires you to provide a user name and password to log into the passthrough server. This setting is ignored if USE-PASSTHROUGH-SERVER is set to NO or if PASSTHROUGH-SERVER-STYLE is set to SITE-SERVERNAME.

PASSTHROUGH- SERVER-STYLE

<value>

(Default: SITE-SERVERNAME)

You must be connected to a site to change this global passthrough server property. The FTP Client sends different commands to log into the passthrough server and connect to an FTP server, based on the style of server you specify. .

PASSTHROUGH- USERNAME

<string>

(there is no default value)

You must be connected to a site to change this global passthrough server property. Use this setting to specify a valid user name registered on the passthrough server for your local network. For case-sensitive servers, you must use the appropriate case when entering the PASSTHROUGH-USERNAME value.

PORT-NUMBER

0 - 65535

(Default: 0)

Specifies a non-standard TCP service port number or socket for FTP. The default value 0 (zero) directs the FTP Client to use the standard service port for FTP, which is 21. This setting does not apply to SFTP connections.

PROXY-SERVER

<value>

This is a read-only parameter that indicates whether the FTP Client connects to this site using a passthrough server or SOCKS proxy server. The possible values are PROXY SERVER and SOCKS PROXY.

RESUME-PARTIAL- TRANSFERS

ALWAYS | NEVER | ASKUSER

(Default: ASKUSER)

This session-specific parameter is relevant for downloading files from the server in BINARY format. When you GET a server file, the FTP Client detects whether a prior incomplete download operation occurred for that file. This parameter allows you to control whether the Client prompts for input when it detects that a prior partial download occurred. Auto resume compares the size of the source file to the size of the incomplete target file to determine at what point in the source file it should resume the transfer. Using the binary method ensures that the file created on the local machine matches the size of the source file.

SAVE-PASSWORD

YES | NO

(Default: NO)

Specifies whether the site password is saved.

SERVER-HOME- DIRECTORY

<string>

Specifies the path to a home (default) directory for the FTP or SFTP site to which you are currently connected. When a connection to the FTP or SFTP site is opened, the server working directory is set automatically to the specified home path. If no value is specified, the user home directory is used.

SMART-ASCII- TYPES

<string>

(DEFAULT: txt,bat,htm,html,ini)

This global parameter specifies all the file extensions used to identify files that should be transferred using the ASCII transfer method when TRANSFER-METHOD is set to SMART. To specify a list of file extensions, separate each extension with a comma. For example:

SET SMART-ASCII-TYPES txt,bat,htm,html,ini

SMART-TENEX- TYPES

<string>

(there is no default value)

This global parameter specifies all the file extensions used to identify files that should be transferred using the Tenex (Local 8) transfer method when TRANSFER-METHOD is set to SMART. To specify a list of file extensions, separate each extension with a comma. For example:

SET SMART-TENEX-TYPES edd,gol,mmd,lad

SPACES-PER-TAB

1-20

(Default: 8)

Applies to ASCII file transfers. Specifies the number of consecutive spaces that are converted to a single tab character (for SPACES-TO-TABS) or the number of spaces that a single tab character is converted into (for TABS-TO-SPACES). This setting does not apply to SFTP connections.

TABS-TO- SPACES

YES | NO

(Default: YES)

When set to YES, tab characters in local files are converted to space characters in server files during ASCII transfers to the server. The FTP Client replaces each tab character with the number of spaces necessary to fill out to the next tab stop, as specified by the SPACES-PER-TAB parameter. This setting does not apply to SFTP connections.

TIME-SINCE- LOGIN

(Read-only)

This is a read-only parameter that indicates how long you have been logged into the server. The current time format specified in the International dialog box in the Windows Control Panel determines how time data displays.

TIMEOUT- SESSION

0 - 65535

(Default: 120)

Specifies the maximum number of seconds to wait for data packets being transferred to or from the host. If nothing is received within the period specified, a timeout error displays and the transfer is aborted. Setting this parameter to 0 (zero) prevents the FTP Client from ever timing out when waiting for a response. This setting does not apply to SFTP connections.

TRANSFER- DISPOSITION

<value>

(Default: OVERWRITE)

This global parameter specifies a file transfer mode that tells the client what to do if the client or server file being transferred already exists at the destination. The possible values are APPEND, PROMPT, CANCEL, OVERWRITE, SKIP, UPDATE, UNIQUE. UPDATE directs the client to overwrite the destination file only if the file being transferred is newer than the destination file. UNIQUE directs the client to create a new unique name.

TRANSFER-METHOD

<value>

(Default: SMART)

This global parameter specifies the file transfer method for the client. The possible values are ASCII, BINARY, TENEX, SMART.

TRANSLATE- DIRECTORY- LISTING

YES | NO

(Default: NO)

Specifies whether to enable translation when characters sent from the server are written to the screen. Use this setting to translate file names in server directory listings that display in the FTP Client user interface.

Setting this parameter to YES enables the following SET parameters: SET ASCII-CLIENT-TYPE, SET ASCII-SERVER-TYPE, SET NATIONAL-REPLACEMENT, ISO7-TO-ROMAN8, and SET NRC-TO-MCS.

This setting does not apply to SFTP connections.

USE-PASSTHROUGH- SERVER

YES | NO

(Default: NO)

Specifies whether to connect through a passthrough server when opening connections to the current FTP site. When set to YES, the FTP Client uses the following global settings to make the connection to the passthrough server: PASSTHROUGH-SERVER-STYLE, PASSTHROUGH-SERVERNAME, PASSTHROUGH-USERNAME, PASSTHROUGH-PASSWORD, and PASSTHROUGH-AUTHENTICATION.

USERNAME

<string>

(there is no default value)

Specifies a valid user name registered on the current server. For case-sensitive servers, you must use the appropriate case when entering the USERNAME value.