Copyright: Copyright 1999 Ipswitch, Inc.


Main Window
WS_FTP Pro Window

When you have established a connection between your local PC and an FTP site, the WS_FTP Pro main window displays the files and folders for your PC in the Local System list box (on the left) and the files and folders of the FTP site in the Remote System list box (on the right).

•	Note: In the 16-bit version of WS_FTP Pro, each column contains two list boxes: the top list box shows the available folders; the bottom list box shows the files in the currently selected folder.

The current folder is shown at the top of each column. The list box below the current folder shows all of the files and folders within the current folder. Icons are used to identify files and folders. Any disk drives that you can access also appear in the list.

The buttons to the right of each column provide file and folder operations for that column. These are shown below, from top to bottom.

ChgDir

MkDir

RmDir (16-bit version only; in 32-bit version, use Delete)

File Mask

View

Exec

Rename

Delete

Refresh

DirInfo

•	Note: The above commands, as well as some additional commands are available from the right-mouse menu. Select a file or folder and use the right-mouse menu.

Folder options ("classic" user interface)

To change folders in the WS_FTP Pro classic user interface, you can edit the folder path in the text box, or you can use the ChgDir button. Also, if you enable Remember directories in the Session options, the drop-down list for both the local and remote current folders will show the folders you visited during the last session.

Sort options (16-bit version)

You can use the column headings (Name, Date, Size) above the Local System and Remote System list boxes to sort the files and folders shown in the list box. See Sorting Directories and Files.

Additional Items Available from Pop-up Menu

Sort (32-bit version only)

Edit File (only in 32-bit version, remote system list box)

Move Files

chmod (UNIX)

Message Log

Below the list boxes, there is a message area that logs all queries from the WS_FTP Pro client (your PC) and all responses from the FTP site. You can double-click in this area to expand the listing. You can also click the LogWnd button to display the messages in a window.


Note to Help Author:

This document used to be the only document for building Help files for WS_FTP Pro Classic: both the 16bit and 32 bit versions – all the way through release 5.0.

All the topics that used to be in this file have been moved to new documents as follows:

16bit.doc

Contains the WS_FTP Pro Classic 16-bit context-sensitive main screens brought up by the Help buttons in

•	the two panels of Site Properties (help_connect and help_adv_connect),

•	the one Help button in the first screen users see after clicking the Options button (help_options), and

•	the Help buttons on each of the six panels of Program Options.

32Clasic.doc

Contains all the context-sensitive main screens brought up by the Help buttons in WS_FTP Classic (32) Program Options, PLUS all other topics not included in the other files in this project. This file is the bulk of what used to be in ws_ftp.doc.

Defs.doc

Contains all popup definitions for WS_FTP Pro Classic (16&32) and Explorer, and FTP Server.

Fieldlvl.doc

Contains all the WS_FTP Pro Classic 16 & 32 topics that would be WhatsThis topics if we had WhatsThis help (for both 16-bit and 32-bit WS_FTP Pro). These are the topics that pop up when you select the popup hotspots in the “context-sensitive main screens” listed above in 16bit.doc and 32Clasic.doc.

new_site.doc

All topics for Add Site or New Site dialogs in WS_FTP Classic (16&32) and Explorer.

ritemous.doc

All topics for WS_FTP Classic (16&32) right-mouse menu.

siteprop.doc

All topics for Site Properties in WS_FTP Pro Classic (32-bit) and Explorer. (not 16-bit)


WS_FTP Pro (16-bit version) Table of Contents

What is WS_FTP Pro?

New in Version 6

Installation

Uninstalling

The WS_FTP Pro Window

Downloading Patches and New Versions

WS_FTP Pro Development Kit

Connecting to FTP Sites

Overview

Using an Existing Site

Creating a New Site

Connecting without Configuring a Site (Quick Connect)

Organizing Sites in Folders

Working with Files

Overview

Transferring Files

Moving Files

Finding Files and Folders

Viewing Files

Executing Files

Editing Files

Renaming Files

Deleting Files

Changing Permissions on a UNIX file

Associations Options

Converting File Extensions

Working with Folders

Changing the Drive

Changing Folders

Creating and Removing Folders

Refreshing the Display

Displaying File and Folder Information

Sorting Files and Folders

Options

ALL

Program Options

Session Options

Pro Options

ASCII Extensions

Extensions Conversions

File Associations

Configuring FTP Sites

Basic Site Properties

Advanced Site Properties

FTP Commands

Overview

QUOTE command

SITE command

STOU command

Working with UNIX FTP Sites

Viewing hidden files

Changing permissions

Viewing links

Sounds

Problems

Hints

Directory Display Problems

Troubleshooting

Copyright © 1992-1998 Ipswitch, Inc.


Options
Program Options

WS_FTP Pro provides many options through which you can tailor its operation to meet your particular file transfer needs. To access these options, click the Options button in the main window. A dialog box appears with a number of options.

Program Options. General and Advanced Options affect the layout and operation of WS_FTP Pro.

Session Options. Session options affect the current session (and session defaults).

Pro Options. Pro options affect the overall operation of WS_FTP Pro.

ASCII Extensions. Extensions are used for Auto Mode (auto detect binary/ASCII).

Extension Conversions. You can change extensions on transfer.

File Associations. Associations affect execution by Exec button.

Save Directory Names

Save Window Locations


Program Options
Options, Program Options

Options available in this dialog affect the display and operation of WS_FTP Pro.

Alternate Screen Layout

Show Buttons at Top of Screen

Show Full Directory Information

Auto Save Host Configurations

Verify Deletions

Show Connect Dialog on Startup

Debug Messages

List Box Font

Scale Fonts

Text Viewer

E-Mail Address

Log filename

Enable log

Double-click Action

Transfer Rate Display

Network buffer receive size

Network buffer transmission size


Session Options
Options, Session Options

The settings in this dialog box can be applied in two different ways: they can affect just what you're currently working on, or they can always be in effect.

If you want the settings to remain in effect only until you exit WS_FTP Pro, set the desired options and click Apply or OK. (Do not click Set as default.)

If you want the settings to remain in effect when you re-start WS_FTP Pro, set the desired options and click Set as default.

Host Type

Auto Update Remote Directories

Show Transfer Dialog

Use Passive Transfer Mode

Sorted List Boxes

Use Firewall

Force Lowercase

Convert Extensions

File Names:

Send Unique (host assigns name)

Receive Unique (PC assigns name)

Prompt for Destination File Names

Sounds

Transfer Modes:

ASCIIhelp_ASCII

BINARYhelp_binary

L8help_l8

Auto Detecthelp_auto_mode

View links view_links


Pro Options
Options, Pro Options

You can use the Pro Options to enable or disable certain features of WS_FTP Pro.

Enable drag-and-drop between windows

Enable auto reget of failed transfers

Sort options


set extensions
Specifying ASCII (Text) File Extensions

Use the Extensions tab to specify ASCII transfer mode for particular file extensions. When Automatic Detect is the transfer mode, WS_FTP Pro uses ASCII mode for files having the extensions listed here. If the file extension is not listed on this tab, the file is transferred in binary mode.

To add a file extension to the Auto Detect list:

1	In the text box, enter a file extension. (The extension can be up to ten characters long and can contain periods.)

2	Click the Add button. The extension appears in the list box. The list box shows all file extensions WS_FTP Pro transfers in ASCII mode when using Auto Detect.

To delete a file extension from the list box:

•	Select the extension and click the Delete button.


setting ext convert
Setting Up Extension Conversions

You can have WS_FTP Pro automatically convert the extensions of transferred files. For example, if the FTP site uses .html for HTML files and your system uses .htm, you can specify that all files with the extension .html are converted to .htm on transfer. The list box shows all defined extension conversions.

Note: Make sure Convert Extensions is selected. (In the 32-bit version, this is on the Session tab of Program Options; in the 16-bit version, this setting is in the Session Options.

To add an extension conversion:

1	In the Source text box, enter the file extension of the source file.

2	In the Destination text box, enter the file extension to convert to (destination file).

3	Click the Add button. The extension conversion appears in the list box.

To delete an extension conversion:

•	Select it in the list box and click the Delete button.


set associations
Setting Associations

The Associate tab is used to associate files of a particular extension with an executable file. This allows you to map file types to an application (executable file) that can run that type of file. When you choose the Exec button, the file is opened in the associated application.

To set up an association:

1	In the Files with Extension text box, enter the file extension to be associated with an executable program.

2	In the Associate With text box, enter the executable program to run when the Exec button is clicked. You can use the Browse button to browse your files and folders to locate the executable program.

•	Note: In Windows 95 and Windows NT, the "classic" interface of WS_FTP Pro calls ShellExecute to execute the file through the shell. If this fails, WS_FTP Pro uses the associations specified in this dialog. These associations are unique to WS_FTP Pro in this environment.


Connecting
Connecting to FTP Sites

WS_FTP Pro allows you to store basic information about an FTP site (or “Remote System”) and how you want to interact with it.

To add a new site, see Creating a New Site.

To connect to an FTP site, once the site has been created:

1	Click the Connect button.

2	In the WS_FTP Sites dialog box, locate the desired site and double-click it to connect to the FTP site it represents.

You can edit the site information as follows:

Profile Name

Host Name

Host Type

User ID

Password

Account

Anonymous (Login)

Save Password

Auto Save Config

Initial Directories

Comment

Advanced...


Advanced Profile Parameters
Site Properties, Advanced Tab

Connection Retry

Network Timeout

Remote Port

Initialize Command

Local file mask

Remote file mask

Passive transfers

Firewall Information


Site Props Overview
Configuring FTP Sites

WS_FTP Pro lets you configure your favorite FTP sites so that you can connect to each one in just the way you want to. Each configured site is represented by a site icon in the list of WS_FTP sites.

WS_FTP Pro comes with popular preconfigured sites, each of which can connect you to an FTP site as an anonymous user.

To add a new FTP site, see Adding a New FTP Site.

To customize an FTP site, choose from the following topics:

Change the name of a site

Edit the host name, address, and/or type

Add a comment about the FTP site

Changing your User ID and/or password

Change the location you view when you first connect to a site

Issue commands to an FTP site

Display only one type of file

Adjust the file dates and times for a different time zone

Use advanced options


CONNECT - General Parameters
Site Properties, General Tab

Site Name. This is the name that appears in the list of configured sites; it can be anything you like, but not longer than xx characters. This name can (and should) be different than the Host Name/Address!

Host Name/Address. This is either a fully qualified Internet host name or an IP address.

Host Type. If you know the host type, select it from the drop down list. If you don't know, try "auto detect."

User ID. If you have an account on the FTP site, nter the User ID you use to access the site. (Or, you can click the Anonymous check box to automatically enter anonymous as the user.)

Anonymous check box. Selecting this box will automatically enter anonymous as your User ID and enter your e-mail address as the Password.

Password. If you have an account on the FTP site, enter the appropriate password for the User ID that you entered. If this is an anonymous login, enter your full e-mail address. (You can place a minus (-) sign in front of the e-mail address to reduce the number of site administrator messages you receive.)

•	Note: Instead of entering your password for anonymous logins, it is recommended that you simply click the Anonymous check box.

Save Pwd. Select this box only if you are the only user of your computer and no one else has access to your WS_FTP folder. (Passwords are stored in the WS_FTP.INI file in an encrypted form.)

Account. If you have an account, enter the account name here. (In most cases, you will leave this blank because most FTP sites do not use accounts. The account name is used on VM/CMS hosts for the initial password to the user's default folder. When you change folders (ChgDir) on a VM/CMS host you are prompted each time for the password to connect to that folder.)

Comment. Enter any comments you want to include with this site.

For advanced site settings, see also:

Customizing an FTP site


CONNECT - Startup Parameters
Site Properties, Startup Tab

Initial Remote Host Directory. If there’s a folder on the FTP site that you want to use as your starting location when you connect to this FTP site, enter the path of the folder here.

Initial Local Directory. If there’s a folder on your PC that you want to use as your starting location when you connect to this FTP site, enter the path of the folder here.

Initialize Command. If you know of commands that need to be issued to the FTP site at the beginning of the session, enter them here. For example, the command SITE UMASK 022 changes the UMASK used when creating files (on a UNIX system). Separate multiple commands with a semi-colon (;).

Local file mask. You can enter a code here to limit the display of files and folders to just one particular type. If blank, this defaults to *.* to show all files and folders.

Remote file mask. You can enter a code here to limit the display of files and folders to just one particular type. If blank, this defaults to *.* to show all files and folders. For example, you can enter "-al" to display all files on a UNIX site, or something like "*.zip".

Time offset in hours (32-bit version only). There is no standard for specification of date/time on FTP sites, but often it is displayed in GMT. If the time zone of the FTP site is different from yours, you can enter a number of hours to add to the file date and times to convert them to your local date and time. Use a positive number to add, or a negative number to subtract.


CONNECT - Advanced Parameters
Site Properties, Advanced Tab

Connection Retry. Number of times to retry establishing a connection if the first connection attempt fails.

Network Timeout. This is the number of seconds before WS_FTP Pro times out waiting for an FTP site to respond to a command. Note that the initial connection timeout is determined by your Winsock DLL. Setting this value higher does not have any effect on the initial connection to the FTP site. Setting it to less than the amount of time than your Winsock DLL uses will cause the connection to fail in that amount of seconds.

Remote Port. This is the port to connect to on the FTP site. This is normally 21, however, it may be something different if you are going through a firewall, or if the site administrator has assigned the FTP service to a non-standard port.

Passive transfers. Select this option if you want your PC to establish the data connection to the FTP site instead of the site establishing the data connection to your PC. This is necessary for some firewall and gateway configurations and when you get failed data channel errors. Note: not all FTP sites support passive transfers.


CONNECT - Firewall Parameters
Site Properties, Firewall Tab

Use Firewall. If your PC is behind a firewall host, make sure this option is selected.

To enter the rest of the information on this tab, you'll need to get information about your firewall from your network administrator. Depending on the type of firewall, you'll need the following information.

•	For a "SITE hostname" firewall type, you'll need Host Name and User Name (id).

•	For a "Transparent" firewall type, you'll need User Name (id) and Password.

•	For "USER with no logon" or "Proxy OPEN" firewall types, you'll need the Host Name. (The User Name and Password are ignored.)

•	For "USER after logon," "USER remoteID@remoteHost fireID," "USER fireID@remoteHost," or "USER remoteID@fireID@remoteHost" firewall types, you'll need Host Name, User Name (id), and Password.

Host Name. Specify the name or IP address of the firewall.

User ID. Enter the firewall User ID or leave blank if not used.

Password. Enter the firewall password for the specified User ID or leave blank if not used.

Save Password. Select this box only if you are the only user of your computer and no one else has access to your WS_FTP folder. Passwords are stored in the WS_FTP.INI file and even though they are encrypted, it is an easy encryption to break.

Port. Specify the firewall port.

Firewall Type. Select the firewall type from the drop-down list.


Customizing an FTP site profile
Customizing an FTP Site

Once you’ve configured an FTP site, you can edit the Site Properties at any time. You can:

Change the name of a site

Edit the host name, address, and/or type

Add a comment about the FTP site

Changing your User ID and/or password

Change the location you view when you first connect to a site

Issue commands to an FTP site

Display only one type of file

Adjust the file dates and times for a different time zone

Use advanced options


Changing the name of a site profile
Changing the Name of a Site

1	Select the site.

2	Select Properties.

3	Click the General tab.

4	Enter a new Site Name. (This name should be different from the Host Name.)


Commenting on an FTP Site

1	Select the site.

2	Select Properties.

3	Click the General tab.

4	Enter a Comment about the site.


Editing the host name address and or type
Editing the Host Name, Address, and/or Type

1	Select the site.

2	Select Properties.

3	Click the General tab.

4	Edit the Host Name or IP Address.

This is either a fully qualified Internet host name or IP address.

5	Edit the Host Type.

If you know the host type, select it from the drop down list. Otherwise, try "automatic detect."


Editing your login name for an FTP site
Editing Your User ID for an FTP site

1	Select the site.

2	Select Properties.

3	Click the General tab.

4	Do one of the following:

•	(Recommended) To log in as an anonymous user, select Anonymous. WS_FTP Pro enters your e-mail address as your password.

•	If you have an account on the site and must use a User Name, make sure Anonymous is clear, and then enter User Name, Password, Confirm Password, and Account (if applicable).

Note: Do not check the Save Password box unless you are the only user of your computer and no one else has access to your Windows directory!


Changing the Location You View on an FTP Site

1	Select the site.

2	Select Properties.

3	Click the Startup tab.

4	In the Initial remote folder text box, enter the path of the folder you'd like to view when you first connect to this site.


Issuing Commands to an FTP Site

1	Select the site.

2	Select Properties.

3	Click the Startup tab.

4	In the Initialization command text box, enter any commands you want to issue to the FTP site at the beginning of the session. Separate multiple commands with a semi-colon (;).

For example, the command SITE UMASK 022 changes the UMASK used when creating files (on a UNIX system).


Displaying Only One Type of File

1	Select the site.

2	Select Properties.

3	Click the Startup tab.

4	To limit the files you see to just one type, enter an asterisk and period followed by the file extension in the Remote file mask text box. For example, to display only text files, enter *.txt.

To display all files on a UNIX FTP site including hidden (.) ones, enter -al or -la. Or, use -altr to receive file names in date sequence. (For those familiar with DOS FTP clients: You can also enter any argument string you would use with a "Dir" command.)


Adjusting file dates and times for a different time zone
Adjusting for a Different Time Zone

WS_FTP Pro can adjust the display of file dates and times on an FTP site so they represent the times and dates in your time zone. For example, if an FTP site is in a time zone three hours earlier than your time zone, you can have WS_FTP Pro adjust a date and time of 11/10/97 1:00 AM to 11/9/97 10:00 PM.

1	Select the site.

2	Select Properties.

3	Click the Startup tab.

4	In the Time offset in hours text box, enter the difference in whole hours between the time zone of your PC and the time zone of the FTP site. Use a positive number if the site is in an earlier time zone (west), a negative number for a later time zone (east).


Creating a New FTP Site

1	Click Connect to display the WS_FTP Sites dialog box (if it’s not already displayed).

2	Click New to display the New Site/Folder dialog box.

3	Make sure Site is selected.

4	Enter a name for the site and click Next.

5	Enter the Host Name or IP Address and click Next.

6	Do one of the following:

•	Select Anonymous to connect to the FTP site using an anonymous log in.

•	Enter a User ID and Password to log on to an account on the FTP site.

7	Click Finish.

The new site appears in the list of WS_FTP Sites. Double-click it to connect to the site.


New Site First Panel
New Site/Folder

This dialog box allows you to create either a new site or a new folder for organizing your configured sites.

To create a new site,

1	Click Site.

2	Enter a name for the site and click Next.

To create a new folder,

1	Click Folder.

2	Enter a name for the folder and click Finish.


New Site Second Panel
Host Name/IP Address

Each system on the Internet must have both a host name and an Internet (IP) Address. Each host name corresponds to one unique IP address; likewise, each IP address corresponds to one unique host name. In WS_FTP Pro, you can use either the host name or the IP address to specify a particular system.

For example, a system might have a host name of superserv.ipswitch.com and an IP address of 156.21.50.1. (Each IP addresses is a 32-bit designation consisting of four numbers from 1 to 255 separated by dots.)


New Site Third Panel
Logon Information

Anonymous. Selecting this box automatically enters anonymous as your User ID and your e-mail address as the Password.

User ID. If you have an account on the FTP site, enter the User ID you need to use to access your account.

Password. Enter the Password you want to use for the User ID you entered. If this is an anonymous login, enter your full electronic mail address. (Place a minus (-) sign in front of the e-mail address to reduce the number of site administrator messages you receive.)

Save Password. If you have an account on the FTP site, you can also save your password by clicking Save Password and entering your password in the text box.


File Transfer Protocol

FTP stands for File Transfer Protocol, one of the standard protocols defined for use on the Internet.

FTP is a client/server based protocol, whereby a client program on one system, usually your PC, sends requests to a server program on another system, an FTP site, and receives replies from the site.


FTP Sites

An FTP site consists of an FTP server program located on an Internet host computer.

Many companies and organizations maintain FTP sites (also known as “FTP servers”). These are file repositories from which you can copy files such as free programs and evaluation versions of software. WS_FTP Pro provides a number of popular FTP sites that have already been configured for you

•	Note: When you connect to an FTP site, look for a file called readme, readme.txt, index, or 00index. Such files provide descriptions of the files available on the site as well as other useful information.


Configured FTP Site

A configured FTP site is an FTP site about which you have saved some information in the Site Properties dialog box in WS_FTP Pro:

The General tab contains the following site properties: site name, host name/IP address, host type, user ID, password, and account.

The Startup tab specifies the startup folders for the FTP site and your PC, any initialize commands, the local and remote file masks, and the time offset.

The Firewall tab contains your firewall user ID and password, as well as the firewall’s host name, port, and type.

The Advanced tab contains settings for retrying the connection, network timeout, remote port, and passive transfers.


FTP Client

An FTP client is a computer that is running FTP client software. When you use FTP to download files from an FTP site, you are actually running an FTP client (such as WS_FTP Pro) on your PC.


Upload

To transfer a file from your local PC to an FTP site.


Download

To transfer a file to your local PC from an FTP site.


Connect

When you "connect" to an FTP site, WS_FTP Pro sends messages to the FTP site and -- if the connection is successful -- receives messages back from the site. These messages use the Internet's File Transfer Protocol.


Temporary Directory

The temporary directory is the folder on your PC to which WS_FTP Pro copies files you open.

TBD: How does this work for Classic and Explorer in Version 6? Both use same folder?????

In Version 5 of Explorer: By default, this folder is named WS_FTPE and is created by default under your System TEMP folder when you first install WS_FTP Pro. To check the location of your temporary folder, select WS_FTP Pro Properties from the File menu and click the General tab. To change the temporary folder, enter a new path in the Temporary Directory text box.


Internet Address

An Internet address, or IP address, is a unique identifier that defines a system's location on the Internet. IP addresses are 32-bit designations consisting of four numbers from 1 to 255 separated by dots (.), for example, 156.21.50.1.

Each IP address is also represented by a unique name. For example, the IP address 156.21.50.1 maps to the computer named superserv.ipswitch.com.


Windows Registry

The registry is part of the Microsoft Windows operating system that keeps track of which applications work with which file types.


Transfer Mode

Transfer mode refers to the way the elements of the file are transferred from one computer to another. Binary files must be transferred in binary transfer mode; ASCII (text) files must be transferred using ASCII transfer mode.

Select the transfer mode from the Options menu.


ASCII_def
ASCII

ASCII. Text file fomat. Text files have end-of-line characters; the end-of-line character is different on different types of computers.)


Binary_def
Binary

A file format that is used fornon-text files such as executable programs, word processing documents, spreadsheets, databases, graphics files, and sound files.


Binary Transfer Mode

The binary transfer mode transfers a file as an exact copy of the original, and should be used for transferring all binary files. (Binary mode contrasts with ASCII mode which treats a file as text, translating the end-of-line characters during transfer.)


ASCII Transfer Mode

The ASCII transfer mode treats a file as text, and should be used for all ASCII (text) files. ASCII transfer mode translates the end-of-line characters during transfer so that the file can be read on the destination system. (ASCII mode contrasts with binary mode in which characters are not translated, but are transferred as exact duplicates of the original.)


Open or Execute a File
Open or Execute a File (TBD: same for Classic & Explorer?)

When you double-click a file on an FTP site, WS_FTP Pro copies the file to the temporary directory and then executes or opens the file according to Windows standards: if the file is executable (.exe, .com, .bat, or .pif), Windows executes the file. If the file is not an executable, the file is opened in whatever application is associated with the file extension in your Windows registry.

If there is no file extension or the file extension is not associated with an application, you are prompted to select an application to open the file.


Right Mouse Menu

The menu that appears when you press the right mouse button.


Local System

Your PC.


Remote Host or Remote System
Remote System (or Remote Host)

A remote system is the host computer, or FTP site, to which your PC connects; the remote system can be located in your office or somewhere else.


Site Icon
The site icon represents a collection of information about an FTP site that WS_FTP Pro uses to locate and log in to the site.


Host Name

The official name of a computer on the Internet that represents the IP Address. For example, the host name, superserv.ipswitch.com, maps to the IP address 156.21.50.1.


Overwrite

To replace a file with another file having the same filename.


Access Privileges

The permissions you have on an FTP site. The administrator of an FTP site controls the privileges associated with each account on the site, including the privileges for "Anonymous" logins.


Disconnect

To disconnect your local system from an FTP site, WS_FTP Pro closes any open connection between the local machine and the FTP site.


Account

Some FTP sites, notably VM/CMS hosts, require an account in order to authenticate the client and provide access to a default directory for the user. For most sites, however, no account is required.


Firewall

Some organizations separate their networks from the rest of the world by installing a "firewall" or "gateway." A firewall is a system or software which is configured to prevent particular types of access/information from entering the network. Most firewalls block the flow into the local area network, but allow individuals to access most resources outside of the network.

Some types of router-based firewalls will not allow an FTP site to establish a data connection to your local PC. You'll want to use passive transfers for if you local area network is behind these types of firewalls.


Winsock DLL

The Winsock (Windows Sockets) dynamic link library is a specification for the Microsoft Windows API (applications programming interface). Software providers useWinsock as a guideline for developing network software.


Remote port

The remote port is the port on which an FTP site, is "listening" for an FTP request. The default remote port number for FTP is 21.


Passive Transfers

Normally, when you connect to an FTP site, the site establishes the data connection to your PC (the client). However, if the site allows passive transfers, you can have yourPC establish the data connection.


Host Name/Address

Each system on the Internet must have both a host name and an Internet (IP) Address. Each host name corresponds to one unique IP address; likewise, each IP address corresponds to one unique host name. In WS_FTP Pro, you can use either the host name or the IP address to specify a particular system.

For example, a system might have a host name of superserv.ipswitch.com and an IP address of 156.21.50.1. (Each IP addresses is a 32-bit designation consisting of four numbers from 1 to 255 separated by dots.)


Anonymous

Most FTP sites support anonymous logins where you do not have to have an account on the FTP site in order to transfer files. For most anonymous logins, the User ID is the word "anonymous" and the password is your e-mail address.


URL

Uniform resource locator. For example the URL of an Ipswitch ftp site is ftp://Ipswitch.com.


FTP Menu

You can bring up a menu by pressing the right-mouse button when the cursor is pointing at the gray area of the main window. The commands on this menu are the following:

Connection. Same as clicking the Connect button.

Options. Same as clicking Options button in main window.

Show Log. Same as clicing LogWnd button in main window.

Help. Same as clicking Help button in main window.

About. Same as clicking About button in main window.

FTP Commands. CWD, PWD, HELP, SYST, SITE, QUOTE, LIST, NLST, RETR, STOR.


Right Mouse non-gray
Right Mouse Menu

You can bring up a menu by pressing the right-mouse button when the cursor is in the list boxes of the main window. The commands on this menu are the following:

Sort. xxx

Change Directory. Same as clicking ChDir button in main window.

Make Directory. Same as clicking MkDir button in main window.

Delete Directory. Same as clicking Delete button in main window.

Transfer file/directory. xxx

Append file. xxx

View file. Available only if file selected.

Edit file. Available only if file selected.

Execute file. Available only if file selected. Same as clicking Exec button in main window.

Rename file/directory. Available only if file/directory selected. Same as clicking Rename button in main window.

Move files/directory. Available only if file/directory selected.

Delete files. Available only if file selected. Same as clicking Delete button in main window.

chmod (UNIX). Available only if file selected.

Refresh list. xxx

Directory list. xxx

FTP Commands.  CWD, PWD, HELP, SYST, SITE, QUOTE, LIST, NLST, RETR, STOR.


Sort (popup menu)
Sort…

The Sort... command appears only in the 32-bit version of WS_FTP Pro. It allows you to change the sort order of the files displayed in the selected list box. File names can be sorted by name, extension, date, or size. Sort order can also be reversed. The Show Full Directory Information option on the Advanced tab of the Program Options must be enabled for sort to work properly.

Note that information necessary to build a standard list is not available for all host types. If your host type does not sort properly send a description and the DirInfo window contents to support@ipswitch.com.


append files
Appending Files

You can select one or more files on the source system and transfer those files to the destination system, appending them to a destination file.

1	Select one or more files on the source system.

2	In the source system list box, select Append files from the right-mouse menu. A dialog box prompts you to enter the destination file name.

3	Enter the name of the file to which you want to append files, and then click OK. The selected source files are copied to the end of the destination file.


Edit (popup menu)
Editing files

The Edit file command allows you to edit a remote file locally. It appears only in the 32-bit version of WS_FTP Pro when a file is selected. When you select Edit file, WS_FTP Pro transfers the file to the local system and opens the appropriate application. When you close that application, WS_FTP Pro transfers the file back to the FTP site.

Note that your FTP session may timeout if you take an excessive amount of time to edit the file, normally more than four minutes. In the event of a timeout, the file is not updated on the FTP site and your edits may be lost. You can go back to the WS_FTP Pro window and refresh the folder listing every couple of minutes to keep the session alive.

Files on the local system can be directly edited via the View or Execute buttons.


chmod (popup menu)
chmod (right-mouse menu)

The chmod (UNIX) command appears only when one or more files or folders are selected in the Remote System list. When you select chmod, you see a dialog box where you can specify the most common UNIX file attributes.

•	Note: You must have write permission on the FTP site and the site must support the "SITE chmod" command. This is normally valid only on UNIX-based systems. The selected items do not reflect the current permissions of the file.


Moving Files

You can move files from one folder to another folder on the same system.

1	Select one or more files.

2	Right-click one of the selected files and select Move files... from the right mouse menu. You are prompted for the folder to which you want to move the files (the folder must be on the same system).

3	Enter the complete folder path and click OK. The selected files are moved to the new location.

•	Note: To move files on an FTP site, you must have write privileges and the site must support the movement of files. Note that most sites will allow you to overwrite a file without giving you a warning.


FTP Commands
FTP Commands (Overview)

File Transfer Protocol provides a number of commands you can use to interact with an FTP server. You can use some of these from WS_FTP Pro.

1	Connect to an FTP site.

2	Place the cursor in the file and folder list of the Remote System.

3	Select FTP commands from the right-mouse menu.

4	Select the desired command.


SITE Command
SITE Command (right-mouse menu)

Enter a remote site specific command. WS_FTP Pro prefixes your entry with the word SITE and sends your entry to the FTP site without any editing. It is up to you to determine what is valid input for this command by reading the documentation for the FTP site.


QUOTE Command
QUOTE Command (right-mouse menu)

Enter any command you want. WS_FTP Pro sends it to the FTP site, unedited. It is up to you to determine the command syntax depending on the FTP site you are connected to. You should not send any commands that need to open a secondary channel.


Alternate Screen Layout (program option)
Alternate Screen Layout

This check box controls the layout of the main window. The standard layout shows the Local System on the left, and the Remote System on the right.

The "alternate layout" shows the local system and file list on top and the remote system and file list on the bottom.


Buttons on Top (program option)
Show Buttons at Top of Screen

Controls the placement of the buttons that are normally across the bottom of the window.


hide dir buttons
Hide Directory Buttons (32-bit version)

If selected, hides the column of buttons (ChgDir, MkDir, etc). These functions are then available only from the right-mouse menu.


Show Directory Information (program option)
Show Full Directory Information

When this option is selected, additional file information is displayed when possible. However, WS_FTP Pro does not attempt to decipher or interpret this information; it is shown only for informational purposes.

•	Note: This may not work on all types of FTP sites.


Auto Save Config (program option)
Auto Save Host Configurations

If selected, WS_FTP Pro automatically saves the site configuration when you click the OK button in the Session Properties dialog box.


Verify Deletions (program option)
Verify Deletions

If selected, WS_FTP Pro prompts you for confirmation when you delete files.


Auto Connect (program option)
Show Connect Dialog on Startup

When this option is selected, WS_FTP Pro displays the connect (Session Properties) dialog box when WS_FTP Pro first starts.


Debug Messages (program option)
Debug Messages

When this option is selected, extra debug messages are included in the message window at the bottom of the main window.


Text Viewer (program option)
Text Viewer

Enter the name of the program that is invoked when you click the DirInfo or View buttons. The default text viewer is the Windows Notepad.


Log Filename

When the Enable log option is enabled, WS_FTP Pro writes the FTP message log to this file.

By default, this file is named Ws_ftp.log, and it is automatically placed in every folder to which you download files. If you don't want log files in every folder, specify a full path for this file.


Enable Log

When selected, FTP messages between your PC and the FTP site are written to the log file specified in the Log filename text box.


E-Mail Address (program option)
E-Mail Address

This is used as the default password for anonymous logins as required by most anonymous FTP sites.

You can place a minus (-) sign in front of the e-mail address in order to minimize the number of descriptive messages you'll receive from the FTP site administrator.


edit shell execute
Remote Edit Uses ShellExecute

Select this box if, when selecting a remote file for editing, you want to open the selected file in its associated application without transferring the file to a temporary file on your local system. The file will be opened in the application associated with its extension (for example, a .doc file will be opened in Microsoft Word). See Associations for more information.

•	Note: When this box is not selected, a remote file selected for editing will be transferred and given the extension .tmp, thus the transferred file (such as a .doc file) will not open in its associated application.

To edit a file, select it, and then select Edit File from the right-mouse menu.


reset window (Genl Opts)
Reset Window Location

Resets the current main window size and location to the original settings.


save window (Genl Opts)
Save Window Locations

Saves the current main window size and location. Note that this works only if the main window is not maximized.


ListBox Font (program option)
List Box Font

Changes the font used in list boxes.

System Variable, which is a variable font, is the default.

System Fixed is the fixed system font and will improve the alignment of columns in the boxes.

ANSI Variable is a narrower font than the System font.

ANSI Fixed is the ANSI fixed font.

Selecting Custom Font displays the Windows font dialog box from which you can select a specific font family, style, and size.


Scale Fonts (program option)
(Auto) Scale Fonts

When selected, the font in dialog boxes (excluding list boxes) is the ANSI variable font. Its size is reduced when the window is made smaller.


Double Click Transfer (program option)
Double-click Action: Transfer

When you double-click a filename, the file is transferred to the system whose information is displayed in the opposite side of the window. Therefore, if you double-click a file on the local side, it is uploaded to the FTP site; and if you double-click a file on the remote side, it is downloaded to the local system.


Double Click View (program option)
Double-click: View (file)

When you double-click a filename, the file is opened in the viewer you have defined in the Program Options (16-bit version) or on the General tab of the Program Options (32-bit version). If you double-click a remote file, it is transferred in the selected file transfer mode to the Windows temporary folder on the local system and opened in the viewer.


Double Cick Nothing (program option)
Double-click: Nothing

When you double-click a filename, nothing happens.


Receive Size (program option)
Network Buffer Receive Size (32-bit version)

Recv Bytes (16-bit version)

This option controls how many bytes are read from the network in each “Read” (“recv”). The value can vary from 80 to 4096. You should see the best results with this set to 4096. Note that the actual number of bytes in each “recv” is determined by the TCP/IP stack and by the amount of information available.


Send Size (program option)
Network Buffer Transmission Size (32-bit version)

Send Bytes (16-bit version)

This option controls how many bytes are written to the network in each “send.” The value can vary from 80 to 4096. The optimum value to place here depends on your TCP/IP stack. If you have a direct connection, 4096 is best. If you have a SLIP or PPP connection, you probably want to set it to the MTU size.


Enable drag-drop (pro option)
Enable Drag and Drop Between Windows

When selected, you can transfer files and folders between systems by dragging them with the mouse from one list box to another.

See also:

Drag-and-drop


Enable reget (pro option)
Enable Auto Reget of Failed Transfers

When selected, WS_FTP Pro asks if you want to resume an interrupted transfer when you reconnect to the FTP site. An interrupted transfer is one that is stopped because of a lost connection or because it was cancelled.

See also:

Resuming file transfers


Preserve time (pro option)
Preserve file time on transfer from remote

When selected, a downloaded file maintains its original creation date and time. If not selected, a downloaded file is updated to the the date and time of the transfer. Note that this option does not apply to uploaded files.


Prompt for overwrite (pro option)
Prompt for Overwrite of Same or Newer Files

When selected, WS_FTP Pro asks if you want to overwrite a file when you attempt to transfer a file or folder to a destination where there is the same or newer version (by date and time). Note that this feature will not work with some FTP sites.


Dont transfer older (pro option)
Don't Transfer Older or Same Files

When selected, WS_FTP Pro transfers only those files in a folder for which there are not the same or newer versions (by date and time) in the destination folder.


Auto Update Remote Directories (session option)
Auto Update Remote Directories (16-bit version)

Update Directories After Transfer (32-bit version)

When selected, the list of files and folders is refreshed after uploading a file, deleting a file or folder, or creating a folder. (Note that you can always click the Refresh button to update the list.)


Show Transfer Dialog (session option)
Show Transfer (Progress) Dialog

When selected, a Transfer Progress dialog box appears during file transfers. It displays the status of the transfer and shows a percent done bar (if the file size is sent by the FTP site).

•	Note: You can click the Cancel button in the dialog box at any time to cancel the transfer. If you cancel a transfer, you will have a partial file in the transfer destination. You should delete the partial file.


Initialize Command

Enter any commands that need to be issued to the FTP site at the beginning of the FTP session. For example, the command SITE UMASK 022 changes the UMASK used when creating files (on a UNIX system). Separate multiple commands with a semi-colon (;).


Local File Mask

Enter the initial startup arguments for the listing files on the local system. For example, *.zip will show all .zip files in the startup folder. If blank, this defaults to *.* to show all files and folders.


Remote File Mask

Enter the initial startup arguments for the remote LIST command. This could be "-al" or "-la" to display all files on a UNIX system or something like "*.zip".


Use PASV Transfer Mode (session option)
Use Passive Transfer Mode

By default, FTP data connections are established by the FTP site. Passive Mode forces the data connections to be established by the client. Passive mode may be required for users who are behind some types of router-based firewalls or behind a gateway requiring passive transfers.


Send Unique (session option)
Send Unique (host assigns name)

This option makes sure the transmitted file names do not conflict with existing files if the FTP site supports the FTP command, STOU. The new filename is determined by the FTP site.


Receive Unique (session option)
Receive Unique (PC assigns name)

This option makes sure the received file names do not conflict with existing files. The new filename is changed so that the sixth though eighth characters of the filename are a number between 000 and 999.


Prompt for Destination (session option)
Prompt for Destination File Names

When this option is selected, WS_FTP Pro prompts you to confirm or change the destination path and filename. For each file that is transferred, WS_FTP Pro shows you the proposed destination file name and allows you to change it. You can enter a full pathname to a different folder if you want.

•	Note: When this option is selected, you can bypass the prompt by holding down the Ctrl key when you click the transfer arrow.


Sound When Transfer Done (session option)
Sounds

Plays the specified sound on connection success, on file transfer success, or on an error. This will be the Default Beep sound.

None. No sounds

Beeps. Use system sounds

Wave. Play the specified WAV files (connect.wav, complete.wav, and error.wav)


Sorted Listboxes (session option)
Sorted List Boxes

If this box is selected, the Remote System list box is automatically sorted alphabetically. Otherwise the files are presented in the order the FTP site transmits them.

See also:

Sort options in the Pro options


ASCII (transfer mode)
(Startup) Transfer Mode: ASCII

Used for text file transferring. (The end-of-line character is different on different types of computers; using ASCII mode ensures that the end-of-line character is translated properly.)

•	Note: If you know that the FTP site you are transferring to or from is running the same operating system as your local system, you can always use binary mode and never use ASCII.


Binary (transfer mode)
(Startup) Transfer Mode: Binary

Binary mode is used for transferring files that are not text (ASCII files). Executable programs, word processing documents, spreadsheets, databases, graphics files, and sound files are some examples of files that must be transferred in binary mode.

If you know that the FTP site you are transferring to or from uses the same operating system as your local system, you can always use binary mode and never use ASCII.


L8 (transfer mode)
(Startup) Transfer Mode: L8

Used for VMS non-text file transferring.


Use Firewall (session opt)
Use Firewall

When selected, the Firewall properties are activated. Select this and click the Set as default button to make it the default value for all sites. You can also set this property on a per site basis in the Firewall tab of the Site Properties dialog box.


Force lowercase (session)
Force Lowercase (Remote Names)

When selected, the names of files are converted to all lower case letters when you transfer files from your PC to an FTP site.


Extension convert (session option)
Convert Extensions

When select, the extensions of all transferred files are compared with the list on the Extensions tab. If the file extension is found in this list, the destination file name is changed to match the desired extension. For example:

htm=html

or,

html=htm


remember directories (session)
Remember Directories

If selected, the drop-down list for both the Local System and Remote System shows the folders you visited during the session. These folders are saved if you click the Close button before exiting the session.


Save dir names (session)
Save Current Directories as Connection Directories

Saves the local and remote folder names in the current Site Properties.


Auto Detect (transfer mode)
(Startup) Transfer Mode: Automatic Detect

When selected, all files are transferred in binary mode unless the extension is listed on the Extensions tab. (WS_FTP Pro stores the ASCII extensions in the ws_ftp.txt file). Extensions can be up to ten characters long and can contain periods.

•	Note: These are not DOS extensions! Rather they are the ending characters of a filename. If you expect it to match on a period, you must put the period in. Some samples are shown below.

.LST

.TXT

.ME

README


View Links

If this option is selected, you can view links on the FTP site (for example, UNIX symbolic links) as directories or as files.

•	Note: This option does not appear in the 32-bit versions of WS_FTP Pro because links are handled automatically there.


Transfer Rate Display

The transfer rate is displayed in the Transfer Status dialog box. It can be displayed in bits per per second or in bytes per second.


Set as Default

The settings on the Session and Session (cont'd) tabs of the Program Options can be applied in two different ways. They can be:

•	Set for the current site and until you Exit the program

or,

•	Always in effect.

If you want the settings to apply to the current site and until you Exit the program, set the desired options and click Apply or OK. (Do not click Set as default.)

If you want the settings to remain in effect all the time, set the desired options and click Set as default.


Date Format

Dates can appear a number of different ways in WS_FTP Pro. You can display:

•	Years as two digits (for example, 98) or four digits (for example, 1998.

•	Dates as year, month, day (for example, June 9, 1998 would be 980609).

•	Dates as month, day, year (for example, June 9, 1998 would be 060998).

•	Dates as day, month, year (for example, June 9, 1998 would be 090698).


internet address, def
Internet Address

An Internet address or IP address is a unique identifier that defines a system's location on the Internet network. IP addresses are 32-bit addresses that are commonly specified in Internet dot notation, which consists of four numbers from 1 to 255 separated by dots (.), for example: 156.21.50.1

Each IP address is mapped to a unique hostname as it is easier for people to remember names than it is to remember strings of numbers. For example, the IP address 156.21.50.1 maps to the system named superserv.ipswitch.com.


local, remote  def.
Local System vs. Remote System

In networking terms, the Local System refers to your PC. The Remote System is any FTP site you connect to via a modem or local-area network.


Profile Name

This is the name of the FTP site information you are saving, and can be anything you desire to identify the connection you are creating. The length of this name is restricted as it is used as a section name in the WS_FTP.INI file.

You can select from a number of preconfigured popular FTP sites. Click the Profile Name list box to show the choices.


Remote Host Name
Host Name/Address

This is either a fully qualified Internet host name or an IP address.


Remote Host Type
Host Type

If you know the host type, select it from the drop down list. If you don't know, try "Automatic detect,"which takes care of about 90% of all FTP sites.


User ID (userid)
User ID

If you have an account on the FTP site, enter the User ID you need to use to access your account. Or, you can click the Anonymous check box to automatically enter anonymous as the User ID.)


Password

Enter the Password you want to use for the User ID you entered.

If this is an anonymous login, enter your full electronic mail address. You can place a minus (-) sign in front of the e-mail address to reduce the number of site administrator messages you receive.


Account

If the FTP site requires an account, enter the account that you want to use for the User ID you entered. Note that the account is used for VM/CMS hosts for the initial password to the user's default folder. When you change folders (ChgDir) on a VM/CMS host you are prompted each time for the password to connect to that folder.


Connection Retry

Number of times to retry establishing a connection if the first connection attempt fails. This can be from 0 to 40 times.


Timeout
Network Timeout

This is the number of seconds before WS_FTP Pro times out waiting for an FTP site to respond to a command.

Note that the initial timeout is determined by your Winsock DLL. Setting this value higher does not have any effect on the initial connection to the FTP site. Setting to less than the amount of time that your Winsock DLL uses causes the connection to fail in that amount of seconds.


Port

This is the Port to connect to on the FTP site. This is normally 21 for FTP, however, it may be something different if you are going through a firewall, or if the site administrator has assigned the FTP service to a non-standard port.


Anonymous Login
Anonymous

Selecting this box automatically enters anonymous as your User ID and your e-mail address as the Password.


Save Password

Optionally, select this box to save your password with the site informaiton. If you do not save the password, WS_FTP Pro will prompt you for one when you initiate the connection. (Passwords are stored in the WS_FTP.INI file and even though they are encrypted, it is an easy encryption to break.)


auto_save_config
Auto Save Host Configurations (Auto Save Configs)

When enabled, automatically saves the site information when you click OK. You can also set this option in the Program Options so it will be enabled for all new sites you create.


initial_dirs
Initial Directories

Initial Remote Host Directory. If there’s a folder on the FTP site that you want to use as your starting location when you connect to this FTP site, enter the path of the folder here.

Initial Local (PC) Directory. If there’s a folder on your PC that you want to use as your starting location when you connect to this FTP site, enter the path of the folder here.


Comment

Enter any comments you want to include with this site.


ChgDir (button or popup menu)
ChgDir (Change Directory)

The ChgDir button allows you to change the current folder from the one displayed in the text box under either Local System or Remote System to another folder on the system. This command works only on systems that implement the concept of directories.

If you select a folder name in the folder list box and choose this command, WS_FTP Pro changes the current folder to the one selected.

If no name is highlighted, you will be prompted for the folder to change to. When prompted for a folder, you can also enter a drive letter followed by a colon (for example, d:) to change to a different disk drive.


MkDir (button or popup menu)
MkDir (Make Directory)

The MkDir button allows you to create a folder if possible. (Not all FTP site allow you to create folders; you must have an account on the site and "create" privileges.)

When you select this command, you are prompted for a folder name that is valid for the current system.


RmDir (button or popup menu)
RmDir (Remove Directory)

The RmDir button allows you to remove a folder if possible. (Not all FTP site allow you to make and delete folders remotely; you must have an account on the site and "delete" privileges.)

When you select this command, you are prompted for a folder name.


File Mask (main screen)
File Mask Text Box

The File Mask text box is located just below the MkDir button. It allows you to limit the files displayed in the lists for either the Local System or Remote System; this is handy if there are a large number of files and folders.

In the File Mask text box, enter a filter that is valid for the system, and then press Enter. For example, to display only files with the extension .txt, enter *.txt in the File Mask text box and press Enter. The corresponding list box is refreshed to display only the files with the extension .txt.

If you are connected to a UNIX FTP site, you can use:

•	-al or -la in the File Mask text box on the Remote System side of the window to view hidden (.) files

•	-altr in the Remote System side of the window to view file names in date sequence (in the 32-bit versions of WS_FTP Pro only)

Note to those familiar with FTP command line clients: You can use any argument string you would use with a "Dir" command in a command line FTP client.


View (button or popup menu)
View

The View button allows you to view a file in ASCII format by whatever viewer you have defined on the General tab of Program Options (in the 32-bit version of WS_FTP Pro) or in the General properties (16-bit version).

When you view a file on an FTP site, the file is transferred according to the transfer mode settings in the FTP Pro main window to the Windows temporary folder and opened in the viewer.


Execute (button or popup menu)
Execute

The Exec button allows you to execute, or open, a file.

•	If you select a local filename and then click Exec, the file is executed using the same rules as if it were executed in Windows.

•	If you select a filename on an FTP site and then click Exec, the file is transferred in the selected file transfer mode to the Windows temporary folder and is executed using the same rules as if executed in the File Manager.

If the filename has an extension other than .exe, .com, .bat or .pif, then the Windows file associations are used. If the extension has no association, you are allowed to specify the association at run time. This association is saved in the WIN.INI file in the Extensions section and is also valid for Windows.

You can set associations by clicking the Options button and then selecting File Associations.


Rename (button or popup menu)
Rename

The Rename button allows you to rename a file or folder, if possible. Not all FTP site allow you to rename files and folders; you must have an account on the site as well as renaming privileges.

To rename a file or folder:

1	Select the file or folder.

2	Click the Rename button.

3	Enter the new name for the file or folder.

4	Click OK.

Note: Some systems allow you to rename a file over the top of an existing file.


Delete (button or popup menu)
Delete

The Delete button allows you to delete a file or folder on the FTP site, if (a) deletions are allowed on the site, and (b) you have an account on the site as well as "delete" privileges.

To delete a file or folder:

1	Select the file or folder.

2	Click the Delete button.


Refresh

The Refresh button allows you to refresh the folder and file list box to display any recent changes to the current folder.


DirInfo

The DirInfo button opens a window that displays the files and folders in the current folder, as well as the file sizes, and dates and times last edited.


Allow Deletion of Non-Empty Folders

When this option is selected, WS_FTP Pro deletes all the contents of a folder when you select the folder and then click Delete.


Beta Help for Reviewers

Yes, this is the correct file for your Beta Help review. Now, get to work!


32bit context sensitive topics
32bit context sensitive topics (for Help Author Reference only)

32-bit Program Options (context-sensitive)

All of themOptions_H2MwindowI

General Tabhelp_options_general

Advanced Tabhelp_option_advanced

Display Tabhelp_option_display

Sounds Tabhelp_option_sound

Sort Tabhelp_options_sort

Pro Tabhelp_options_pro

Session Tabhelp_options_session

Session (cont'd) Tab

Convert Tabsetting_ext_convert

Extensions Tabhelp_options_extensions

Associations Tabhelp_options_associations

32-bit Site Properties (context-sensitive)

General Tabhelp_connect_general

Startup Tabhelp_connect_startup

Advanced Tabhelp_connect_advanced

Firewall Tabhelp_connect_firewall


Sorting dirs and files
Sorting Files and Folders

You can sort the files and folders in the Local System or Remote System list boxes by using the column headings (Name, Date, Size) above each list or the Sort command on the right-mouse menu.

Using column headings to sort (32-bit version):

Click a column heading to sort the files and folders as follows:

1	Name. Click the column heading, Name, to toggle the alphabetical list between ascending and descending order. Click Ctrl+Name to sort the file names by file extension.

2	Date. Click the column heading, Date, to toggle the alphabetical list between ascending and descending order.

3	Size. Click the column heading, Size, to toggle the alphabetical listings between ascending and descending order.

4	^ Click the button to the left of the column heading, Name, to toggle the listing of folders from on bottom (after all files), on top (before all files), or mixed with files.

Sorted list boxes option (16-bit version):

If this option is turned on, the Remote System list is automatically sorted alphabetically. Otherwise the files are presented in the order the FTP site transmits them.

1	Click the Options button.

2	Click the Session tab.

3	Select Sorted list boxes.

Using the right-mouse menu to sort (all versions):

1	Place the cursor over either list box.

2	Select Sort from the right-mouse menu. The Sort dialog box appears.

3	Select the desired options and click OK.


Exec/view operation
Transfer Mode Settings

When you view, execute, or edit a file on an FTP site, WS_FTP Pro (both Classic and Explorer?) transfers the file to the Windows temporary folder on your local system, then opens the file in the associated application. The file is transferred as follows, depending on the transfer mode settings in the WS_FTP Pro main window.

Auto mode on. WS_FTP Pro checks to see if the file extension is registered (in the Extensions properties). If the extension is registered, the file is transferred in ASCII mode. If it is not registered or no file extension is found, the file is transferred in binary mode.

Auto mode off. Transfers the file in either binary or ASCII mode, depending on which is selected.

•	If ASCII mode is selected and the file is clearly not in ASCII format, WS_FTP Pro prompts for confirmation that you want to transfer the file in ASCII format. This provides a verification step to ensure that you do not transfer a binary file in ASCII format, which could damage the file.


Description
What is WS_FTP Pro?

WS_FTP Pro is a Windows-based application for transferring files between your PC (the "Local System") and an FTP site (the "Remote System"). Using WS_FTP Pro, you can connect to another system from your PC, browse files and folders on both systems, and transfer files between the systems. WS_FTP Pro comes with a number of preconfigured popular FTP sites.

WS_FTP Pro provides ease of use for the beginner plus a full set of functions for the power user. See WS_FTP Pro features for some of the features available.

WS_FTP Pro is a File Transfer Protocol (FTP) client application that complies with the Windows sockets standard (Winsock). WS_FTP Pro can connect to any system that has a valid Internet Address and contains an FTP server program, allowing you to transfer files between a wide variety of systems, including Windows, OS\2, and UNIX systems.

In addition to the Pro version, there is also a Limited Edition, WS_FTP LE. The Pro version of WS_FTP offers additional functionality and additional applications for a low cost.

See WS_FTP Versions for more information. Some of the functions described in this help file are available only in WS_FTP Pro and are identified as such.

For more information on FTP and FTP sites, please refer to the network newsgroups or one of the recent books on the Internet.


new in version
New in Version 6

•	Ability to store sites in folders

•	Ability to delete non-empty folders

•	Wizard interface for adding new sites

•	Graphic interface for connecting to FTP sites

•	Improved firewall support

•	Improved host types support

The following capabilities were new in the previous version:

•	Support for custom applications developed using the WS_FTP Pro Development Kit.

•	You can disable the Save Password function in the Session dialog box by entering the line SPFLAGS=1 in one of the following:

the [config] section of the WS_FTP.INI file in the WS_FTP folder

the [WS_FTP] section of the WIN.INI file in the Windows folder

•	New Uninstall option for cleanly removing the WS_FTP Pro application from a system

•	Can now change folders by entering the folder path directly in the text box under "Local System" or "Remote System."

•	Can remember the folders you visit during a session and saves the folder paths in a drop-down list you can access quickly.

•	The new Append file command lets you transfer a file or files and have them appended to a selected file on the other system.

•	Provides Year 2000 support through Dec 31, 2037.

•	The 16-bit version of WS_FTP Pro now has sorting capabilities for the list of files and folders.

•	The View, Execute, and Edit commands now honor the Extensions settings if Auto transfer mode is enabled. (32-bit version only)

•	Support for new firewall types.

•	Ability to associate file extensions of more than three characters


devkit
WS_FTP Pro Development Kit

The WS_FTP Pro Development Kit lets you create programs to work with WS_FTP Pro for transferring files to or from FTP sites or between FTP sites. For example, you can use the Development Kit to create an application that automates your regular downloads or uploads from an authoring system or a database system. The Development Kit provides the basic functionality to develop custom applications that use the File Transfer Protocol (FTP) and frees the developer from the intricacies of network programming.

The WS_FTP Pro Development Kit lets you use your choice of languages including C++, C, and Visual Basic. Developers can create stand-alone FTP applications or add network file transfer functionality to existing applications. Users can have specialized interfaces to FTP services that are simple to understand and use.

The WS_FTP Pro Development Kit provides:

•	Support of passive and normal file transfers

•	Automatic detection of WS_FTP Pro host type

•	Asynchronous and threaded versions of standard routines

•	Ability to use any FTP command

•	Programmer's guide with sample code

Some suggested applications:

•	Posting frequent updates to Internet or intranet servers

•	Automatic download of documents or programs

•	Regular updates of distributed databases

•	Automated mirroring of multiple FTP sites

For more information about the WS_FTP Pro Development Kit, see the Ipswitch web site at: http://www.ipswitch.com.


versions
WS_FTP Versions

The WS_FTP "classic" user interface is available as both WS_FTP Pro and WS_FTP Limited Edition (LE). WS_FTP LE is a shareware version of WS_FTP that is made available free to non-commercial users. Read the WS_FTP LE license for information about free use of the LE version.

Note: This help file documents the WS_FTP Pro version, so if you are using the LE version, you will not have some of the features documented.

WS_FTP Pro offers the following features not found in the LE version:

•	You can choose between the "Classic" interface, which is similar to the WS_FTP LE interface, and the "Explorer" interface, which integrates with Windows Explorer.

•	Technical support is available for WS_FTP Pro.

•	You can use folders to manage your FTP sites.

•	You can do remote-to-remote transfers.

•	Includes WS_FTP Pro Utilities to manage files and automate transfers:

•	WS_FTP Find Utility – lets users search an FTP site for files that match the user's criteria.

•	WS_FTP Scripting Utility - automates the transfer and management of files by letting you create scripts that use basic FTP commands.

•	WS_FTP Synchronize Utility - allows you to "mirror" folders and directories between your PC and a remote FTP server.

•	You can perform multiple file transfers using WS_FTP Pro commands from a DOS prompt.

•	You can use the WS_FTP Pro Development Kit (available separately) to write custom file transfer applications to automate regular uploads or downloads. See the Ipswitch web site at http://www.ipswitch.com for more information.

Executable Files

The WS_FTP Pro executable files are FTP95PRO.exe (for 32-bit operating systems of Windows 95, Windows NT, and Alpha processors) and FTPPRO.exe (designed for 16-bit environments but will work in any environment).

The WS_FTP LE works in both 16-bit and 32-bit environments. The executable names of the Limited Edition configurations are WS_FTP.exe for 16-bit environments, and WS_FTP95.exe for 32-bit environments.

Related Topics

WS_FTP Features


features
WS_FTP Features

You can use any version of WS_FTP (including the Limited Edition) to:

•	Create a connection between your local system and an FTP site

•	Create and retain sites to automate the logon and connection to frequently used FTP sites

•	Display and browse files and folders on both the local system and the FTP site

•	Transfer one or more files between the local system and an FTP site (in either direction) using Windows point-and-click capabilities

•	Access the vast store of information on anonymous FTP sites

•	Resume interrupted file transfers.

•	Preserve file date/time on transfer (Windows 95 and NT).

•	Prevent overwrite of newer files (Windows 95 and NT).

In addition to the above features, the 32-bit version also lets you:

•	Drag-and-drop between a local system and an FTP site.

•	Perform multiple file transfers using WS_FTP Pro commands from a DOS prompt.

•	Use the WS_FTP Pro Development Kit (available separately) to write custom file transfer applications to automate regular uploads or downloads. See the Ipswitch web site at http://www.ipswitch.com for more information.


Firewall
Using a Firewall

If you are behind a firewall, select Use Firewall and enter the firewall information. To enter firewall information, you'll need to get information about your firewall from your network administrator; depending on the type of firewall, you'll need the following information.

•	For a "SITE hostname" firewall type, you'll need Host Name (or Address) and User Name (ID).

•	For a "Transparent" firewall type, you'll need User Name (ID) and Password.

•	For "USER with no logon" or "Proxy OPEN" firewall types, you'll need the Host Name (or Address). (The User Name and Password are ignored.)

•	For "USER after logon," "USER remoteID@remoteHost fireID," "USER fireID@remoteHost," or "USER remoteID@fireID@remoteHost" firewall types, you'll need Host Name (or Address), User Name (ID), and Password.

Host Name. Specify the name or IP address of the firewall.

User ID. Enter the firewall User ID or leave blank if not used.

Password. Enter the firewall password for the specified User ID or leave blank if not used.

Save Password. Select this box only if you are the only user of your computer and no one else has access to your Windows folder. Passwords are stored in the WS_FTP.INI file and even though they are encrypted, it is an easy encryption to break.

Port. Specify the firewall port.

Firewall type. Select the firewall type from the drop-down list.

Passive Mode

For some router-based firewalls, you will want to use passive mode, in which the "data" connections are established by the client rather than by the FTP site. The passive mode of operation can be turned on from the Options screen.


Transferring files
Transferring Files or Folders

To transfer files or folders:

1	Select the files or folders on the source system.

2	Open the folder to which you want to transfer files on the destination system.

3	Select the file transfer mode.

4	Transfer the files using the left and right arrow buttons located between the list boxes.

Click the left arrow button to transfer files from the remote to the local system.

Click the right arrow button to transfer files from the local system to the FTP site.

File uploads and downloads do timeout. You can Cancel the operation in the event that you lose the connection to the FTP site.

During the transfer of files, the Help button changes to Cancel if the Show transfer dialog option is not selected. If this option is selected, a Transfer Status dialog box appears. The current transfer can be cancelled by clicking the Cancel button. File uploads will cancel immediately while file downloads may take up to 30 seconds to cancel. In both cases, the partial file is not deleted automatically. You may have to click Cancel a second time!

•	Note: You can hold the Ctrl key down when you click the transfer arrow to be prompted for a destination filename. You can also click a transfer arrow when no file is selected and you will be prompted for the source file name. This can then be a full pathname or a simple name.

See also:

Transferring multiple files

Appending Files

Transfer mode

Resuming a File Transfer After Failure

Double-clicking in list boxes

Changing Directories

HINTS

Auto Transfer of Files


resume transfer
Resuming File Transfer (Auto reget)

Most, but not all, FTP sites allow the "auto reget" option. It works like this: when a file transfer is interrupted while in progress because of a lost connection or because it was cancelled, WS_FTP Pro can resume the transfer when you reconnect to the FTP site. When you reconnect, WS_FTP Pro asks if you want to resume the transfer.

Do one of the following:

•	Click Yes to resume the transfer.

•	Click No to cancel the transfer.

•	Note: If you choose not to resume the transfer, you will be left with a partial file (from the interrupted transfer) in the destination folder. You should delete this file.

The resume transfer feature is enabled by default. You can disable this feature by toggling off the check box for the Enable auto reget of failed transfers option in the Pro options.


Hints

•	If you have problems transferring files, try changing the MTU of your stack to 576.

•	Make sure you use binary mode to transfer .zip or .exe files.

•	Make sure your modem is set to hardware flow control if you are using a SLIP or PPP connection.

•	If you get a "Can't open file for write" message from Windows, exit to DOS, enter SET and make the folders specified by your TMP and TEMP environment variables.

•	Hold the Ctrl key down when you click a transfer arrow to be prompted for a destination file name.

•	For additional functions, use the right-mouse menu anywhere in the main window.

See also:

Changing the Default Folder on the Local System

Overcoming Name Conversion Problems

Changing Folders

Execute

Double-click

Transfer Mode

Saving a "Viewed" File

Drag and Drop

No directory listing

Access to Debug Commands


Changing the default directory
Changing the Default Folder (Directory)

To set the default folder on your PC to be something other than where WS_FTP Pro is located:

•	Highlight the WS_FTP Pro icon and press Alt-Enter (or select Properties) in Windows.

•	Change the Start in folder to the desired folders.

In the 32-bit version, you can also save the current folders (when connected) to be the default folders when you next connect to the FTP site (see Session Options).


Overcoming Name Conversion Problems

If you have problems with remote to local file name conversions, select the Prompt for destination file names option on the Session (cont'd) tab of Program Options. You will then be shown the proposed file name and allowed to change it. Alternatively, you can hold the Ctrl key down when you initiate the transfer and you will be prompted for each destination filename.


Changing Directories
Changing Folders

To change folders, click on the desired folder and click the ChgDir button.

If you want to change to a folder without scrolling and moving up and down the folder structure, make sure there is no name selected in the list box and click the ChgDir button (works with RmDir button also). When changing drives on an FTP site, you usually have to enter a folder name in addition to the drive letter.

You can also double-click a folder name to change to that folder.

To change folders in the 32-bit version, edit the folder path in the current folder box, or use the ChgDir button. Also, if you enable the Remember directories option, the drop-down list for both the Local System and Remote System current folders will show the folders you visited during the last session.

See also Changing the Default Local Directory


Double Clicking
Double-clicking

You can double-click a folder name to make that folder current.

You can double-click a file name to transfer that file (or to execute the file), depending on the how you set up the double-click options.You can choose to have the double-click action for files activate one of the following:

Transfer file

View file

Nothing


File Transfer Modes

Use binary mode to transfer all files unless you know the file contains only text, then use ASCII.

If you know that the FTP site you are transferring to or from is the same host type as your PC, you can always use Binary mode and never use ASCII.

Transfer Modes:

ASCII

BINARY

L8

Auto Detect


Saving a "viewed" file

If you use View to display a remote file and then want to save that file and have the viewer set to Notepad, you can select the Save As... menu option and save the file to whatever name you want.


Transferring Multiple Files

To transfer multiple files, use the Shift or Ctrl keys when selecting file names. (These are the standard Windows methods of selecting files.)

To select two or more items in sequence:

•	Click the first file that you want to select and drag the mouse pointer down, releasing the mouse button on the last file in the group.

or,

•	Click the first file that you want to select.

•	Press and hold down Shift while you click the last file in the group.

To select two or more non-contiguous files:

•	Press and hold down Ctrl while you click each file icon.

To de-select a selected file icon:

•	Press and hold down Ctrl while you click the selected file icon.

After selecting the desired files, click the left arrow or right arrow button.


Drag and Drop Feature
Drag and Drop Feature in WS_FTP Pro (not in LE)

You can drag and drop one or more files from the source system to the destination system within the main window. You can also drag-and-drop between WS_FTP Pro and the desktop, or between WS_FTP Pro and other applications. Note that the ability to use the enhanced dragging and dropping in the Pro version is controlled by an option on the Pro tab of the Program Options.

Notes on 16-bit version

In the 16-bit version, you can move files by dragging a file or group of files to a folder on the same system. However, you cannot drag and drop folders in the 16-bit version of WS_FTP Pro, nor can you drag and drop from the FTP site to another application.


Directory Display Problems
Folder Display Problems

If you can connect to an FTP site but don't get a folder listing, try changing the host type in the Session Properties or on the Session tab of Program Options. "Automatic detect" takes care of about 90% of all FTP sites; however, some sites may not be properly auto-detected and must be set at connect time.

If you are dealing with an FTP site that won't display correctly, use the following procedure.

If the FTP site is available via anonymous FTP or if you can create a test account for us, send access information to <junodj@ipswitch.com>

If the FTP site is not available via anonymous FTP,

1	Go to General Options (Program Options in the 16-bit version) and select Debug Messages.

2	Exit WS_FTP Pro and restart.

3	Connect to the FTP site.

4	Press the LogWnd button and save the log window to a file.

5	Press the DirInfo button and save the file listing to a file.

6	Mail both files to <junodj@ipswitch.com> along with as much of a description of the FTP site as possible.


Options (2-window)
Program Options

In the WS_FTP Pro window, click the Options button. The properties dialog box appears with the following tabs.

General tab. Settings for basic operations of WS_FTP Pro.

Advanced tab. Settings for advanced operations of WS_FTP Pro.

Display tab. Settings for the layout of the main window.

Sounds tab. Settings for sounds that notify you of FTP events.

Sort tab. Settings for sorting the folder and file names in the list boxes.

Pro tab. Settings for Pro only features.

Session tab. Settings for how you're currently transferring, or how you always transfer.

Convert tab. Lets you convert file extensions on transfer.

Extensions Tab Lets you specify extensions to be transferred in ASCII format when using Auto Mode file transfer.

Associations Tab Lets you associate file extensions with an executable program.


OPTIONS - General
Program Options, General Tab

E-Mail Address

Text Viewer

Log Filename

Enable Log

Verify Deletions

Debug Messages

Remote Edit uses ShellExecute

Reset Window Locations

Save Window Locations


OPTIONS - Advanced
Program Options, Advanced Tab

Show Full Directory Information

Auto Save Host Configurations

Show Connect Dialog on Startup

Double-click Action

Network Buffer Receive Size

Network Buffer Transmission Size

Transfer Rate Display


OPTIONS - Display
Program Options, Display Tab

Options available in this dialog affect the display of WS_FTP Pro.

Alternate Screen Layout

Show Buttons at Top of Screen

Hide Directory Buttons

Auto Scale Fonts

Date Format

List Box Font


OPTIONS - Sounds
Program Options, Sounds Tab

Connection Success. If selected, the specified wave file (or beep) is sounded when a connection is made to an FTP site.

Connection Failure. If selected, the specified wave file (or beep) is sounded when a connection fails.

Transfer Complete Success. If selected, the specified wave file (or beep) is sounded when a transfer succeeds.

Transfer Complete Failure. If selected, the specified wave file (or beep) is sounded when a transfer fails.

Other Failures. If selected, the specified wave file (or beep) is sounded when any error occurs during the retrieval of folders, renaming or deleting files or folders, or during other FTP errors. To have the same sounds as earlier versions of WS_FTP Pro, make sure this box is cleared.

Sounds

None - no sounds

Beeps - use system sounds

Wave - play the specified WAV files


OPTIONS - Session
Program Options, Session Tab

The settings on the Session and Session (cont'd) tabs of the Program Options can be applied in two different ways. They can be:

•	Set for the current site and until you Exit the program

or,

•	Always in effect.

If you want the settings to apply to the current site and until you Exit the program, set the desired options and click Apply or OK. (Do not click Set as default.)

If you want the settings to remain in effect when you re-start WS_FTP Pro, set the desired options and click Set as default.

Host Type

Update Directories After Transfer

Show Transfer Progress Dialog

Use Passive Transfer Mode

Use Firewall

Force Lowercase Remote Names

Convert Extensions

Remember Directories

Save Current Directories as Connection Directories

Set as Default

For more session settings see Session (continued).


OPTIONS - Session (cont)
Program Options, Session (cont'd) Tab

The settings on the Session and Session (cont'd) tabs of the Program Options can be applied in two different ways. They can be:

•	Set for the current site and until you Exit the program

or,

•	Always in effect.

If you want the settings to apply to the current site and until you Exit the program, set the desired options and click Apply or OK. (Do not click Set as default.)

If you want the settings to remain in effect when you re-start WS_FTP Pro, set the desired options and click Set as default.

File Names

Send Unique (host assigns name)

Receive Unique (PC assigns name)

Prompt for Destination File Names

Startup Transfer Mode

The Startup Transfer Mode is the default transfer mode when you transfer a file. You can change this for individual transfers.

ASCII

BINARY

L8

Auto Detect

Set as Default


OPTIONS - Pro
Program Options, Pro Tab

Use the Pro tab to enable or disable certain features of WS_FTP Pro.

Enable drag and drop between windows

Enable auto reget of failed transfers

Preserve file time on transfer from remote

Prompt for overwrite of same or newer files

Don't transfer older or same files during directory transfer

Allow deletion of non-empty folders


OPTIONS - Sort
Sorting List Boxes

You can sort the files and folders in the Local System or Remote System list boxes from here. Simply select the desired sort order from the list.

See also:

Sorting Directories and Files.


OPTIONS - Convert
Converting File Extensions

The list box on the Convert tab shows all defined extension conversions. Use this tab to have WS_FTP Pro automatically convert the extensions of transferred files. For example, if the FTP site uses .html for HTML files and your system uses .htm, you can specify that all files with the extension .html are converted to .htm when they are transferred.

Note: Select Convert Extensions in the Session tab.

To add an extension conversion:

1	In the Source text box, enter the file extension of the source file.

2	In the Destination text box, enter the file extension to convert to (destination file).

3	Click the Add button. The extension conversion appears in the list box.

To delete an extension conversion:

•	Select it in the list box and click the Delete button.


OPTIONS - Extensions
Setting Auto Detect Extensions

When Auto Detect is selected as the transfer mode, WS_FTP Pro transfers all files in binary mode, unless the extension is listed here -- in which case the file is transferred in ASCII (text) mode.

To add a file extension to the Auto Detect list:

1	In the text box, enter a file extension. (The extension can be up to ten characters long and can contain periods.)

2	Click the Add button. The extension appears in the list box.

To delete a file extension from the list box:

•	Select the extension and click the Delete button.


OPTIONS - Associations
Setting Associations

The Associations tab is used to associate files of a particular extension with an executable file (application) that can run that type of file. When you choose the Exec button, the file is opened in the associated application.

To set up an association:

1	Click the Options button, and click the Associations tab (if it's not already visible).

2	In the Files with Extension text box, enter the file extension to be associated with an executable program.

3	In the Associate With text box, enter the executable program to run when the Exec button is clicked. You can use the Browse button to browse your files and folders to locate the executable program.

•	Note: The 32-bit version of WS_FTP Pro calls ShellExecute to execute the file through the shell. If this fails, WS_FTP Pro uses the associations specified in this dialog. These associations are unique to WS_FTP Pro in this environment.


Author Information

Copyright 1992-1998, Ipswitch, Inc.

Written by John Junod, Joe O'Connor, Mary Jane Soule.


Acknowledgments

There have been a lot of people that have contributed ideas and information to support WS_FTP Pro. It is no longer possible to keep up with this list of people. Sorry!

Some code concepts are based on code that is copyrighted by the Regents of the University of California or code published in UNIX Network Programming by W. Richard Stevens or published in Programming Windows by Charles Petzold or in the Microsoft manuals/samples or code in WATTCP or other public sources. The rest is based on my knowledge of Windows programming and my interpretation of RFC 969 and the Windows Sockets API version 1.1.

- John Junod


License Information

Copyright © 1992-1998 Ipswitch, Inc. All rights reserved.

Please refer to the separate license agreement.


Latest Version

The latest version of the Limited Edition can be found through the Web on http://www.ipswitch.com or at the "home" FTP site FTP1.IPSWITCH.COM.

The WS_FTP Pro web home pages are at http://www.ipswitch.com.


Installation
Installing WS_FTP Pro

The installation procedure is the same for new users as it is for upgraders.

To install WS_FTP Pro,

1	Insert the WS_FTP Pro disk into a floppy disk drive.

2	If you are running Windows 95 or NT 4.0 or later, click the Start button and select Run. If you are running Windows 3.x or NT 3.51, select Run form the File menu.

3	Enter the drive letter followed by install.exe. For example, a:install.exe.

4	When asked, choose WS_FTP Pro Installation.

5	Follow the instructions on your screen.

•	Note: If you are upgrading from a previous version of WS_FTP Pro, do not replace the WS_FTP. ini file, as this file contains all your sites.


Troubleshooting

This section lists some of the common FTP connection and file transfer problems. For more solutions to common questions, see the Support area of our Web site. Go to http://www.ipswitch.com and click the Support link.

Problems Connecting to an FTP Site

Problem: I cannot connect to an FTP site.

Solution: Make sure you have an active dial-up or direct Internet connection. WS_FTP Pro is not a dialer. It calls the Winsock DLL and uses the dialer or direct connection specified there.

Problem: I installed the 32-bit or Windows 95 version of WS_FTP Pro on Windows 95, then started WS_FTP Pro but cannot connect to another system.

Solution: Check to see if you are running the Windows 95 TCP/IP stack. If not, install the 16-bit version of WS_FTP Pro, start WS_FTP Pro and try to make the connection. (If this works, you are running a 16-bit TCP/IP stack.)

Problem: I cannot log on to the FTP site.

Solution: Check your folder and file access privileges on the FTP site. These permissions are set by the site administrator and cannot be changed by WS_FTP Pro.

Problem: My connection closes after n minutes of inactivity.

Solution: The FTP site determines the connection timeout. Most FTP sites will close the connection after a few minutes of inactivity. You can change this setting only on the FTP site, not from WS_FTP Pro.

Problem: WS_FTP Pro doesn't work with my AOL connection.

Solution: AOL uses a 16-bit TCP/IP stack and will not work with 32-bit TCP/IP applications. For more information on AOL's Winsock support, see the FTP section in your AOL application. You will need to run the 16-bit version of WS_FTP (FTPPRO.EXE).

Problem: WS_FTP Pro can connect to an Ipswitch site and nothing else.

Solution: Configure the DNS (Domain Name Server) in your stack. Talk with your network administrator or your internet provider for the proper values for DNS.

Problems Viewing Files and folders

Problem: I can connect to an FTP site, but the folder and file display is blank or unreadable.

Solution: Change the host type. Try looking in the message log to see if the host type of the FTP site is identified. If you can't figure out the host type, you can try common types such as "UNIX (standard)," "Sun Solaris," or "Win QVT/Net." If those don't work, try "Auto-detect." If you are still having problems, see Directory Display Problems.

Problem: I cannot open a folder on the FTP site or transfer a file.

Solution: Check that you have a valid login name and password. If you do not, try selecting the Anonymous check box in the Site Properties; or, contact the system administrator of the FTP site to which you are trying to connect.

Problem: When I connect to an FTP site, the list box for the FTP site is blank. In the status window the last thing I see is "DoDirList returned 4."

Solution: Contact your Internet provider to get the proper setting for the Maximum Transfer Unit (MTU) of your network stack. (You can try 552 or 576 as they seem to be common proper values.)

Problems Transferring Files

Problem: The files I transferred are corrupted.

Solution: You may have transferred a binary file in ASCII transfer mode; this can damage the file. Make sure you transfer text files in ASCII mode and most other files in BINARY mode. If you still have problems, verify that you have hardware flow control enabled on your modem. If you are not using the Microsoft TCP/IP stack (part of the Windows 95 or NT operating system), contact your stack vendor.

Problem: I keep getting "failed data channel" errors.

Solution: Try passive transfers.

Problem: How can I transfer a hidden file or a file with a filename containing special characters?

Solution: Make sure nothing is selected, and then click the transfer arrow; you will be prompted for the filename.

Problem: WS_FTP Pro does not always return a complete file and leaves off from 50 to 512 bytes.

Solution: Some network stacks do not properly handle data packets that have the FIN flag set. If you're not using the Microsoft TCP/IP stack (part of the Windows 95 and NT operating systems), contact your network stack provider for an updated version of the network stack.

Problem: WS_FTP Pro only returns NNNNN bytes of a file and can never retrieve the whole file.

Solution: Set the Maximum Transfer Unit (MTU) in your program stack to 576.

Problem: I am running Windows 3.x, and I find that uploading any file over 25K often takes more than 30 minutes, after which I am timed out and disconnected.

Solution: You can solve the slow transfer problem by adding the following to your SYSTEM.INI file (for WIN3.x):

[VNTSPSD]

MaxFramesSize=1000

Problem: I receive one or more "Blocking call cancelled" messages and the file transfer is incomplete.

Solution: If you are using the Microsoft TCP/IP stack (part of the Windows 95 and NT operating systems), try setting the Maximum Transfer Unit (MTU) to 576.

Problems with Program Settings

Problem: WS_FTP Pro won't save the internal window sizes when I click the Save Window Locations button.

Solution: Un-maximize the main window and resize it as you like. Then, click Save Window Locations. (WS_FTP Pro does not save window locations when the window is maximized.)

Problems Renaming and Deleting Files

Problem: I can't rename a file on an FTP site.

Solution: You may not have renaming privileges on the site.

Problem: I can't rename a file on an FTP site, even though I have renaming privileges.

Solution: You may be trying to use a long name on an FTP site that doesn't allow long names. Try a name of eight characters or less.

Problem: I can't delete a file from an FTP site.

Solution: You may not have deletion privileges on the FTP site.


Download Patches
Downloading Software Patches and New Versions

On occasion, Ipswitch provides a software patch to fix a bug in the currently shipping version of WS_FTP Pro. You can check our download FTP folder or our download folder on our web site for current software patches.

To access download software on the Ipswitch FTP site:

1	In the WS_FTP Pro window, click the Connect button. The Session Properties dialog box appears.

2	In the Session Properties dialog box, select Ipswitch from the Profile Name drop-down list, and then click OK.
WS_FTP Pro connects to the download folder.

3	Select the patch file for your platform type: Intel = x86; DEC Alpha = AXP. The last three digits of the filename indicate the version number. For example, x86_404.exe is the patch file for the Intel platform. 404 indicates version 4.04.

4	Transfer the patch file and place it in your WS_FTP Pro folder. Run the patch file to update the software.

To access download software on the Ipswitch web site:

1	In your web browser, go to: http://www.ipswitch.com

2	Click the Downloads link.

3	Click Patches and Upgrades, and then click the link for your platform type: Intel or DEC Alpha.

4	Save the patch file in your WS_FTP Pro folder.

5	Run the patch file to update the software.


working w dirs and files
Working with Files and Folders

After connecting to an FTP site, you can use the file and folder commands to browse files and folders.

Just to the right of each list box (one under Local System and one under Remote System) is a column of buttons you can use to perform file and folder operations. See WS_FTP Pro window for more information.

You can also access these commands by placing the cursor over the appropriate list box and using the right mouse menu.

File functions:

Transferring Files

Moving Files

Finding Files and Folders

Viewing Files

Executing Files

Editing Files

Renaming Files

Deleting Files

Changing Permissions on a UNIX file

Associations Options

Converting File Extensions

Folder functions:

Changing the Drive

Changing Folders

Creating and Removing Folders

Refreshing the Display

Displaying File and Folder Information

Sorting Files and Folders

See also:

Selecting Files and Folders


select dirs and files
Selecting Files and Folders

To select a file or folder in the current folder, select the file or folder name in the Local System or Remote System list.

To select multiple files or folders:

•	If the files or folder are contiguous in the list, click the first one you want to select, and then Shift-click the last one.

•	If the files or folders are not contiguous, click the first one you want to select, and then Ctrl-click any others you want to select.

To de-select all files and folders, click the Refresh button.


change default drive
Changing the Drive

The folders shown at the top of the main window under Local System and Remote System also indicate the disk drive on which the folder is located. To change the disk drive:

•	Scroll down the list box and double-click the appropriate drive. In Windows 95, disk drives are indicated by a drive letter (for example, a:, c:, d:) and a disk icon.

  or,

•	With nothing selected in the list box, click the ChgDir button. When you are prompted for a folder to change to, enter the drive letter followed by a semicolon (for example, d:), and then click the OK button.

Note: Do not enter a trailing slash (\).


create and remove dirs
Creating and Removing Folders

Not all FTP sites allow you to create and remove folders; you must have an account on the FTP site and write access privileges. For those that do, use the following procedures.

Creating Folders

•	To create a folder, click the MkDir button. You are prompted for a folder name and must supply a name that is valid for the current system.

Removing Folders

In the 32-bit version:

•	Select the folder and click the Delete button. Or, click the Delete button with nothing selected and enter a folder name when prompted.

Note: If the folder is not empty, you will not be able to delete it unless you have selected Allow deletion of non-empty folders on the Pro tab of Program Options.

In the 16-bit version:

•	Select the folder and click the RmDir button. Or, click the RmDir button with nothing selected and enter a folder name when prompted.


refresh dir display
Refreshing the Display

To refresh the current display for either the Local System or Remote System , click the Refresh button. The list displays any recent changes to the current folder.

You can also use the Refresh button to de-select any selected files or folders.


display dirinfo
Displaying File and Folder Information

To display file and folder information,

•	Click the DirInfo button.

The Windows Notepad appears and lists the files and folders in the current folder with the size, creation date and time, and protections.

You can:

•	Save the folder listing

•	Print the folder listing

•	Specify a different editor (The Windows Notepad is the default) by using the Text Viewer option in the General properties of the Program Options.


find dirs and files
Finding Files and Folders

If either the local system or the FTP site contains a large number of folders and files, you can limit the items displayed by using the File Mask text box, located below the MkDir button in the WS_FTP Pro window. There are two File Mask boxes: one for the local system (your PC) and one for the remote system (FTP site).

In the File Mask text box, enter a file mask and then press Enter. For example, to display only files with the extension .txt, enter *.txt in the File Mask text box and press Enter. The corresponding list box is refreshed to display only the files with the extension .txt.

If you are connected to a UNIX FTP site, you can use:

•	-al or -la in the File Mask text box to view hidden (.) files

•	-altr to view file names in date sequence (in the 16-bit versions of WS_FTP Pro only)

For users familiar with command line FTP clients: You can use any argument string that is valid with a "Dir" command in a command line FTP client.


view files
Viewing Text Files

Select the file and click the View button. The file is opened in the viewer you have specified in the Text Viewer option on the General tab of the Program Options. The default text viewer is the Windows Notepad.

Select Ctrl+View to display a prompt where you can enter the executable file name for another viewer program.

If you select the View button for the Remote System list box, the file is downloaded to the Windows temporary folder (defined with the DOS TMP environment variable). If it is a large file, it may take some time to transfer the file from the FTP site.

•	Note: Do not try to view a binary file.


execute files
Executing Files

Select the file and then click the Exec button. WS_FTP Pro executes the file according to its file extension. You can associate any file extensions with an application (executable program) in the Associations properties. For example, you can specify that any files with the extension .pdf are opened by the Adobe Acrobat (tm) Reader.

Press Ctrl-Exec to display a prompt where you can enter the executable file name for the application.

If you select the Exec button for the Remote System list box, the file is downloaded to the Windows temporary folder (defined with the DOS TMP environment variable). If an association does not exist, you can provide that association at execution time. This association is saved in the win.ini file in the Extensions section and is also valid for Windows. Files are automatically downloaded in binary mode.


Editing Files

You can edit a file on an FTP site if you have an account on the site as well as write access privileges to the file and its folder.

If you associate a file extension with an editor program (see the Associations options), you can open a remote file and edit it. Right-click the file and select Edit from the pop-up menu.

The Remote Edit uses ShellExecute option in the General tab of the Program Options (32-bit version) lets you open the remote file without transferring it to your PC.


rename files
Renaming Files

Not all FTP sites allow you to rename files and folders remotely. You can rename files only if you have an account on the FTP site and renaming access privileges.

To rename a file:

1	Select one or more files

2	Click the Rename button. You are prompted for the new name.

3	Enter the new name for the item and click OK.

If you selected multiple files, you are prompted to rename the next file.

You can also use Prompt for Destination File Names on the Session tab of the Program Options to get a prompt that allows you to rename a file as you transfer it.


delete files
Deleting Files and Folders

Not all FTP sites allow you to delete files and folders. You can delete only if the site administrator has given "delete" privileges to the account you logged on with. To delete a file or folder, select it and then click the Delete button.

•	Note: You will not be able to delete non-empty folders unless you have selected Allow deletion of non-empty folders on the Pro tab of Program Options.


change permissons
Changing the Permissions for UNIX Files

You can change modes for a UNIX file on an FTP site, provided you have file-access permission.

1	Right-click the file and select chmod from the pop-up menu.

2	Select any of the options and click the OK button.


Uninstalling

To uninstall WS_FTP Pro,

1	Insert the WS_FTP Pro disk into a floppy disk drive.

2	If you are running Windows 95 or NT 4.0 or later, click the Start button and select Run. If you are running Windows 3.x or NT 3.51, select Run form the File menu.

3	Enter the drive letter followed by install.exe. For example, a:install.exe.

4	When asked, choose Uninstall WS_FTP Pro.

5	Follow the instructions on your screen.


Organizing Sites in Folders

You can organize your configured sites in folders. For example, you might have one folder for FTP sites that offer free games, and another folder for FTP sites from which you download software updates.

To create a folder for sites,

1	Click Connect to view the WS_FTP Sites dialog box (if you're not already there).

2	Click New.

3	Click Folder.

4	Enter a name for the folder and click Finish. The new folder appears in the list of Configured Sites.

To place sites in the folder,

1	Click Connect to view the WS_FTP Sites dialog box (if you're not already there).

2	Drag sites and folders around in the dialog box using standard Windows techniques.


Overview: Connecting to FTP Sites

Before you transfer files to or from an FTP site, you must first connect to the site.

To connect to an FTP site, click the Connect button (unless the WS_FTP Sites dialog box is already displayed). The WS_FTP Sites dialog appears.

If you already have configured the FTP site to which you want to connect, you connect to it by double-clicking the site name.

If you don't have an FTP site already configured and expect to go to that site repeatedly, click New.

If you don't have an FTP site already configured, but want to connect to the site just this once, click Quick Connect.

See also:

Organizing Sites in Folders


Quick Connect

Quick Connect provides a means for you to connect to an FTP site without configuring site properties for it; for example, you might use Quick Connect to connect to a site that you want to visit just once.

Host Name/IP Address

Host Type

Anonymous (Login)

User ID

Password


WS_FTP Sites

You can configure FTP sites that you expect to visit more than once; the FTP sites you have configured are listed in this dialog box, along with some pre-configured sites that come with WS_FTP Pro.

To connect to an FTP site,

1	Locate the desired site in the list.

2	Double-click it (or select it and click OK).

You can also use the buttons on the right side of the dialog box:

Quick Connect. Lets you connect to an FTP site you don't want to configure for future connections.

New. Lets you create a new FTP site or a new folder in which to group sites.

Delete. Deletes the selected site.

Rename. Allows you to rename the selected site.

Properties. Lets you edit the site properties.

Cancel. Closes the dialog box.

See also:

Organizing FTP Sites in Folders


Passwords and ini file

The Save Password check box can be removed from the options by entering the line SPFLAGS=1 in one of the following:

the [config] section of the WS_FTP.INI file in the WS_FTP folder

the [WS_FTP] section of the WIN.INI file in the Windows folder


Host Type Problems

If you can connect to a FTP site but don't get a folder listing, try changing the host type.

•	Note: Check the messages log (click the LogWnd button) to see if the Host Type is identified there. Then, select the corresponding host type from the drop-down list.


Monitoring whats going on
Monitoring what's going on

You can:

Monitor the progress of a transfer

Get an alert when you're about to overwrite a file

Get a confirmation before you delete a file


Monitoring the progress of a transfer

1	To monitor the progress of transfers to or from a particular site, click Options.

2	Click the Session tab.

3	To display a status indicator showing the progress of a transfer, select Show Transfer Progress Dialog.

4	TBD: How to apply setting to just the current site or to all sites, or only until you quit, etc.


Displaying a notice when a transfer is complete
Displaying a notice when a transfer is complete (I think this option is gone; feature on by default?)


Getting an alert before you overwrite a file
Getting an alert before you overwrite a file (TBD: update for Classic)

1	To get an alert when you are about to overwrite a file during a transfer to or from a particular site, click Options.

2	Click the Pro tab.

3	Select Prompt for overwrite of same or newer files.

4	TBD: How to apply setting to just the current site or to all sites, or only until you quit, etc.


Getting a confirmation before you delete a file

1	To get a confirmation before you delete a file, click Options.

2	Click the General tab.

3	Select Verify deletions.

4	TBD: How to apply setting to just the current site or to all sites, or only until you quit, etc.


Overview
Overview of the WS_FTP Pro Command Line

You can use the command line from the MS-DOS prompt to run the WS_FTP Pro classic interface under Windows 95, Windows 98, or Windows NT. (If you are a Windows 3.1 user, click here.)

When you use the command line, you are actually running a subset of the functionality of the WS_FTP Pro classic interface. Using the command line, you can:

•	Upload and download files

•	Specify ASCII or binary transfer mode

•	Convert filenames to lowercase when uploading

•	Set up pre-scheduled (“automated”) transfers

However, the command line doesn’t provide the means to rename files on an FTP site, delete files from an FTP site, or create folders on an FTP site. Nor can you preserve time stamps or convert file extensions when transferring files.

•	Note: In order to be able to use the command line from any location on your hard disk, we recommend that you place the WS_FTP Pro folder in the Path statement in your Autoexec.bat file – if you are running Windows 95 or Windows 98. If you’re using Windows NT, add the WS_FTP Pro folder to the path variable in the System Environment. Otherwise, change to your .ini file folder before you enter the commands.

See also:

Basic Command Line Syntax

Using a Batch File

Transferring Multiple Files From the Same Location

Doing Pre-Scheduled (Automatic) Transfers

File Transfer Modes

Transferring a Folder with Subfolders

Windows 3.1 Users


Basic Syntax

To use the command line, you type the command name (ftp95pro for the 32-bit version of WS_FTP, ftppro for the 16-bit version) followed by whatever arguments you need to complete your task. For example,

ftp95pro -p Damion -s local:c:Tag.doc -d Damion:/Tag.doc

The three arguments used most often are -p, -s, and -d. These three arguments tell WS_FTP Pro, respectively, the name of the configured site, the source of the transfer, and the destination of the transfer.

•	Note: The -p argument must be the first argument after the ftp95pro command, unless you have more than one ws_ftp.ini file on your computer.

WS_FTP automatically logs you off the FTP site when the transfer is done.

See also:

Overview

Downloading Files

Uploading

File Transfer Modes

Using an IP Address, Host Name, or URL

Using a Batch File

Transferring Multiple Files From the Same Location

Transferring a Folder with Subfolders

Doing Pre-Scheduled (Automatic) Transfers

Transferring Files with Spaces in the File Names

Windows 3.1 Users


Using the Names of Configured Sites

You can use names of configured sites to do FTP transfers from the command line. If your site names have no spaces in them, you don’t need to do anything special. If, however, your site names have spaces, enclose the entire command in quotes, or see Transferring Files with Spaces in the File Names.

See also:

Using an IP Address, Host Name, or URL

Using FTP Site Accounts and Passwords


Uploading
Uploading Files

Let’s suppose that in the classic interface of WS_FTP Pro, you have a configured site named Damion. This site name logs you on to an FTP site whose host name is ftp.Damion.com. Let’s also suppose that on your C: drive, you have a folder named Sports and a file named Tag.doc in that folder. To upload the Tag.doc file to a folder named Drop on the Damion site, you enter the command name followed by the site name, the source location, and the destination location. At the MS-DOS prompt, type:

ftp95pro -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/Tag.doc

or,

ftp95pro -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/

You’ll notice that the second option omits the file name from the destination location. You can do this when you want the transferred file to have the same name as it does in the source location. However, note that you must enter the trailing slash after the destination folder in order for this to work.

See also:

Downloading Files

Renaming Files

File Transfer Modes


Downloading Files

Use the basic syntax for downloading files, except that, for clarity, you might want to place the FTP site before the local system. (WS_FTP Pro transfers the file from the location following -s to the location following -d, no matter which you enter first in the command line.)

For example, let’s suppose you want to download a file named War.doc from a folder named Pub on the Damion site, and let’s assume you want to copy it to the Games folder on your hard disk. Type:

ftp95pro -p Damion -s Damion:/Pub/War.doc -d local:c:\Games\War.doc

•	Tip: You can leave off the -s and -p, but when you do so, you must enter the source location first, and the destination second. For example,

ftp95pro -p Damion Damion:/Pub/War.doc local:c:\Games\War.doc

See also:

Uploading Files

Renaming Files

File Transfer Modes


Renaming Files

To rename a file as you upload it, use the basic command line syntax, being sure to enter a new file name after the destination folder. For example, to upload a file named Tag.doc file and rename it NewTag.doc on an FTP site named Damion, type:

ftp95pro -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/NewTag.doc

See also:

Uploading Files

Downloading Files

File Transfer Modes


Using FTP Site Accounts and Passwords

When you reference a configured site from the command line, WS_FTP Pro uses the user ID, password, and account you saved in the site configuration.

Account. If you have saved an account name in the site configuration, the command line logs you on using the account name. If you have not saved an account name, you can use the -c argument to specify the account name when you enter the command line. Assuming you are trying to transfer a file named Tag.doc to the Damion FTP site, and want to use an account named pisa, you would enter:

ftp95pro -p Damion -c pisa -s local:c:\Sports\Tag.doc -d Damion:/Drop/Tag.doc

Password. If you have saved a password with the site, the command line logs you on using the saved password. If you have not saved a password with the site, you will receive the the regular password prompt.


Using a Batch File

Instead of typing a command line at the MS-DOS prompt, you may find it more expedient to enter the command line into a batch file (a text file with the file extension .bat). This makes it easier to correct mistakes and to run the same command again.

You run the command by invoking the .bat file at MS-DOS prompt, double-clicking the icon for the .bat file from within Windows, or running the .bat file from another application (such as a program scheduler).

Suppose a batch file named Tag.bat contains the following text:

ftp95pro -p Damion -s local:c:Tag.doc -d Damion:/Tag.doc

When you run the batch file named Tag.bat, WS_FTP Pro uploads the Tag.doc file to the Damion FTP site.

•	Note: Using a batch file involves placing the command name (ftp95pro or ftppro) at the beginning of each line in the file. Since each instance of the command name starts the WS_FTP Pro application (and connects to the FTP site), you would only use a batch file to work with one command at a time. If, on the other hand, you want to issue a group of commands, see Multiple Folders or Commands.

Remember that if a file name has a space in it, you must enclose the entire command in quotes. Furthermore, you must include the -i argument if the WS_FTP Pro folder is not in your path statement, or if the wsftp.ini file you want to use is not in the same folder as the WS_FTP Pro application. See Specifying Which .ini File to Use.

See also:

File Transfer Modes

Transferring a Folder with Subfolders


File Transfer Modes

You can transfer files in binary mode or in ASCII mode. You’ll want to use binary mode to transfer all files unless you know the file contains only text, then you’ll want to use ASCII mode.

To specify the transfer mode, you use the -binary or -ascii argument in the command. To be sure that you transfer a file named Tag.doc using binary mode, enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/Tag.doc -binary

If however, the file were a text file named Tag.txt, and you want to be sure it is transferred correctly, you’d enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Sports\Tag.txt -d Damion:/Drop/Tag.txt -ascii

•	Note: When you don’t specify the transfer mode in the command line, WS_FTP Pro transfers the file in whatever file transfer mode is the default in the WS_FTP Pro classic interface. Therefore, if you plan on using the command line more than just occasionally, set the Startup Transfer Mode to Auto Detect.


Transferring Multiple Files from Same Location

If all the files you want to transfer are in the same folder, you can use the  wildcard characters, * and ?, in the file name. To transfer all files in a local folder named Sports to the Drop folder on an FTP site named Damion, enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Sports\*.* -d Damion:/Drop/

Or, to transfer all .doc files in the same folder, enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Sports\*.doc -d Damion:/Drop/

To transfer multiple files not in the same folder, see Working with Multiple Folders or Commands.

See also:

File Transfer Modes

Transferring a Folder with Subfolders


Working with Multiple Folders or Commands
Working with Multiple Locations or Commands

To transfer files to or from multiple source or destination folders, or to issue multiple commands, use the -m argument followed by the name of a text file that contains the commands. For example, to transfer files from several locations on your PC to an FTP site named Damion, you might enter (at the MS-DOS prompt or in a batch file):

ftp95pro -m xferall.txt

where the content of xferall.txt is:

-p Damion -s local:c:\Sports\Frisby.doc -d Damion:/Drop/

-p Damion -s local:c:\Party\Invite.bmp -d Damion:/ToPrint/

-p Peapod -s local:c:\Recipes\Goulash.txt -d Peapod:/Incoming/

Note that:

•	The command name (ftp95pro or ftppro) must not appear in the text file

•	Each line of text must contain only one command line.

•	Each command line can contain any command line arguments.

•	If a file name has a space in it, the entire command line must be enclosed in quotes.

See also:

File Transfer Modes

Transferring a Folder with Subfolders


Doing Pre-Scheduled (Automated) Transfers

You can use the command line to set up transfers that you want to run automatically at a certain time. To do this, you create a batch file, and then run the batch file using a scheduler such as the AT command in Windows NT, the Task Scheduler in Windows 98 or Internet Explorer 4, or the System Agent in Windows 95 w/plus.

You can use the -quiet parameter in pre-scheduled transfers to prevent WS_FTP Pro from displaying a message box if and when an error occurs. This is particularly useful for avoiding a situation in which WS_FTP Pro might otherwise prompt for user input, such as clicking the OK button in an error message. This way, you can pre-schedule transfers to run automatically when you’re not at your computer. (When you return to the computer, you can always check the log file to see if there were any problems.)

For example, you could create a batch file named auto10.bat with the following content:

ftp95pro -m xferall.txt

as well as the following text file:

-p Damion -s local:c:\Sports\Frisby.doc -d Damion:/Drop/

-p Damion -s local:c:\Party\Invite.bmp -d Damion:/ToPrint/

-p Peapod -s local:c:\Recipes\Goulash.txt -d Peapod:/Incoming/

Then, you could run the auto10.bat file at 10:00 PM each night using a scheduler.

Remember that if a file name has a space in it, you must enclose the entire command in quotes.

See also:

File Transfer Modes

Transferring a Folder with Subfolders


Transferring a Folder with Subfolders

Since you can’t create folders using the command line, you won’t be able to transfer a folder by simply specifying the folder name in the command line, or by using wildcards.

To transfer a folder using the command line, you’ll need to use some other method to create the folder and its subfolders in the destination location. Then, you can use the procedure described in Multiple Folders or Commands. In the text file, you’ll have one command line for each subfolder.

For example, let’s suppose you want to transfer the entire folder named Sports to the Damion FTP site. The Sports folder contains a number of files as well as three subfolders named News, Stats, and History.

Once you have created the Sports folder and its subfolders in the destination location, create the following text file named DirStruct.txt:

-p Damion -s local:c:\Sports\*.* -d Damion:/Sports/

-p Damion -s local:c:\News\*.* -d Damion:/Sports/News/

-p Damion -s local:c:\Sports\Stats\*.* -d Damion:/Sports/Stats

-p Damion -s local:c:\Sports\History\*.* -d Damion:/Sports/History/

The command you then enter (at the MS-DOS prompt or in a batch file) is:

ftp95pro -DirStruct.txt

See also:

File Transfer Modes


Converting File Names to Lower Case

When uploading files, you can have WS_FTP Pro convert file names to lower case by adding the -lower argument at the end of the command line. For example, if you want to transfer a file named Tag.doc from your PC to a folder named Drop on an FTP site named Damion, WS_FTP Pro can upload it as tag.doc. To do this, enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:Tag.doc -d Damion:/Drop/ -lower

•	Note: When you use the -lower argument, the argument must be at the very end of the command line.

See also:

Transferring Files with Spaces in the File Names


Transferring Files with Spaces in the File Names

If you are transferring a file whose name has spaces in it, you have three options. You can enclose the entire command line in quotes, use the MS-DOS name of the file, or you can do a wildcard transfer using asterisks.

Enclosing the command line in quotes. If the file you want to transfer from your PC to a server named Damion is named Tag Top.doc, enter (at the MS-DOS prompt or in a batch file):

“ftp95pro -p Damion -s local:c:\Tag Top.doc -d Damion:/Tag Top.doc”

Using the MS-DOS name. If the file you want to transfer is named Tag Top.doc in Windows 95, but appears as Tag~1.doc when you use the Dir command at the MS-DOS prompt, you can use the MS-DOS file name to transfer the file. To do this, enter (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Tag~1.doc -d Damion:/Tag~1.doc

This creates a file on the FTP site named Tag~1.doc.

Doing a wildcard transfer. If the file (with spaces in its file name) is the only file in its folder, you can use a wildcard transfer to retain the Windows name (with the spaces). So, if Tag Top.doc were the only file in the Sports folder on your hard disk, you could transfer the file to the Damion FTP site by entering (at the MS-DOS prompt or in a batch file):

ftp95pro -p Damion -s local:c:\Sports\*.* -d Damion:/

This creates a file named Tag Top.doc on the FTP site.


Using an IP Address, Host Name, or URL

Instead of using the name of a configured site in the command line, you can use an IP address, host name, or URL. Note, however, that when you do this, you will be logged on anonymously to the FTP site; you will not be logged on to an account, nor will you be prompted for a password. So, if you want to log on to an account, you must use the name of a configured site.

For example, suppose you have a configured site named Damion and that the host name of this site is ftp.Damion.com and its IP Address is 111.222.333.444. You can transfer files by omitting the -p (site name) argument shown as part of the basic command syntax, and, instead type the host name, IP Address, or URL in place of the site name. You could enter one of the following (at the MS-DOS prompt or in a batch file):

ftp95pro -s local:c:\Sports\Tag.doc -d ftp.Damion.com:/Drop/Tag.doc

ftp95pro -s local:c:\Sports\Tag.doc -d 111.222.333.444:/Drop/Tag.doc

ftp95pro -s local:c:\Sports\Tag.doc -d ftp://ftp.damion.com:/Drop/ Tag.doc

ftp95pro -s local:c:\Sports\Tag.doc -d ftp://damion:/Drop/Tag.doc

See also:

Using the Names of Configured Sites


Specifying Which .ini File to Use

The -i argument lets you specify the .ini file that the WS_FTP Pro command line will use. You need to use the -i argument to identify the WS_FTP Pro .ini file if:

•	You have more than one .ini file for WS_FTP Pro on the same computer

•	The .ini file you want to use is in a different folder than the WS_FTP Pro application

•	You are running a batch file and the WS_FTP Pro folder is not in your Path statement

For example, you might enter (at the MS-DOS prompt or in a batch file):

ftp95pro -i C:/Programs/WS_FTP/mywsftp.ini ftp95pro -p Damion
-s local:c:\Sports\Tag.doc -d Damion:/Drop/Tag.doc

Note: If you use the -i argument, it must be the very first argument following the ftp95pro command.


Extras

There are a few extra arguments and uses of the command line that some users have found helpful. These are listed below.

•	To have WS_FTP Pro display a dialog box that prompts you for the command line, type: ftp95pro -ask

•	To launch the WS_FTP Pro classic interface and default to the site configuration for the Damion site: ftp95pro -p Damion

•	To prevent WS_FTP Pro from displaying error messages, use the -quiet argument. This is useful if you want to do automated transfers when noone is around to repond to a message. An example:

ftp95pro -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/Tag.doc -quiet


Windows 3.1 Users

If you are running Windows 3.1, you can use the WS_FTP Pro command line by creating a Program Item and setting its properties to run a WS_FTP Pro command. When you double-click the icon, the command line runs.

1	In the Windows 3.1 File Manager, open the Program Group where you want to create the icon.

2	Select New from the File menu, and then select Program Item.

3	Select the icon and then set its properties. Use the basic command syntax to enter the command into the Command Line text box.

For example, to transfer a file named Tag.doc from your PC to a configured FTP site named Damion, you might enter the following for the Program Item Properties:

In the example above, the full contents of the Command Line text box are:

\wsftp\ftppro.exe -p Damion -s local:c:\Sports\Tag.doc -d Damion:/Drop/


Command Summary

Here is a list of all  arguments you can use in the command line. Note that the -i argument must precede the the -p argument when both are used, and  that both of these arguments must precede any other arguments.

Arguments (alphabetical)	When to use	Important restrictions
-ascii	Use -ascii when transferring text files.
-binary	Use -binary when transferring non-text files such as executable programs, word processing documents, and so on.
-c account	Use -c to work with servers that require an account for the user to log in, or to access partitions. account is the name of your account on the FTP server.
-d path_and_filename	Use -d to indicate the destination path and desired file name of the file you want to upload or download.
-i inifile	Use -i if you have more than one .ini file for WS_FTP Pro, the .ini file is in a directory other than that of WS_FTP Pro, or you are running a batch file and the WS_FTP Pro path is not in your Path statement. inifile is the path and name of the .ini file.	If you use the -i argument, it must precede all other arguments.
-lower	Use -lower to have WS_FTP Pro convert file names to lower case letters when you transfer from your local system to a remote FTP system.	If you use the -lower argument, it must be at the very end of the command line.
-m text_file	Use -m to do transfers that involve multiple source locations, multiple destinations, or multiple commands. text_file is the name of the file that contains the commands.
-p sitename	Use -p to connect to a configured site, where sitename is the name of the configured site. The configured site must be in the default .ini file or in the .ini file specified with the -i argument.	The -p argument must precede all arguments except -i.
-quiet	Use -quiet to prevent WS_FTP Pro from displaying message boxes.
-s path_and_filename	Use -s to indicate the source path and filename of the file you want to upload or download.
See also:

Extras