Copyright: Teleport Pro Help, (c) 1996 Tennyson Maxwell.  All Rights Reserved.


teleport pro™

 Introducing Teleport Pro

 Getting Started

 How to...

 Project Properties

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

To surf is human, to Teleport divine…

Using Teleport Pro

How Teleport Pro explores

 Getting Started

 How to...

 Project Properties

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

 Getting Started

Tutorial:  Overview

Tutorial:  Creating a New Project

Tutorial:  Saving the Project

Tutorial:  Running the Project

Tutorial:  Viewing the Results

Other sample projects

 How to...

 Project Properties

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

 Getting Started

 How to...

Start a new project

Use the New Project Wizard

Open an existing project

Offline browse a website

Specify file types for retrieval

Exclude certain domains from a search

Pause a running project

Use the Thread Bar

Open an Internet Marauder Project

Add more starting addresses to a project

Use the Retrieve Now command

Open or view a retrieved file

Deleting addresses or files from a project

Determine where a file came from

Access password protected sites

 Project Properties

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

 Getting Started

 How to...

 Project Properties

The Summary Page

Retrieval Settings

Exploration Settings

Keywords and domain exclusions

Project Scheduling

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

 Getting Started

 How to...

 Project Properties

 Registration and Technical Support


teleport pro™

 Introducing Teleport Pro

 Getting Started

 How to...

 Project Properties

 Registration and Technical Support

Benefits of registration

How to register

Site licenses and volume discounts

Copyright, Trademark, and License Information

How to contact Tennyson Maxwell


To surf is human, to Teleport divine…

Congratulations!  You have obtained the most powerful offline browsing and file-retrieving tool on the Internet.

Part Swiss Army knife, part chainsaw, Teleport Pro is a fully automated, multithreaded, link-following, file-retrieving webspider.  It will retrieve all the files you want — and only the files you want — from any part of the Internet.  Teleport Pro can also

Completely download a website, enabling you to “offline browse” the site at much greater speeds than if you were to browse the site online

Create an exact duplicate, or “mirror” of a website, complete with subdirectory structure and all required files

Search a website for files of a certain type (and even size!)

Download a list of files from the Internet

Explore every website linked from a central website

Search a website for keywords

Make a list of all pages and files on a website

Want to offline browse a website?  Want to grab 400 sound files for a multimedia presentation?  Looking for just the right background graphic?  A list of every web page and file on a shareware site?  Found a huge archive of great graphics -- but don’t want to wait for each of them to download?  Found a great link site, but don’t have the time to check out every link?

No more waiting for slow pages to download.  No more clicking on links for hours, only to find garbage at the end of your trail.

Tell me how to use Teleport Pro

Let’s get started


Using Teleport Pro

To use Teleport Pro, you create a project file that contains one or more addresses to files on the Internet.  You also give Teleport Pro some rules that define what links it will follow and what files it will retrieve.  You then send the spider on its mission by selecting the Start command on the File menu, or by pressing the Start button on the toolbar.

Once activated, the Teleport spider will read your project's starting addresses and retrieve any files that it finds there.  It then reads all of  the links on that page, follows those links, gets the files on those pages, and so on, and so on, and so on...  until it runs out of places to go.

You can tell Teleport Pro to retrieve only certain types of files, and to follow only certain types of links.  For example, you may direct it to retrieve only jpg and gif files, the usual types of graphics files on the World Wide Web.  You may also direct it to follow only links within the same domain as the starting address, or not to follow any links at all!  Your "program" for the spider's behavior will determine how far it goes, how long it takes, and what types of files it will get.

The Teleport spider is extremely flexible!  It has many customizable exploration parameters for specifying which types links to follow and which types of files to retrieve.  Most of the time, however, you can let the New Project Wizard set up your project’s exploration parameters for you.  The New Project Wizard will usually choose the best parameters for most common Teleport tasks.

Tell me more about how Teleport Pro explores

Let’s get started


How Teleport Pro Explores

Teleport Pro uses a special search algorithm to rapidly search web pages, identify and classify their links, and then retrieve all files matching the file types you specify in the Project Properties sheet.

Teleport Pro starts at the project's first starting address.  The Teleport spider examines the page carefully, extracting all of its links and all of its references to embedded data.

If you have set file type specifications, Teleport Pro then retrieves every file linked from that page, or embedded in it, that matches your requested file types.  If you have not specified any types, Teleport Pro simply retrieves every file.  Each retrieved file is stored in the project subdirectory, which is always named after your project.

The Teleport spider then categorizes the page's links to other pages.  If a link points to a page beyond the project's Exploration Depth, or if it points to a page in an excluded domain, it is discarded.  The spider then visits the remaining pages in turn; examines them for links and files; retrieves their files; categorizes their links… and so on.

If your project has more than one starting address, the Teleport spider will repeat the process above for each starting address.

As the Teleport spider explores each new page, it inserts the page's address into the Project Map.  You can click on any page in the Project Map to select it.  The files retrieved for that page will appear in the File List.

If your project directs the Teleport spider to follow links to external domains, the first link into each external domain is represented in the Project Map as a gateway page.  Gateway pages control the spider's access into the external domain.  For this reason, other pages in the external domain are listed below the gateway page, and not below the starting address.

Important:  The Teleport spider remembers everywhere it has been!  This means it will never visit the same place twice, within the same project session.  You can also prevent the Teleport spider from ever revisiting an address, by disabling it.

Important:  The Teleport spider remembers everything it retrieves!  This means it will never retrieve the same file twice.  You can, however, force the Teleport spider to retrieve files again  by using the Retrieve Now command.


Address Properties

The Teleport Pro spider remembers the address of every file or html page that it reads.  Each stored address also has an enable/disable flag that tells Teleport Pro whether it should explore that address again, when it becomes out-of-date.  You can view the address properties, and change the enable/disable flag, by using the Properties command from the file context menu or by using the Properties command on the Address menu.

Note:  When a page in the Project Map is disabled, all pages and files linked from that page are also disabled.  This allows you to disable an entire domain, for example, by disabling its gateway page.


Offline Browsing

You can use Teleport Pro to create a local copy of a complete website on your hard drive, allowing you to “offline browse” the site later at much greater speeds than if you were to browse the site online.

The easiest way to offline browse a site is to create a new project using the New Project Wizard, and select the first type of project, “Create a browsable copy of a website on my hard drive.”  The New Project Wizard will ask you for the starting address of the website, and then whether you want to copy only text (html) files, or also graphics and sound files.  When you’ve finished creating and saving the new project, just press the Start button on the toolbar to run the project.

When the project is complete, open the first web page by right-clicking it in the Project Map to display the file context menu, then select the Open command.  Teleport Pro will open the page in your default browser, and you can then browse the site offline.


Opening and Viewing Retrieved Files

You can open or view files using their default application double-clicking them in the File List.  You can also right-clicking files in either the Project Map or the File List to display the file context menu, then select the Open command.


New Project Wizard

The New Project Wizard is designed to create Teleport Pro projects for most common automated Internet tasks.  With just a few simple questions, the Wizard can fashion for you a project that will, in most cases, do exactly what you need.

The Wizard’s first page describes the six categories of projects it can handle:

Create a browsable copy of a website on my hard drive will create a “flat” copy of a website’s files on your hard drive, with all of the necessary files for the website located in the project folder.  Generally, when all you require is a browsable, offline copy of a website, this is the simplest and quickest project type to select.  The project will initially contain one Starting Address (though you may of course add more later), and the spider will be instructed to stay within the path of that address when exploring.  Note that because all of the files will be stored in a single folder on your hard drive, Teleport Pro may rename some of them to avoid filename collisions.

Duplicate a website, including directory structure is used for “site mirroring” and will create a “tiered” copy of a website’s files on your hard drive, where every file is stored in a subfolder of your project’s main folder, mirroring its storage location on the remote server.  Use this project type if you would like to ensure that the filenames Teleport Pro uses are identical to those on the remote server, or if you just want to see or use its directory structure.  (When creating a “flat” copy of a website, as noted above, Teleport Pro may rename some files to avoid filename collisions.)

Search a website for files of a certain type is the project type of choice when you’re hunting for graphics files, background images, sound files, or even ZIP files or programs!  This option creates a project that starts at a single Starting Address, then explores outward within the path of that address, looking for files of a certain type.  It will not create a browsable copy of the website, but if you don’t want web pages, this type of project will run faster and fill your disk with only the types of files that you want.

Explore every site linked from a central site is the ideal project type if you want to just get an idea for what types of files are contained in several sites that are linked from a “link page” or “link site,” such as the Netscape What’s Cool list or a Top 100 Websites list.  This project does not retrieve files; it only retrieves their names, but it stores them in the File List as if they were files.  This type of project explores very rapidly because it does not need to write any files to disk.  You can easily change this, however, once you’ve determined that one or more of the sites it’s explored have something you want.  You can use the Retrieve Now function to grab individual files, or disable the “Retrieve only file names” option on the Project Properties Retrieval page, and rerun the project.

Retrieve one or more files at known addresses is convenient if you have a list of addresses you would like to poll for data, or if you’d like to just download a set of files.  The Wizard will display a multiline text box in which you can enter (or paste) a list of addresses, one per line.  The Wizard will then create a project containing each of these addresses as a Starting Address.  The spider will be instructed to explore only the starting address page, so it will not follow any links away from the pages or files you specify.

Search a website for keywords will create a project that is identical to Create a browsable copy of a website on my hard drive (above), except that every web page the spider encounters will be tested to see if it contains any one or more of a set of keywords.  Web pages, and any files embedded in them, will be retrieved only if they contain your keywords.


Tutorial:  Overview

This tutorial will show you step-by-step how to create and run a Teleport Pro project.  The Internet site used for this tutorial hosts a collection of JPEG-encoded celebrity photographs.

Note:  The site used for this tutorial was active as of 07/15/96.  If the site has moved or is down, running this sample project will not retrieve any files.  If this occurs, try using one of the other sample projects packaged with this copy of Teleport Pro, or visit our web site at www.tenmax.com for more sample projects.

There are five essential steps to creating and running a Teleport Pro project:

1	Create a new project

2	Save the project

3	Run the project

4	View the results


Tutorial:  Creating a New Project

To create a new project, select New Project Wizard from the File menu, or press the New Project Wizard button on the toolbar.  (Experienced users can also start a new project with the blank New Project button, but then you will have to set your Project Properties manually.)  The New Project Wizard will ask you a series of questions to determine what you would like to do, and then create a project for you that will do it.

Page 1:  Six of the most common Teleport Pro tasks are presented in the Wizard’s first page.

For this tutorial, choose “Search a website for files of a certain type.”

Page 2:  The Wizard will next ask you to enter the Starting Address for this project.  The Starting Address is the first place Teleport Pro will begin looking for files.  It will then follow links away from the Starting Address, retrieving files as it goes, until it has exhausted all possible links.

For this tutorial, the starting address is

www.sirinet.net/~sandram/mtvfem.htm

Note that Internet addresses are case-sensitive.  Be sure that the address you type is exactly correct.  A mistyped letter or punctuation mark will invalidate the address.  Copying and pasting an address out of your browser is a good way to ensure you have a valid address.  If Teleport Pro doesn't retrieve any files or follow any links for your starting address, an invalid address is the most common reason.

You can also give your starting address an optional title.

Page 3:  The Wizard will now ask you some basic questions about what you want your project to do.  When you want to “search a website for files of a certain type,” the Wizard will ask you what types of files you want to look for.

For this tutorial, press the Add button to add a file type specification, and add “Graphics” files.

When you finally press the Next button to confirm your answers to the Wizard’s questions, the Wizard will create a fully configured project for you.

Page 4:  You must now press the Finish button to display the Save As dialog box, and save the project.


Tutorial:  Saving the Project

If you are using the New Project Wizard, the Save As dialog box will now be displayed for you.  If you are not using the Wizard, you must select Save Project from the File Menu, or press the Save Project button on the toolbar.  Teleport Pro will then display the Save As dialog box.

Enter the name of your project in the File name box.  You may use the list box and buttons at the top of the box to move into folder where your project will be saved.

For this tutorial, enter Faces into the File name box, then click the Save button to confirm the project name and close the Save As dialog box.

Note:  Teleport Pro will create a subdirectory named after your project in which to store the files it retrieves.

After you have saved the project, you may run it.


Tutorial:  Running the Project

There are two ways to run your project:  Starting it, and Refreshing it.  When you Start a project, Teleport Pro begins looking only for new files that is hasn’t already seen.  When you Refresh a project, Teleport Pro first looks for new files (just like Start) but then it attempts also to bring any old files up to date.

Note:  When Refreshing a project, Teleport Pro will overwrite old files with new ones, automatically.  If you want to keep your old files, move or copy them to another folder first.

To run your project, select Start or Refresh from the File menu, or press the Start or Refresh buttons on the toolbar.

Teleport Pro will then build an internal queue of files it wants, usually beginning with the project’s first Starting Address.  The spider will then connect to the Internet and then begin retrieving files.  See How Teleport Pro Explores for more details on its search process.

As the spider works, the Thread Bar indicators will light up to tell you what stage each thread is in.

At this point, you may minimize the program window, and simply let it run in the background.

Tip:  You might like to observe the tutorial project as it runs.  The Faces project will typically retrieve about 60 files, totalling about 450 kilobytes.  On a 28.8 modem, this takes about 5 minutes.

After the project has run (and also while it's running), you can view the results in the project window.


Tutorial:  Viewing the Results

The left-hand pane of the project window is the Project Map.  Here, Teleport Pro shows you the pages it has explored for the project.  The right hand pane of the project window is the File List.  Here, Teleport Pro shows you the files retrieved at each page of the project.

You may view retrieved files as a list of filenames, or as a report containing full file details.  Use the view type buttons on the toolbar to switch between the two view types.

The retrieved files themselves are stored in the project folder,which is created by Teleport Pro the first time the project is saved, and is given the same name as the project.  By default, the folder is stored in the same folder as the project file (which is, by default, in the same folder as the Teleport Pro program files).

You can right click on any file in either the Project Map or the File List to get a context menu which allows you to open files using their default viewer, or delete them (sending them to the Windows 95 Recycle Bin).


Other Sample Projects

To help you get started teleporting, we've included some sample projects with this copy of Teleport Pro.  We encourage you to examine them, modify them, and run them, to learn more about using Teleport Pro, and how it can save you time and money when looking for files.

Open the sample projects using the Open Project command on the File menu.  The sample project files are located in the "Projects" folder.


Retrieval Settings

The Project Properties File Retrieval Page lists a number of options that allow you to specify what types and sizes the Teleport spider will retrieve, where it will store them, and whether it will modify them for offline browsing.  Click on the Project Properties button on the toolbar, or select Properties from the Project menu, to bring up the Project Properties sheet.  Select the File Retrieval tab to display that page.

Retrieval Types

You can tell Teleport Pro to retrieve all files (up to a specified maximum size — this prevents it from trying to download really HUGE files, unless you really want it to), or only files of a specified type and size.  When you select Retrieval by Type and Size, use the Add, Edit, and Delete buttons to set the Retrieval Types list.

User Defined Types

The Add button menu has a preset list of the most common file types found on the Internet. You can also create your own file type categories, by adding a “User Defined” file specification.  Teleport Pro will display the Edit File Types dialog box.  Enter a short description for your new category, and then a list of DOS-style filename patterns separated by semicolons.  There are two wildcard characters used in DOS-style filename patterns:

An asterisk ( * ) matches zero or more of any characters.  For example, the filename pattern *.cgi matches any filename having the cgi extension, such as test.cgi, but not test.cgid..  The filename pattern bob*.* matches any filename beginning with bob, such as boba.jpg or bob.gif or even bob or bobble.

A question mark ( ? ) matches any single character.  For example, the filename pattern star???.jpg matches any filename beginning with star and having three more letters, and then the extension jpg.  This would match star005.jpg or starting.jpg, but not star.jpg or starry.jpg.

You can also specify file size ranges (in kilobytes).  This is often a good method of ensuring that Teleport only retrieves, for example, high quality graphics files — just set the minimum file size at 16k.  Or, if you want to get only basic embedded graphics but not large image files, set the maximum file size to 8k.

Retrieval Modes

Retrieve Linked Files tells the Teleport spider that it may get files that are linked to a page, but do not necessarily appear (as graphics, for example) on that page.  Most of the time you will want this option turned on.

Retrieve Embedded Files tells the Teleport spider to get files that are embedded on web pages— that is, graphics or video files that appear as part of the page.  You will usually want this option on, but if you are looking only for large files you may wish to turn it off.

Retrieve Background Files tells the Teleport spider to get embedded graphics and sound files that appear in the “background” of a web page.

Retrieve Names Only tells the Teleport spider NOT to get the actual file, but only to determine if it meets your other retrieval specifications, and, if so, to place its name in the File List.  When this option is on, Teleport will appear to work very quickly, because it is not actually retrieving files (except that it can still retrieve and save HTML files, see below).  You will not be able to open the files it lists in the File List — but you can use the Retrieve Now command on the file context menu to retrieve them later.  This is usually a good option for rapidly exploring a large area of the Internet.

Offline Browsing/Site Mirroring

Always Save HTML pages tells the Teleport spider to save HTML pages, even if your other retrieval specifications don’t call for it.  If you want to offline browse a site, you should enable this option.

Localize links causes the links in saved HTML pages to be “localized,” or altered to point to files in your project folder.  If you want to offline browse a site, you should enable this option.

Preserve directory structure causes all files to be saved in a directory tree that looks like the directory structure on the remote website.  This is a very useful option if you are “mirroring” a website, because it allows you to make an exact duplicate of it.  When this option is off, all of your files will be stored “flat” in the Project folder — and some files may be renamed to avoid naming conflicts.


Exploration Settings

The Project Properties Exploration Page lists a number of options that allow you to control how the Teleport spider explores and how it asks for information.  Most of the time you will not want to alter these settings.  Advanced users, however, may find them useful.  Click on the Project Properties button on the toolbar, or select Properties from the Project menu, to bring up the Project Properties sheet.  Select the Exploration tab to display that page.

Domain Dispersed Querying™ is an important option that, when enabled, causes the Teleport spider to spread simultaneous requests as far apart as possible.  This enables each retrieval thread to work to its fullest potential, because if one server is slow in responding, other retrieval threads will be connecting to different servers and will not be affected.  Domain Dispersed Querying™ can often boost your overall throughput by 20% to 50%, when Teleport Pro has to visit more than one domain simultaneously.

Server Overload Protection™ is another important option that, when enabled, prevents Teleport Pro from overloading intermediate webservers.  Because Teleport Pro can launch multiple retrieval threads, it can sometimes ask for more data than your modem connection can handle!  Server Overload Protection™ slows down Teleport’s requests whenever a dangerous amount of data is already being transmitted.  When this option is turned off, you risk losing data and receiving corrupted files.

Link Exploration

Explore client-side image maps lets the Teleport spider travel through client-side image maps.  These are the most common types of image maps (links hidden inside graphic images) on the Internet.  Default:  On.

Explore server-side image maps tells the Teleport spider to “ping” server-side image maps to find their links.  Note:  This feature is not yet implemented.  Default:  Off.

Explore frames lets the Teleport spider explore frame links, such as those read by Netscape Navigator (and now Microsoft Internet Explorer).  Default:  On.

Explore forms tells the Teleport spider to query forms as if it were the user.  Because Teleport can’t know your answer to most forms questions, exploring forms is usually ineffective except for simple forms that are composed of only push buttons.  Default:  On.

Agent Identity:  Browsers, webspiders, and other Internet client programs can broadcast their identity when making requests for files.  Sometimes a remote server will look at the agent identity to determine what type of data to send it — or whether to send it data at all.  For example, some websites will not send frame links to the Microsoft Internet Explorer 2.0, which is not capable of reading frame links.  Although Teleport Pro defaults to broadcasting its true identity, you may wish to change its identity if a site appears to be unresponsive to Teleporting, yet works with your browser.

Anonymous broadcasts no identity at all.

Teleport Pro broadcasts the string “Teleport-Pro/Version #.”

Impersonate Microsoft will cause Teleport to identify itself as a Microsoft Internet Explorer browser.

Impersonate Netscape will cause Teleport to identify itself as a Netscape Navigator browser.

Tenacity controls how aggressively Teleport asks for information.

Launch ___ retrieval threads tells Teleport Pro how many simultaneous data requests it can make.  Default:  10.  Note that Server Overload Protection™ may sometimes reduce the number of simultaneous data requests to avoid overloading remote servers.

Retry denied requests ___ times tells the Teleport spider to re-query a server for files when the server denies a request because it is too busy.  During high traffic times, some servers may issue a curt “unavailable” response.  You can usually get such a file with your browser by repeatedly pressing the Refresh or Reload button.  Teleport does this for you automatically, really fast, until it gets the file or it exceeds the number you set here.  Default:  5.

Refreshing controls how the Refresh command prioritizes files.

Refresh if ___ days old tells the Teleport spider not to bother updating files unless they are older than a certain number of days.  This allows you to keep a project up to date efficiently, without having Teleport re-query every file if it hasn’t aged a certain amount.  This number defaults to zero because the refresh time for most small projects is very small.  If you have a large project, however, that spans several days of teleporting, you may wish to set this number at five days or more.

Refresh oldest/richest links first tells Teleport to prioritize files by age, or by the number of links they contain (if the file is a web page).  Default:  Oldest.

Retry bad or unavailable links tells Teleport to re-query files that were previously reported as unavailable by the remote server.  Most of the time the server is right and the files don’t exist or the address is wrong.  But sometimes a file will reappear.  Default:  Off.


Keywords and Domain Exclusions

To set your project's keywords or domain exclusions, press the Project Properties button on the toolbar, or select the Properties command from the Project menu.  Teleport Pro will display the Project Properties sheet.  Select the Exclusions tab.

Keyword exclusions allow you to specify a list of keywords which a web page must contain before its links are followed or its files are retrieved. Enter any keywords that pages must contain in the first text box, separated by commas.  You must check the box above the keywords list to enable keyword exclusions.  Once enabled, the Teleport spider will ignore web pages that do not contain any one of the keywords.

Note:  Teleport Pro will find keywords even if they are hidden inside HTML codes or comments.  This means that if you are using Teleport Pro to retrieve the HTML pages themselves, you may not find your keywords in the “visible” text of the page, if you view it with your browser.

Domain exclusions allow you to specify a list of domains that are off-limits for the spider.  A list of excluded domains appears in the checklist box at the bottom of the Exclusions page.  Teleport Pro contains a default list of common domains that are usually not of interest for general purpose file retrieval, and which are often linked from web pages.  You may edit any of the default exclusion domains, and add your own to the end of the list, simply by clicking one of the list entries and pressing the Edit button.


Adding Starting Addresses

Your project can have more than one Starting Address.  To add more starting addresses, press the New Starting Address button on the toolbar, or choose the New Starting Address command from the Project menu.  Teleport Pro will display a blank Starting Address Properties dialog box, where you can enter the item’s url and other information.


Using the Thread Bar

The Thread Bar is a row of button indicators that is usually to the right of the main toolbar.  The Thread Bar buttons will light up different colors (or become pie charts) to indicate what state each retrieval thread is in.  The different indicator colors and shapes are:

You can hover over any button on the Thread Bar to display the thread’s exact state.  You can also press any Thread Bar button to get a small menu that allows you to abort that thread’s activity at any time.  When you abort a thread during file retrieval, it may take a while for the thread to release its data and return to the idle state.

Like the main application toolbar, the Thread Bar can be moved, resized, floated, and docked along any edge of the Teleport Pro window.


Opening an Internet Marauder Project

You an open an Internet Marauder project from within Teleport Pro, using the Open Project command under the File menu.  Just select “Internet Marauder Project” in the “Files of Type” combo box in the Open Project dialog when it appears, and select the .IMP file you want to open.

Note:  Teleport Pro will convert the Internet Marauder project to a Teleport Pro project when it is opened.  Because Internet Marauder projects do not contain as complete a project database as Teleport Pro, some of the old project information may not translate completely.  In addition, you must use the Refresh command when running the new project for the first time.

Caution:  When you save the project again, Teleport Pro will save it as a Teleport Pro project — making it unusable in Internet Marauder.  If you wish to keep your old Internet Marauder project intact, use the Save As command under the File menu to save the project under a new name, first.


Starting Address Properties

The Starting Address Properties dialog box lets you set a number of parameters for each Starting Address in your project.  You can display the Starting Address Properties dialog box by right-clicking on a starting address in the Project Map, then selecting Properties from the file context menu.

URL is the Internet address for this item.  When you are adding a new starting address, this field will be blank, allowing you to enter the address.  Once the address is entered, however, and the dialog box closed, you can no longer edit the address directly.  This is to preserve the integrity of the project database.

Title is an optional title you may assign to a starting address.

Exploration Depth controls how far away from that address the Teleport spider can follow links.  Please note that Exploration Depth has no effect on file retrieval -- Teleport Pro will retrieve files linked from a page no matter how far away the files are located.  Exploration Depth only affects the spider's link-following algorithm.  It has four settings:

Explore only this address tells Teleport Pro not to follow any links away from this page.  If all of the files you want are embedded in or linked from this page, this is the most efficient exploration setting.

Stay within path directs the Teleport spider to follow links only to addresses that are within the path of the address.  The path of an address is its domain plus any local subdirectories.  Example:  For the starting address www.tenmax.com/news/index.html, Teleport Pro will follow links to any page whose address begins with www.tenmax.com/news.

Stay within domain tells Teleport Pro to follow links only to addresses that are in the same domain as the starting address.  Example:  For the starting address www.tenmax.com/index.html, Teleport Pro will follow links to any page whose address begins with www.tenmax.com.

Follow external links one level allows Teleport Pro to go beyond the domain of the starting address.  This setting is most useful for "link sites," web pages that contain lists of links to other web pages with similar content.  In this mode, Teleport Pro will follow links to any page linked from within the starting domain.  Once inside an external domain, Teleport Pro will change into its "stay within path" mode and explore all pages within the path of the external link.  When it has finished exploring the external site, it will return to the starting domain and continue following links, possibly into other external domains.

Be careful!  When following external links the Teleport spider can travel very far.  It can also stay out a long time, and bring back megabytes, even gigabytes of files.  Unless the number of external domains linked from the starting domain is small (less than 20), projects that allow external exploration will usually require more than a day to complete.

The Authentication block allows you to specify any account name and password that may be required to access this site.


Project Summary Page

The Project Properties Summary Page gives you a summary of the project’s database size, and allows you to flush the project database and set the project’s Autosave options.

Flush Project Database empties the entire project database.  This command causes Teleport Pro to forget everything it has learned in its explorations.  Use this command only to completely reset your project to its starting state.  Once the database is flushed and the project saved, that data cannot be recovered.

Autorun on open will cause Teleport Pro to begin running the project as soon as it is opened.  This feature is useful for scheduling a Teleport session using a program like the Windows 95 System Agent.  Just specify the name of the project on the command line when you run Teleport Pro, and the project will begin running (in Refresh mode) automatically when the program starts.

Refresh continuously tells Teleport Pro to continuously update the project.  After the project is completed, Teleport Pro will wait for five seconds, and then begin Refreshing the project again.

Autosave causes Teleport Pro to save the project’s state (its database) at specified intervals.  Enabling Autosave will also automatically save your project whenever it is completed or otherwise stops running.  This option defaults to On with a value of 120 seconds (two minutes) and it is usually a good idea to leave it enabled.  Autosaving protects your project against crashes, power failures, and lost connections.


Project Scheduling

The Scheduling Page has a number of features that enable you, in conjunction to with a scheduling program such as Windows 95’s System Agent, to set up your project to start automatically, run for a certain time, and quit (terminate Teleport Pro) when finished.  You can also set your project to continuously refresh, which can be useful for intermittently polling a site for new data.

Autoconnect before running is not yet implemented.  When implemented, this feature will allow you to specify your Internet connection parameters and have Teleport Pro automatically connect and log on to the Internet before running a project.

Automatically begin running on open will cause Teleport Pro to begin running the project as soon as it is opened.  This feature is useful for scheduling a Teleport session using a program like the Windows 95 System Agent.  Just specify the name of the project on the System Agent, Windows 95 shortcut, or DOS command line that runs Teleport Pro, and the project will begin running automatically (in Refresh mode) when the program starts.

Run for no more than X minutes will cause Teleport Pro to abort the project (as if you had pressed the Abort button) after it has run for a certain number of minutes.  Note that this option will stop running the project even if it is set to Refresh continuously (see below).

Refresh continuously tells Teleport Pro to continuously update the project.  After the project is completed, Teleport Pro will wait for a specified interval, and then begin Refreshing the project again.

Exit program when project stops running terminates the Teleport Pro program when the project is completed, or when the Run for no more than X minutes time limit has been reached, whichver occurs first.  If you have no time limit, and the project is set to Refresh continuously, enabling this option has no effect.

Warning:  the Autoexit feature terminates Teleport Pro with no questions asked.  Unless you have also enabled the Autosave feature, Teleport Pro will not save project information it has accumulated while running.  If you want your project state to remain up-to-date and you’ve enabled the Autoexit feature, be sure to enable Autosaving as well.

Disconnect when project stops running is not yet implemented.  When implemented, Teleport Pro will automatically disconnect your computer from the Internet when it is finished running.


Opening an Existing Project

To open a project, simply click the Open Project button on the toolbar, or select Open Project from the File menu.  Opening a project will close (and ask you to save, if unsaved) any previously open project.

Teleport Pro will display the Open Project dialog box.  Select the project file you wish to open (use the file navigation list box and buttons to change folders as necessary).  Click OK to confirm your choice, dismiss the dialog box, and open the project.


Pausing a Running Project

You can pause a running project by pressing the Pause button on the toolbar, or by selecting Pause from the File menu.  The toolbar Pause button will remain depressed as long as the project is paused.

Pausing a project is useful if, for example, you are trying to download a web page with your browser while Teleport Pro is running, and Teleport Pro appears to be taking up all of your bandwidth.  Pausing the project immediately suspends Teleport Pro's requests for more data, allowing your browser (or other Internet application) to communicate more freely.

When you are ready to resume running the project, simply press the Pause button again.  Teleport Pro will begin running exactly where it left off.


Deleting Pages

You can delete files from a project using the Delete command on the file context menu.  Deleting files will (1) transfer those files to the Windows 95 Recycle Bin, if it is available (or delete them, if it is not); (2) disable the files in the project database; and (3) hide them permanently from view!

Deleting files is a convenient way to tell Teleport that you do not want to keep those files and you also do not want them refreshed or retrieved again — ever.  If you think you may want to get those files again in the future, try disabling them instead.


Retrieve Now

You can use the Retrieve Now context menu command Retrieve Now to immediately retrieve a file from the Internet.  If the project is not already running, it will begin automatically and terminate once the file has been retrieved.

When an html file is retrieved using the Retrieve Now command, it is only retrieved and downloaded; it is not explored, and its internal links are not localized.  This allows you to obtain an exact copy of a web page at any time.

Caution:  The Retrieve Now command will automatically overwrite existing files.


Finding Files

When in List mode, the File List displays files as a multi-columned list of names, in the order in which the files were retrieved.  If you want to search for a particular file in the File List, you can show file details by clicking the Details View button on the toolbar.  Once in Details view, you can press any of the column headers in the list to sort the list by that column.  Pressing the same column header a second time will reverse the order of the sort.

You can determine a file’s address by right-clicking the file to get its context menu, then selecting Properties to display its address (url).  Also, the File Lists’s Retrieved From column (in Details view) shows the Internet address which linked to that file.


Registering Teleport Pro:  The Benefits

Teleport Pro is shareware.  You are granted a free license to use this software 40 times, after which the license and the software both expire.

If you decide that you like Teleport Pro – and we hope that you do! -- you can register it, keep it, and use it as long as you like.  Registering the program is just like buying it.

There are really two good reasons to register Teleport Pro:

1	The program, and your license to use it, expire after you have used it 40 times.

2	Until you register it, Teleport Pro will only retrieve up to 50 files per project.  This may not seem like a huge limitation at first.  But if you’re like us – and we think that you are -- you’ll get hooked on the power of downloading huge segments of the Web overnight.  After a few days, you’ll want to go beyond 50 files.  We’re confident.

And here are some other things to keep in mind about registration:

For now, registration costs only $39.95 US.  It’s also about as hassle-free as we can make it.

Your registration is valid for all “minor version” upgrades of the Teleport Pro product.  This means that your registration number will work on every upgrade we release until Version 2.0.  In fact, if you send us your email address when you register, we’ll notify you automatically every time we issue an upgrade.

Tell me how I can register


Registering Teleport Pro:  How To Do It

Registering Teleport Pro costs $39.95 US.  We can accept Visa, Mastercard, American Express, and Discover credit cards.  We can also accept checks or money orders drawn on a United States bank, or a foreign bank with a United States clearing house.

Registration removes ALL limitations from the program, giving you free rein to teleport as many files as you like, for as long as you wish.

Please note that registration is for a single-user license only.  Please contact Tennyson Maxwell for site license or volume discount.

To register Teleport Pro, simply select Register from the Help menu.  Teleport Pro will display the Registration dialog box.  There are three options for sending us your registration information:

Secure Server:  Press this button to launch your browser and visit our Secure Server.  Your order will be processed online and you will receive a registration code immediately!  Choose this option for fastest service.  You must have a secure browser (such as Netscape or Microsoft) to use this option.  Credit card orders only, please.

CompuServe:  If you're a CompuServe member, press this button to launch CompuServe, then GO SWREG and register program # 12414.  Your CompuServe account will be billed for the account will be billed the cost of registration.  We will email your registration code to your CompuServe address when we receive notice of the order, usually within a week.

Mail/Email/Fax: Press this button to display the Order Form and print it or save it to disk.  You can then mail or email it to us, or fax it to us.  (Our address/fax number will appear on the form.)  Your credit card information will be encrypted for your privacy and security, but please understand that this encryption is less secure than using our Secure Server for placing your order.  If mailing, please enclose your check, money order, or credit card data.  We will email your registration code within two days of receiving your order.


Site Licenses and Volume Discounts

This copy of Teleport Pro is for individual use only.  Please note that the End User License Agreement for registered users of this program limits its use to a single user on a single machine.  If you are interested in a site license for multiple users and/or machines, please contact Tennyson Maxwell for more information.

Volume discounts for Teleport Pro are available according to the following schedule:

3 to 10 users	$30 each	(save 25%)

11 to 50 users	$24 each	(save 40%)

51 to 100 users	$20 each	(save 50%)

over 100 users	$14 each	(save 65%)

If you are considering Teleport Pro as part of a package of pre-installed software for new PCs or to be bundled with other products, please contact Tennyson Maxwell for information about obtaining pre-registered versions of Teleport Pro.


Copyright, Trademark, and License Information

Copyright

All software written by and copyright © 1996 Michael Del Monte.  All Rights Reserved.

Documentation copyright © 1996 Tennyson Maxwell.  All Rights Reserved.

Trademarks

Teleport, Teleport Pro, Domain Dispersed Querying, and Server Overload Protection are trademarks of Tennyson Maxwell.

Your End User License To Use Teleport Pro

IMPORTANT -- READ CAREFULLY:  This End User License Agreement (“EULA”) is a legal agreement between you (either an individual or a single entity) and Tennyson Maxwell for the software product identified above, which includes computer software and associated media and printed materials, and this online documentation (“SOFTWARE PRODUCT”).  By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA.  If you do not agree to the terms of this EULA, promptly dispose of this copy of the SOFTWARE PRODUCT.

The SOFTWARE PRODUCT is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties.  The SOFTWARE PRODUCT is licensed, not sold.

GRANT OF LICENSE.  Prior to Registration.  This EULA grants you the following rights as an unregistered user:  For 15 days, you may use the SOFTWARE PRODUCT free of charge.  During this time you may make and distribute copies of the SOFTWARE PRODUCT; provided that those copies are unmodified duplicates of the SOFTWARE PRODUCT, and provided that such copying and distribution is made free of charge, and never for profit or for any commercial purpose.  The SOFTWARE PRODUCT may not be distributed as part of another commercial product.  After Registration.  This EULA grants you the following rights as a registered user:  You, and only you, may use the SOFTWARE PRODUCT on a single computer.  This license DOES NOT convey a "site license" allowing others to use the SOFTWARE PRODUCT, or allowing the SOFTWARE PRODUCT to be used on more than one machine simultaneously .  You may make and distribute copies of the SOFTWARE PRODUCT; provided (1) that those copies are unmodified duplicates of the SOFTWARE PRODUCT, (2) that those copies DO NOT contain the registration code (normal copying of the SOFTWARE PRODUCT files only will not duplicate the registration code); and (3) that such copying and distribution is made free of charge, and never for profit or for any commercial purpose.  The SOFTWARE PRODUCT may not be distributed as part of another commercial product.

TERMINATION OF LICENSE:  Fifteen days after your first use, your right to use the SOFTWARE PRODUCT under this EULA expires, unless you become a registered user.  You may not use the SOFTWARE PRODUCT beyond this expiration, although you may continue to make and distribute copies for others, as described above.

DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS.  You may not reverse engineer, decompile, or disassemble the SOFTWARE PRODUCT, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation.  You may not rent or lease the SOFTWARE PRODUCT.  Without prejudice to any other rights, Tennyson Maxwell may terminate this EULA if you fail to comply with the terms and conditions of this EULA.  In such event, you must destroy all copies of the SOFTWARE PRODUCT and all of its component parts.

U.S. GOVERNMENT RESTRICTED RIGHTS.  The SOFTWARE PRODUCT and documentation are provided with RESTRICTED RIGHTS.  Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software--Restricted Rights at 48 CFR 52.227-19, as applicable.  Manufacturer is Tennyson Maxwell, 1568 Englewood Drive, Slidell, LA  70458.

CUSTOMER REMEDIES.  The SOFTWARE PRODUCT is supplied "as is."  The author and Tennyson Maxwell disclaim all warranties, expressed or implied, including without limitation the warranties of merchantability and of fitness for any purpose. The author and Tennyson Maxwell assume no liability for damages, direct or consequential, which may result from the use of the SOFTWARE PRODUCT.


Contacting Tennyson Maxwell

Online help and FAQ information is available 24 hours a day, 7 days a week at the Tennyson Maxwell website—

http://www.tenmax.com

We welcome your comments and suggestions!  Please feel free to contact us in any of the following ways:

Email:	support@tenmax.com

Internet:	http://www.tenmax.com

Mail:	Tennyson Maxwell

P.O. Box 51881

New Orleans, LA  70151-1881  USA

Phone:	(504) 781-3404

Fax:	(504) 781-3405


Domain:  the file area contained within a server or a virtual server.  The domain of the Internet address "www.microsoft.com/home/software/" is "www.microsoft.com."  Any Internet address beginning with "www.microsoft.com" is located within that domain.


External domain:  any domain that is not the same as the domain of the starting address.


Embedded graphics (also inline graphics):  images (and movies) that appear within a web page, as opposed to those that are linked from a web page (but do not appear on the page when you view it with a browser).


Toolbar:  a row of buttons for frequently used commands, usually located a the top of the application window.  The toolbar is movable and dockable.  To move it, grab it on the gray area between and around the buttons and drag it.  To dock it, drag it to any window edge until its shape changes to match the side.


Spider (also robot or agent):  a program that travels unattended through a network.  Most spiders perform a function at each network location, such as verifying or reporting the location's contents.


Retrieval thread:  one of the small subprograms launched by Teleport Pro to retrieve files.  Teleport Pro can launch up to ten of these mini-programs; each behaves independently as a running application, and terminates after it has retrieved (and sometimes parsed) the file it was sent after.  You can view the state of each thread using the Thread Bar.


Starting address:  The Internet address at which the Teleport spider will begin its search.  The starting address is entered by the user.  Usually, you will enter the address of an HTML page, but you can also enter the address of programs, zip files, or anything else.  All pages linked from a starting address, either directly or indirectly, "belong" to the page and are indented below it in the Project Map.


Gateway Page:  The first page that links into an external domain.  The gateway page controls Teleport Pro's access into the external domain.  If you disable a gateway page, all pages in the domain it controls are also disabled.


Project Map:  the tree view showing web pages that the Teleport spider has visited for the project, displayed in the left-hand pane of the project window.  When you select pages in the Project Map, a list of files that were retrieved for that page will appear in the File List.  If the web page you select is contracted and it is a starting address or a gateway page, you will see not only the files that were retrieved for that page, but also the files retrieved for any pages linked from that page.


File List:  the list view showing retrieved files for the project, displayed in the right-hand pane of the project window.  The File List can be switched between a list of names, and a details view, using the [image] buttons on the toolbar.


Context menu:  the short popup menu that appears when you press the right mouse button (left button for left-handed users) on a page in the Project Map, or a file in the File List.  The context menu has several page- or file-specific commands, and looks like this:


Server-Side Image Map:  a special type of image map that is handled by a program on the remote computer.  The server-side image map does not publish its links -- instead, it keeps them hidden, and only releases them, one at a time, when the client program (usually your browser) requests them (usually when you click on a part of the image).

The Teleport spider handles server-side image maps through a brute-force "pinging" technique.  When it encounters such a map, it sets up a grid across the map and "pings" the map, asking the server to release its link for each grid location.  Many of these ping requests will go unanswered, as not every location on an image map will be programmed to return a link.  However, with a tight enough grid, Teleport can be sure of getting every available link from a server-side image map.

You can enable this advanced feature on the Project Properties Exporation Page.