Introduction

The Find Utility, based on FTP, allows you to quickly search for files and folders on FTP sites, and then transfer the found files to your PC. The Find Utility is designed to work in conjunction with WS_FTP Pro: it provides easy access to the FTP sites you have already configured in WS_FTP Pro.

To find files, you first connect to an FTP site, and then enter search criteria. You can search by name, date modified, size, name and date, name and size, date and size, or all three (name + date + size).


Browse Dialog
Browse Dialog Box

If you’re not currently connected to a site, the Browse dialog box shows you a list of all the FTP sites you have configured in WS_FTP Pro. Select the site and folder you want to search.

If you are connected to a site, the Browse dialog box shows you the contents of the site, starting at the folder shown in the Look in box. Select the folder you want to search.


Specifying Where to Look
Specifying the FTP Site

The Look in box is where you specify which FTP site to search. The configured FTP sites in WS_FTP Pro are shown in the list.

Note: When you use a configured site, only the information on the General tab and Firewall tabs is used; other site properties are ignored, including Startup Folders and any Initialize Commands.

You can also connect to FTP sites you have not configured by simply entering the site’s host name or IP address. You will be connected as an anonymous user.

Entering the path. In the Look in text box, you can also enter the path you want to search. You can appended it to the site name by typing, or (once you have connected to the site) by using the Browse button.


Making the Connection

When you click OK in the Browse/Connect dialog box, the Find Utility attempts to connect you to the FTP site. Once the connection is made, you can use the Browse button to view folders starting at the current folder.

The connection to the FTP site lasts until:

•	You click the Disconnect button,

•	You quit the Find Utility, or

•	Your connection to the FTP site is interrupted by external circumstances (such as your modem becoming disconnected).

See also:

Retrying the Connection

Entering User ID and Password


Retrying the Connection

To have the Find Utility retry connecting to an FTP site if the first attempt fails,

1	Click the Advanced tab.

2	Enter the number of times to retry the connection in the Retry the Connection box.


User ID and Password
Entering User ID and Password

When you select a site name and click OK, you are connected to the FTP site by means of the User ID and Password stored with the configured site in WS_FTP Pro. If the user name or password is blank in WS_FTP Pro, you are prompted for the correct information.


Searching a Different FTP Site

To disconnect from the current FTP site, but save the search criteria to use on another site, click Disconnect.


Disconnecting from an FTP Site

To disconnect from the current FTP site, but use the search criteria on another FTP site, click Disconnect.

To disconnect from the current FTP site and clear the search criteria, click New Search.


Include Subfolders

To search all subfolders of the Look in location, select Include Subfolders.

If you want to search only the folder indicated in the Look in box, clear the Include Subfolders check box.


Overview of Criteria
Overview of Search Criteria

You can enter several types of search criteria. You can search by a single criterion such as name, date, or size. You can also combine search criteria by entering criteria on more than one tab; for example, you can search by:

•	Name and date

•	Name and size

•	Date and size

•	Name, date, and size


Searching by Name

If you know all or part of the name of the file (or folder) you want to find, click the Name & Location tab and type all or part of the name in the Named box. You can use wildcard characters such as * and ?

If you leave the Named box blank, the search will find all files in the Look in location.

If you don’t know the name of a file, search by date or size.


Searching by Date Modified

If you know the exact or approximate date of the file (or folder) you want to find,

1	Click the Date Modified tab.

2	Click the Find all files created or modified button.

3	Select the appropriate range of dates.

•	Between. Select this option to search for files that were created between the beginning and end dates.

•	During the previous x months. Select this option to search for files that were created within a certain number of months.

•	During the previous x days. Select this option to search for files that were created within a certain number of days.


Searching by Size

When searching for files, you can specify a minimum or maximum file size. However, you can’t search for folders by size, since folder size is always zero, even if the folder is not empty.

1	Click the Advanced tab.

2	Do one of the following:

•	In the Size box, select At least to search for a minimum file size or At most to search for a maximum file size. Then, indicate the minimum or maximum size of the files you want to find.

For example, if you select At Least in the Size box and enter 50 in the KB box, the Find Utility looks for all files that are 50K or larger.

•	To disregard file size in the search, make sure that [blank] is selected in the Size box.


Clearing Search Criteria

To clear the search criteria, click New Search.


Transferring Files and Folders

The Transfer button displays a dialog box in which you can select the location to which you want to transfer the selected files in the list of found files.

1	In the list of found files, select the files (and folders) you want to transfer.

2	Select the desired transfer mode from the Options menu.

3	Do one of the following:

•	Double-click the file or folder.

•	Click the Transfer button to enter the location to which you want to transfer.

•	Drag the selected files to the desired location.


Deleting a File

You can delete a file in the list of found files (if you have permission to delete files from that site).

To delete a file, select it and then select Delete from the right mouse menu.


Renaming a File

Once the Find Utility displays a list of found files, you can rename a file in the list (if you have permission to rename files on the current FTP site).

To rename a file, select it and then select Rename from the right mouse menu.


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	Select the site.

2	Select New folder from the right mouse menu.

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

4	Drag sites and folders around using standard Windows techniques.


Starting the Search

Once you’ve entered your search criteria on one or more tabs, click Find Now.


Transfer Mode

Select the desired transfer mode from the Options menu. Files can be transferred in ASCII, binary, or "Auto" mode.

A file that appears to be text, postscript, or other ASCII format should be transferred in ASCII mode.

•	Note: Transferring a binary file in ASCII format can damage the file.

A file that appears to be data, an executable, or compressed should be transferred in binary mode. (Binary mode should also be used if there is no file extension or the file extension is not registered.

Auto mode means that the extension is checked against the list of ASCII files on the Extensions tab in WS_FTP Pro. If the extension is listed, ASCII mode is used; if not, binary mode is used.


Session Tab

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, enter 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.

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 on a VM/CMS host you are prompted each time for the password to connect to that folder.)


Firewall Tab

To enter 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 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.


Named field
Named

If you know all or part of the name of the file (or folder) you want to find, enter all or part of the name in the Named box. If you leave the Named box blank, the search will find all files in the Look in location.


Look in Field
Look in:

The Look in box is where you specify which FTP site to search. If you have configured FTP sites in WS_FTP Pro, you can choose a site from the list.

If you want to search an FTP site for which you don’t have a profile, you can type a URL or IP address.

Entering the path. In the same place you enter the site name (or URL), you can also enter the path you want to search. You can type it, appended it to the site name?

For example, the Look in box might show ftp://Ipswitch/pub/beta, where Ipswitch is the name of the FTP site, and /pub/beta is the path you want to search. In other words, you want to search only in a folder named beta which is located inside a folder named pub on the Ipswitch FTP site.


Browse Button
Browse

Once you connect to a site, you can then use the Browse button to locate and choose a folder to search. The folders are displayed starting at the folder shown in the Look in box.


Find Now

Click here once you have connected to a site and entered your search criteria on one or more tabs.


Cancel Button

Press the Stop button to cancel a search that is in progress.


Results list
List of Found Files and Folders

The list of found files is displayed when files and folders meeting your criteria have been found. You can sort the list in ascending or descending order by clicking the column headings.

You can:

•	Transfer a file or folder

•	Rename a file or folder

•	Delete a file or folder


Name and Location Tab
Name & Location Tab

The Name & Location tab lets you specify where you want to look, and for what file name.

Named

Look in

Browse

Include Subfolders

Find Now

Cancel

New Search

Transfer

Disconnect


Date Modified_Tab
Date Modified Tab

This tab lets you search for files that were created between the dates you specify.

1	Click the Date Modified tab.

2	Do one of the following:

•	To search for files (or folders) created or modified during a specific time period, click the Find all files created or modified button and then select the appropriate range of dates.

Between. Select this option to search for files that were created between the beginning and end dates.

During the previous x months. Select this option to search for files that were created within a certain number of months.

During the previous x days. Select this option to search for files that were created within a certain number of days.

•	To disregard dates in the search, select All Files.


Advanced Tab

The Advanced tab allows you to do two things: specify a file size and/or indicate the number of times you want to retry to connect to a site.

1	If you are searching for a file, do one of the following:

In the Size box, select At least to search for a minimum file size or At most to search for a maximum file size. Then, indicate the minimum or maximum size of the files you want to find. For example, if you select At Least in the Size box and enter 50 in the KB box, the Find Utility looks for all files that are 50K or larger.

To disregard file size in the search, make sure that [blank] is selected in the Size box.

2	To have the Find Utility retry connecting to an FTP site if the first attempt fails, enter the number of times to retry the connection in the Retry the Connection box.

Note: You can’t use Size to search for a folder, since all folder have a size of zero, even if they’re not empty.


WS_FTP Pro General Tab

Contains the following site properties: Profile Name, Host Name/Address, Host Type, User ID, Password, and Account.


WS_FTP Pro Advanced Tab

Contains the following site properties: Connection Retry, Network Timeout, Remote Port, and the Passive Transfers check box.


WS_FTP Pro Startup Tab

Contains the following site properties: Initial Remote Host Directory, Initial Local Directory, Initialize Command, Local file mask, Remote file mask, and Time offset in hours.


WS_FTP Pro Firewall Tab

Contains the following Firewall properties: Host Name, User ID, Password, Port, and Firewall Type.


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.


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.


ASCII_def
ASCII

ASCII (American Standard Code for Information Interchange). 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 for non-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.)


Overwrite

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


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 Internet 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 use Winsock 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 your PC establish the data connection.


Host Name/Address

In WS_FTP Pro, you can use either the host name or the IP address to specify a particular system.

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.

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.


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.

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

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

In the WS_FTP Pro classic and Explorer interfaces (but not in the Find Utility), you can configure new sites. See Configuring a New Site in the Help Table of Contents.


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 78 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, enter 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 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.


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

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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."


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 log to see if the Host Type is identified there. Then, select the corresponding host type from the drop-down list on the General Tab of the site properties.


Directory Display Problems
No Directory Listing

If you can connect to an FTP site but don't get a directory 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 <ftpdir@ipswitch.com>

If the FTP site is not available via anonymous FTP,

1	Go to the General tab of Program Options 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 <ftpdir@ipswitch.com> along with as much of a description of the FTP site as possible.


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

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the General tab.

4	Do one of the following:

•	(Recommended) To log in as an anonymous user, select Anonymous.

•	If you have an account on the site, make sure Anonymous is not selected, and then enter User ID, Password, and Account (if applicable).

Note: Do not check Save Password unless no one else has access to your WS_FTP folder!


CONNECT - Startup Parameters
Site Properties, Startup Tab

Remote Site Folder. 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.

Local Folder. 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.


Changing the Location You View on an FTP Site

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Startup tab.

4	In the Remote Site 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	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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 Local file mask and/or Remote file mask text box. For example, to display only text files, enter *.txt.

To display all files on a UNIX 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

You can have the application 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 the application adjust a date and time of 11/10/97 1:00 AM to 11/9/97 10:00 PM.

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

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).


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 the application 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.


Retrying a Connection

The application can try again to make a connection to an FTP server if the initial connection attempt fails. Use the Connection Retry option on the Advanced tab of Site Properties to enter the number of times the application tries again.


Setting the Network Timeout

The network timeout is the number of seconds that elapses before the application stops waiting for an FTP site to respond. Normally, the network timeout is determined by your Winsock DLL. You can set it to less time than your Winsock DLL, but setting it higher won't affect anything.

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Advanced tab.

4	Enter the number of seconds for the Network Timeout. The value may be from 5 to 120 seconds.


Changing the remote port for a site
Changing the Remote Port for an FTP Site

The remote port for an FTP site is normally 21, however, it may be something different if you are going through a firewall, or if the FTP site administrator has assigned the FTP protocol to another port.

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Advanced tab.

4	Enter the Remote Port number.


Doing Passive Transfers

Some FTP sites allow passive transfers. Select this option if transfers are erratic, you keep getting failed data channel errors, or your PC is behind a router-based firewall or gateway requiring passive transfers.

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Advanced tab.

4	Select 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 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.


CONNECT - Session Parameters
Site Properties, Session Tab

Prompt for Destination File Names

Force Lowercase Remote Names

Show Transfer Progress Dialog

Verify Deletions

Prompt for overwrite of same or newer files

Enable auto reget of failed transfers

Preserve file time on transfer from remote


Getting path filename prompt on a particular site
Getting Prompted for Path and File Name

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Prompt for destination name.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Converting filenames from one site to lower case
Converting File Names to Lower Case

Some sites require file names that use all lower case letters. You can convert file names to all lower case as you transfer them. To do so,

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Force lowercase remote names.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Monitoring the Progress of a Transfer

To display a status indicator showing the progress of a transfer to or from a particular FTP site:

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Show transfer progress dialog.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Getting a Confirmation Before You Delete a File

To get a confirmation before you delete a file from a particular FTP site:

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Verify deletions.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Getting an Alert Before You Overwrite a File

To get an alert when you are about to overwrite a file during a transfer to or from a particular FTP site:

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Prompt for overwrite of same or newer files.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Resuming Failed or Interrupted Transfers

Some FTP sites allows clients to resume (or re-get) failed or interrupted transfers. To take advantage of this option, you can turn on Automatic re-get of failed transfers. Then, the next time you get a failed transfer, the application will try to resume the transfer when you reconnect to the site.

To specify that the application tries to resume future interrupted transfers:

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Enable auto re-get of failed transfers.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.


Updating date and time
Preserving or updating file date and time on downloads

By default, when you transfer a file, the file date and time are updated to the date and time of the transfer. You can change this for downloads, so that the file date and time stay the same as on the FTP site. Note that you cannot retain the file date and time on uploads.

1	Select the site.

2	Do one of the following:

In the Classic interface, click Properties.

In the Explorer interface, select Site Properties from the File menu.

In the Find Utility, select Properties from the right mouse menu.

3	Click the Session tab.

4	Select Preserve file time on transfer from remote.

Note: In WS_FTP Pro (classic and Explorer), you can also set this property for a folder in which sites are stored, or as the program default.